跳轉到主要內容

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

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

​
你需要什麼

  • Node.js — 建議使用 Node 24（也支援 Node 22.14+）
  • 模型供應商的 API 金鑰（Anthropic、OpenAI、Google 等）— 入門設定會提示你輸入
使用 node --version 檢查你的 Node 版本。 **Windows 使用者：**支援原生 Windows 與 WSL2。WSL2 更穩定，建議用於完整體驗。請參閱 Windows。 需要安裝 Node？請參閱 Node 設定。

​
快速設定

1

安裝 OpenClaw

curl -fsSL https://openclaw.ai/install.sh | bash
Install Script Process
其他安裝方式（Docker、Nix、npm）：安裝。
2

執行入門設定

openclaw onboard --install-daemon
精靈會引導你選擇模型供應商、設定 API 金鑰，並設定 Gateway。大約需要 2 分鐘。如需完整參考，請參閱入門設定（CLI）。
3

確認 Gateway 正在執行

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

開啟儀表板

openclaw dashboard
這會在你的瀏覽器中開啟 Control UI。如果成功載入，就表示一切正常。
5

傳送你的第一則訊息

在 Control UI 聊天中輸入訊息，你應該會收到 AI 回覆。想改用手機聊天？最快設定的頻道是 Telegram（只需要機器人權杖）。所有選項請參閱頻道。
如果你維護的是在地化或自訂的儀表板建置，請將 gateway.controlUi.root 指向包含已建置靜態資產與 index.html 的目錄。
mkdir -p "$HOME/.openclaw/control-ui-custom"
# Copy your built static files into that directory.
然後設定：
{
  "gateway": {
    "controlUi": {
      "enabled": true,
      "root": "$HOME/.openclaw/control-ui-custom"
    }
  }
}
重新啟動 gateway 並重新開啟儀表板：
openclaw gateway restart
openclaw dashboard

​
接下來要做什麼

連接頻道

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

配對與安全

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

設定 Gateway

模型、工具、沙盒，以及進階設定。

瀏覽工具

瀏覽器、exec、網頁搜尋、Skills，以及 plugins。
如果你以服務帳號執行 OpenClaw，或想使用自訂路徑：
  • OPENCLAW_HOME — 內部路徑解析使用的主目錄
  • OPENCLAW_STATE_DIR — 覆寫狀態目錄
  • OPENCLAW_CONFIG_PATH — 覆寫設定檔路徑
完整參考：環境變數。

​
相關