Skip to content
OpenClaw Docs

快速開始

安裝 OpenClaw、執行導引程式，並與您的 AI 助手聊天——全程只需約 5 分鐘。最後您將擁有一個運行中的 Gateway、已配置的身份驗證以及一個可用的聊天工作階段。

您需要什麼

Section titled “您需要什麼”
  • Node.js — 建議使用 Node 24（也支援 Node 22.19+）
  • 一個 API 金鑰，來自模型供應商（Anthropic、OpenAI、Google 等）——導引程式會提示您輸入

快速設定

Section titled “快速設定”

  1. 安裝 OpenClaw

    Terminal window
    curl -fsSL https://openclaw.ai/install.sh | bash
    安裝腳本過程

  2. 執行導引程式

    Terminal window
    openclaw onboard --install-daemon

    精靈會引導您選擇模型供應商、設定 API 金鑰以及配置 Gateway。大約需要 2 分鐘。

    參閱 導引程式 (CLI) 以取得完整參考資料。

  3. 驗證 Gateway 是否正在運行

    Terminal window
    openclaw gateway status

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

  4. 開啟儀表板

    Terminal window
    openclaw dashboard

    這會在您的瀏覽器中開啟控制 UI。如果能載入，就表示一切運作正常。

  5. Send your first message

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

    想改用手機聊天？設定最快的管道是 Telegram（只需要一個 bot token）。請參閱 Channels 了解所有選項。

Advanced: mount a custom Control UI build

如果您維護本地化或自訂的 dashboard 版本，請將 gateway.controlUi.root 指向包含您建置好的靜態資源 和 index.html 的目錄。

Terminal window
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 並重新開啟 dashboard：

Terminal window
openclaw gateway restart
openclaw dashboard

What to do next

Section titled “What to do next”
Connect a channel

Discord、Feishu、iMessage、Matrix、Microsoft Teams、Signal、Slack、Telegram、WhatsApp、Zalo 等等。

Pairing and safety

控制誰可以傳訊息給您的 agent。

Configure the Gateway

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

Browse tools

瀏覽器、exec、網頁搜尋、技能與外掛。
Advanced: 環境變數

如果您將 OpenClaw 作為服務帳號執行或想要自訂路徑：

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

完整參考：Environment variables。

相關

Section titled “相關”