5 分鐘裝起來！OpenClaw 安裝與首次啟動完全不卡關
3 min read
大多數教學在這一步就讓你放棄了。這篇的目標：讓你第一次就成功。
本篇學習目標
- 確認安裝前的必要條件
- 完成 OpenClaw 安裝
- 跑完 Onboarding 精靈，產生第一個助理
- 成功打開儀表板
裝之前先確認這兩件事
不需要很多東西，但這兩樣缺一不可：
1. Node.js（LTS 版本）
node --version
# 確認有印出版本號就對了2. AI 模型的 API Key
用雲端模型（Anthropic Claude、OpenAI 等）需要 API key；想完全離線也可以，用本地模型就好。這個系列預設你用雲端模型。
💡 不知道怎麼取得 API key？搜尋「Anthropic API key 申請」，通常 5 分鐘內搞定。
安裝 OpenClaw
官方推薦用 git 安裝方式（方便之後更新和除錯）：
macOS / Linux：
# 依官方 docs.openclaw.ai 的 Quick Start 指令安裝
# 通常是一行 curl 腳本搞定Windows：
# 先確認已安裝 Git 且加入 PATH
git --version
# 再依 docs.openclaw.ai 的 Windows 說明安裝⚠️ 卡在「git not found」或「openclaw 無法辨識」？把 Git 加入系統 PATH，重開終端機再試一次。
第一次啟動：孵化助理
安裝完後，執行：
openclaw gateway第一次執行會進入 Onboarding 精靈，它會問你幾個問題：
- 用哪個 AI 模型？
- API key 是什麼？
- 工作區要放在哪裡？
依畫面填完，它會幫你孵化出第一個助理。
💡 卡在「wake up my friend」很久沒反應？先確認 API key 正確、網路正常，再看終端機有沒有錯誤訊息。
Onboarding 完成後你會得到什麼？
- 一個 Token（之後登入儀表板要用）
- 基本設定檔：
~/.openclaw/openclaw.json - 你的第一個 AI 助理，已經在運作了！
打開儀表板
Gateway 還在跑的情況下，打開瀏覽器：
http://127.0.0.1:18789/
常見狀況處理：
| 畫面顯示 | 解法 |
|---|---|
| pairing required | 在終端機跑 openclaw devices list 再 openclaw devices approve <id> |
| 要求輸入 Token | 貼上 Onboarding 給你的那個 token |
| 沒有回應 | 確認 openclaw gateway 還在跑 |
下一步
你的助理現在在家了。下一篇，我們來搞定登入和介面，讓你看懂每個按鈕在幹嘛。