Day 2

OpenClaw 安裝教學：一鍵安裝 + 設定指南（Mac/Windows/Linux）

用一條指令安裝 OpenClaw，設定聊天頻道，開始第一次對話。包含 Node.js 22+ 需求、官方安裝腳本、gateway 設定，完整新手教學。

"如果你會泡泡麵，你就會安裝 OpenClaw。時間大概也差不多。"

今日目標


Learn	理解 OpenClaw 適合運行在哪裡，以及安裝程式會替你完成哪些設定。
Do	選定環境、準備先決條件、跑完 onboarding，並送出第一則 Telegram 訊息。
Done when	`openclaw status` 顯示服務正在運行、Telegram 有回覆，而且重新開機後服務會自動回來。

Step 0：選擇助理要住在哪裡

第一個決定：你的助理要跑在哪一台機器上？

選項	最適合	取捨
雲端 VPS（建議）	24/7 在線、你睡覺時也能自動化	約 $5/月（Hetzner、AWS Lightsail）
Mac Mini / 備用機	筆電不用多裝東西，資料留在家裡	只有那台機器開著時才能運作
你目前的筆電	只是先試試看	筆電睡眠或闔上時就會停止

VPS 建議規格： Ubuntu 22.04、2 個 CPU 核心、4GB RAM、40GB SSD。

我該選哪種環境？

只是先試試 → 筆電（最簡單，但只有筆電開著才會運作）
想要 24/7 在線 → VPS（$5-10/月，你睡覺時也會跑）
想要 24/7 但不想上雲 → Mac Mini 或舊 PC

不論你選哪個環境，OpenClaw 的工作檔案通常都會放在 ~/.openclaw/workspace/，已安裝技能通常放在 ~/.openclaw/skills/。

當你能回答「哪一台機器會一直在線，讓我的助理持續運作？」時，這一步就完成了。

Step 1：準備先決條件

在跑安裝程式前，先把這些準備好：

Node 22.16 或更新版本（Node 24 是目前預設建議執行環境）

你需要它的原因：openclaw CLI 是跑在 Node.js 上。
用 node -v 檢查。如果你看到 Node 22.16 或更新版本，就可以了。

AI 模型存取方式（選一種）

Claude 訂閱（Pro/Max/Team）
- 你需要它的原因：助理的每一次回應與工具規劃，仍然需要模型提供商。
- 在引導流程中使用 OAuth，所以不用手動貼 API key。
Anthropic API key
- 你需要它的原因：這是 OpenClaw 直接呼叫 Anthropic 時使用的憑證。
- 可從 console.anthropic.com 取得。
也支援：OpenAI、Gemini、OpenRouter、Qwen、Mistral 等。
- 你需要它的原因：如果你不想用 Claude，任何受支援的提供商都可以驅動助理。

Telegram Bot Token

打開 Telegram，搜尋 @BotFather。
傳送 /newbot，選擇名稱與使用者名稱。
複製 BotFather 回傳的 token。

你需要它的原因：這個 token 讓 OpenClaw 能透過你的 bot 收發 Telegram 訊息。

你的 Telegram User ID

在 Telegram 搜尋 @userinfobot，複製你的數字 ID。
你需要它的原因：onboarding 會用它把你標記為 admin，避免陌生人控制你的助理。

當你手上有這四樣東西時，這一步就完成了：一台機器、Node 22.16 或更新版本、一種模型憑證路徑，以及兩個 Telegram 值。

Step 2：安裝

執行：

curl -fsSL https://openclaw.ai/install.sh | bash

這是官方一行指令。它會安裝 OpenClaw，並在需要時自動安裝 Node。

另一條手動安裝路徑：

npm install -g openclaw@latest && openclaw onboard

這條路徑會直接安裝 CLI，接著啟動 onboarding wizard，在 ~/.openclaw/workspace/ 下寫入你的初始設定。

平台指南：macOS → 平台指南：Windows → 平台指南：Linux / VPS →

當引導程式成功打開，而不是回傳 command not found，並且 onboarding 完成後 openclaw status 顯示服務正在運行，就代表這一步成功了。

Step 3：引導程式會問什麼

設定 wizard 會帶你完成五個提示：

Mode — 如果這是你的第一次安裝，選 QuickStart。
AI Model — 選擇你的提供商並完成驗證。
Chat Channel — 選 Telegram，貼上你的 Bot Token。
Admin Setup — 輸入你的 Telegram user ID。
Daemon Install — 回答 yes，讓助理在背景運行，並在重開機後自動恢復。

在 Linux 上，這通常會是 systemd user unit；在 macOS 上，通常是 LaunchAgent。無論底層是什麼，目標都一樣：機器重開後，OpenClaw 應該自動啟動。

當 daemon 安裝過程沒有報錯，且 openclaw status 顯示 healthy 而不是 stopped，這一步就完成了。

Step 4：送出你的第一則訊息

引導流程結束後，打開 Telegram，找到你的 bot，送出：

你好，你是誰？

你應該會在幾秒內收到回覆。現在的語氣會比較普通，因為你還沒自訂 ~/.openclaw/workspace/SOUL.md 這類檔案。第 3 天會處理這件事。

再試幾句：

「寫一個 Python quicksort」
「1024 的平方根是多少？」
「你能幫我檢查 email 嗎？」（目前它應該會說不行。）

當 Telegram 真的收到 bot 回覆，而且 openclaw logs --follow 沒有對那則訊息反覆報錯時，這一步就成功了。

最低成功標準

完成今天後，你至少應該能做到：

執行 openclaw status 並看到它正在運行
在 Telegram 傳一則訊息並收到回應
把電腦關掉再開機，服務會自動重啟

驗證檢查：現在就做重開機測試，不要留到之後。如果服務不會自動回來，先修好再進下一天。

日常管理指令

你會經常用到這些：

openclaw status           # Overall health
openclaw doctor           # Full diagnostic check
openclaw gateway restart  # Restart background service
openclaw logs --follow    # View runtime logs
openclaw configure        # Change model, channel, or any setting

當你能很快回答這兩個問題時，就代表這些指令已經夠你日常操作了：「它有在跑嗎？」以及「日誌在說什麼？」

常見問題

埠號已被使用 — 另一個程序已經佔用了 OpenClaw 想用的埠。先在 openclaw logs --follow 裡看清楚錯誤，釋放衝突程序，再執行 openclaw daemon restart。當日誌不再重複 bind error，且 openclaw status 回到 healthy，就修好了。

Telegram bot 沒有回應 — 通常是 bot token 錯了、缺少 Telegram user ID，或 daemon 根本沒啟動。重新執行 openclaw configure 或 openclaw onboard，再送一次測試訊息。當 bot 有回覆，而且日誌顯示收到訊息而不是 auth failure，就代表修好了。

重開機後服務沒有啟動 — daemon 安裝步驟很可能失敗或被略過。執行 openclaw doctor，如果有提示就重新安裝 daemon，然後再重開一次。當你登入或伺服器開機後立刻看到 openclaw status 顯示 running，就代表已修復。

完整排障指南 →

你的助理現在已經能聊天，但還沒有性格，也沒有操作指示。明天你會開始編輯 ~/.openclaw/workspace/ 裡的核心檔案，包括 ~/.openclaw/workspace/SOUL.md、~/.openclaw/workspace/USER.md、~/.openclaw/workspace/AGENTS.md 和 ~/.openclaw/workspace/IDENTITY.md。