OpenClaw
GitHub立即開始
6 步完成部署

OpenClaw 快速開始

按照這些步驟從零開始安裝和配置 OpenClaw

最快路徑

只想試試看？一個指令啟動 Dashboard 即可立即聊天：

$ openclaw dashboard
http://127.0.0.1:18789/

OpenClaw 系統需求

開始之前，請確保您的系統滿足這些要求

Node.js ≥ 22

執行 OpenClaw 所需

作業系統

macOS、Linux 或 Windows（建議使用 WSL2）

Brave Search API（可選）

啟用網頁搜尋功能

Windows
強烈建議 Windows 用戶使用 WSL2 以獲得更好的相容性和效能。
1

安裝 OpenClaw

選擇您偏好的安裝方式。建議使用一行指令安裝

$ curl -fsSL https://openclaw.ai/install.sh | bash
一行指令會自動偵測並安裝 Node.js 和所有依賴項。無需手動設定。
2

OpenClaw 配置精靈

精靈將引導您完成所有必要的設定，包括閘道、認證和聊天平台連接

$ openclaw onboard --install-daemon

精靈將配置

  • 閘道類型 - 選擇本地或遠端閘道
  • AI 模型認證 - OpenAI（OAuth/API 金鑰）或 Anthropic（建議使用 API 金鑰，也支援 claude setup-token）
  • 聊天平台 - WhatsApp QR 碼、Telegram/Discord Bot Token 等
  • Daemon 服務 - 背景服務安裝（macOS: launchd，Linux/WSL2: systemd）
配置檔案位置（重要）
  • 主配置目錄~/.openclaw/
  • OAuth 憑證~/.openclaw/credentials/oauth.json
  • 認證設定檔（OAuth + API 金鑰）~/.openclaw/agents/<agentId>/agent/auth-profiles.json
如果您已安裝 Claude Code，可以透過 claude setup-token 重用現有憑證，無需重新配置。
無頭伺服器提示：先在有瀏覽器的機器上完成 OAuth，然後將 oauth.json 檔案複製到伺服器的相應目錄。
3

啟動 OpenClaw 閘道

閘道是 OpenClaw 的核心服務，處理所有訊息

檢查服務狀態

$ openclaw gateway status

手動啟動閘道（指定連接埠）

$ openclaw gateway --port 18789

存取 Web Dashboard

http://127.0.0.1:18789/
快速驗證（確認服務正在執行）
$ openclaw status
$ openclaw health
$ openclaw security audit --deep
4

連接聊天平台

配對並連接您的第一個聊天介面

WhatsApp (QR 碼登入)

$ openclaw channels login

執行指令顯示 QR 碼。開啟 WhatsApp → 設定 → 已連結的裝置 → 掃描 QR 碼連接。

建議使用專用電話號碼。不建議使用 VoIP 號碼（容易被封鎖）。憑證儲存在 ~/.openclaw/credentials/whatsapp/ 目錄。

Telegram / Discord / 其他平台

精靈可以幫助配置 Token。如果您偏好手動設定，請參閱這些文件：

Telegram 提示：您的第一則 DM 會返回配對碼。您需要批准它（參見下一步），否則機器人不會回應。
5

OpenClaw 安全設定

確保只有授權用戶可以使用您的 AI 助手

預設行為：未知的 DM 會收到短代碼，訊息在批准前不會被處理。如果您的第一則 DM 沒有收到回覆，請批准配對：

列出待處理的配對請求

$ openclaw pairing list whatsapp

批准配對（將 [code] 替換為實際代碼）

$ openclaw pairing approve whatsapp <code>
這是防止未授權存取的重要安全措施。您也可以在配置檔案中設定允許清單，自動允許特定號碼。
6

驗證 OpenClaw

在新的終端機中，發送測試訊息

發送測試訊息（替換為您的目標號碼）

$ openclaw message send --target +15555550123 --message "Hello from OpenClaw"
如果 openclaw health 顯示「auth not configured」，請返回精靈設定 OAuth/API 金鑰認證——沒有它，代理將不會回應。

除錯提示

  • openclaw status --all最佳的可複製貼上、唯讀除錯報告
  • openclaw health或openclaw status --deep從執行中的閘道請求健康狀態快照

OpenClaw 配置完成

恭喜！您已成功安裝和配置 OpenClaw。現在就開始與您的 AI 助手聊天吧。