快速上手 OpenClaw

你是 OpenClaw 快速上手顧問。

【角色】
OpenClaw 快速上手顧問，按最小夠用、安全優先的原則給可落地方案，每條結論都落到能照做的具體步驟或示例，不停留在「建議」「考慮一下」這類空泛表述。

【輸入】
- 已裝好了嗎：___
- 接了哪個模型 / 渠道：___
- 想先驗證什麼：___
- 執行環境：___
- 經驗水平：___

【工作流程】
1. 確認前提
2. 給最小跑通步驟
3. 跑通第一個任務
4. 排查首次失敗
5. 給下一步

【輸出規範】
▌一、前提
▌二、跑通步驟
▌三、第一個任務
▌四、排障 + 下一步

【硬約束】
- 先跑通最小閉環
- 憑據安全處理
- 按我的環境給步驟
- 不要替我臆測情況或編造不存在的功能，資訊不全先問清
- 不確定的設定或介面一律以官方文件為準，禁止照搬過時寫法
- 給的每條結論都要落到具體可照做的步驟或示例，不停留在「建議」「考慮一下」這類沒法直接執行的空泛表述

快速開始的目標不是學完所有設定，而是在最短路徑裡確認四件事：OpenClaw 已安裝、模型認證可用、Gateway 正在跑、你能在 Control UI 裡和 Agent 發第一條訊息。

1. 先準備兩樣東西

快速開始只需要兩樣東西：

檢查 Node：

node --version

Windows 使用者可以用原生 Windows，也可以用 WSL2。需要更完整本地工具鏈時，WSL2 通常更穩定。

2. 安裝 OpenClaw

macOS / Linux / WSL2：

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

Windows PowerShell：

iwr -useb https://openclaw.ai/install.ps1 | iex

官方安裝指令碼預設會進入 onboarding。如果你安裝時跳過了 onboarding，手動執行：

openclaw onboard --install-daemon

3. 跑 onboarding

openclaw onboard --install-daemon 會引導你完成：

• 選擇模型 provider。
• 填入 API key 或完成對應認證。
• 建立基礎設定。
• 安裝並設定 Gateway daemon。
• 建立預設 workspace 和啟動檔案。

普通使用者優先走 onboarding，不要一開始手改 ~/.openclaw/openclaw.json。等跑通後，再用 openclaw configure、openclaw config set 或 Control UI 調整。

sequenceDiagram
    participant U as 你
    participant CLI as OpenClaw CLI
    participant GW as Gateway
    participant UI as Control UI
    participant Agent as Agent

    U->>CLI: openclaw onboard --install-daemon
    CLI->>GW: 寫入基礎設定並安裝 daemon
    U->>CLI: openclaw gateway status
    CLI->>GW: 查詢執行狀態
    U->>UI: openclaw dashboard
    UI->>GW: 連線本機入口
    U->>Agent: 傳送第一條訊息
    Agent-->>U: 返回 AI 回覆

4. 確認 Gateway 正在跑

openclaw gateway status

正常情況下你會看到 Gateway 監聽在 18789 埠。預設本機地址是：

127.0.0.1:18789

Gateway 是 OpenClaw 的中樞。訊息平臺、Web UI、CLI、桌面端和移動端都透過它連線 Agent。

如果狀態異常，先不要繼續設定渠道。先看這些命令：

openclaw doctor
openclaw logs
openclaw health

5. 開啟 Dashboard

openclaw dashboard

這會開啟 Control UI。如果瀏覽器能載入，並且能看到聊天入口或設定入口，說明 Gateway 的本地 WebSocket / HTTP 入口可用。

也可以直接訪問：

http://127.0.0.1:18789

如果打不開，按這個順序判斷：

6. 傳送第一條訊息

在 Control UI 聊天框裡發一條簡單訊息，例如：

你現在能正常工作嗎？請用一句話說明你的身份和目前 workspace。

能收到 AI 回覆，就說明最小閉環已經跑通。

這條訊息故意問“身份”和“workspace”，因為它能同時驗證三件事：

• Agent 能呼叫模型生成回覆。
• workspace 檔案被正確載入。
• Gateway 到 Control UI 的請求鏈路可用。

7. 常見下一步怎麼選

跑通 Dashboard 之後，再決定下一步。

OpenClaw 支援 Discord、Feishu、iMessage、Matrix、Microsoft Teams、Signal、Slack、Telegram、WhatsApp、Zalo 等渠道。每個渠道都要單獨處理 bot token、OAuth、webhook 或平臺側許可權。

8. 環境變數什麼時候要動

如果你用服務賬號、要改狀態目錄、或者要指定設定路徑，官方列出幾個關鍵變數：

OPENCLAW_HOME=...
OPENCLAW_STATE_DIR=...
OPENCLAW_CONFIG_PATH=...

普通本機使用不需要一開始就設定它們。只有遷移、多例項、服務化部署時再動。

9. 本章自檢

1. onboarding 應該留下哪幾類產物？
2. Gateway 預設監聽哪個本機埠？
3. 第一條訊息為什麼要問身份和 workspace？

10. 接下來去哪

11. 官方資料

• Getting started
• Install
• Gateway architecture
• Chat channels