First steps

開始使用

安裝 OpenClaw、執行入門設定，並與你的 AI 助理聊天，全程約 5 分鐘。完成後，你將擁有執行中的 Gateway、已設定的驗證，以及可用的聊天工作階段。

你需要準備

Node.js — 建議使用 Node 24（也支援 Node 22.16+）
模型供應商的 API 金鑰（Anthropic、OpenAI、Google 等）— 入門設定會提示你輸入

快速設定

安裝 OpenClaw

macOS / Linux

bash

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

安裝腳本流程

Windows (PowerShell)

powershell

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

執行入門設定

bash

openclaw onboard --install-daemon

精靈會引導你選擇模型供應商、設定 API 金鑰，並設定 Gateway。大約需要 2 分鐘。

如需完整參考，請參閱入門設定（CLI）。

確認 Gateway 正在執行

bash

openclaw gateway status

你應該會看到 Gateway 正在連接埠 18789 上監聽。

開啟儀表板

bash

openclaw dashboard

這會在瀏覽器中開啟 Control UI。如果能載入，就表示一切正常。

傳送你的第一則訊息

在 Control UI 聊天中輸入訊息，你應該會收到 AI 回覆。

想改用手機聊天嗎？最快設定的頻道是 Telegram（只需要一個機器人權杖）。所有選項請參閱頻道。

進階：掛載自訂 Control UI 建置

如果你維護在地化或自訂的儀表板建置，請將 gateway.controlUi.root 指向包含已建置靜態資產與 index.html 的目錄。

bash

mkdir -p "$HOME/.openclaw/control-ui-custom"# Copy your built static files into that directory.

接著設定：

json

{"gateway": {  "controlUi": {    "enabled": true,    "root": "$HOME/.openclaw/control-ui-custom"  }}}

重新啟動 Gateway 並重新開啟儀表板：

bash

openclaw gateway restartopenclaw dashboard

接下來做什麼

連接頻道

Discord、Feishu、iMessage、Matrix、Microsoft Teams、Signal、Slack、Telegram、WhatsApp、Zalo，以及更多。

配對與安全性

控制誰可以傳訊息給你的代理。

設定 Gateway

模型、工具、沙盒與進階設定。

瀏覽工具

瀏覽器、exec、網頁搜尋、Skills 與 Plugins。

進階：環境變數

如果你以服務帳號執行 OpenClaw，或想使用自訂路徑：

OPENCLAW_HOME — 內部路徑解析的主目錄
OPENCLAW_STATE_DIR — 覆寫狀態目錄
OPENCLAW_CONFIG_PATH — 覆寫設定檔路徑

完整參考：環境變數。

開始使用

你需要準備

快速設定

安裝 OpenClaw

macOS / Linux

Windows (PowerShell)

執行入門設定

確認 Gateway 正在執行

開啟儀表板

傳送你的第一則訊息

接下來做什麼

相關內容

Molty