跳轉到主要內容
安裝 OpenClaw、執行初始設定，並在大約 5 分鐘內與你的 AI 助理聊天。完成後，你將擁有正在執行的閘道、已設定的驗證，以及 可用的聊天工作階段。

​
你需要準備

  • Node.js 22.19+、23.11+ 或 24+（建議預設使用 24）
  • API 金鑰，來自模型供應商（Anthropic、OpenAI、Google 等）— 初始設定會提示你輸入
使用 node --version 檢查你的節點版本。 Windows 使用者： 原生 Windows Hub 應用程式是最簡單的桌面路徑。 也支援 PowerShell 安裝程式與 WSL2 閘道路徑。請參閱 Windows。 需要安裝節點？請參閱 節點設定。

​
快速設定

1

安裝 OpenClaw

curl -fsSL https://openclaw.ai/install.sh | bash
安裝指令碼流程
其他安裝方式（Docker、Nix、npm）：安裝。
2

執行初始設定

openclaw onboard --install-daemon
精靈會引導你選擇模型供應商、設定 API 金鑰， 並設定閘道。QuickStart 通常只需幾分鐘，但 供應商登入、頻道配對、守護程式安裝、網路下載、Skills 或選用外掛可能會讓完整初始設定花費更久。你可以略過選用 步驟，稍後再用 openclaw configure 返回設定。完整參考請參閱 初始設定（命令列介面）。
3

確認閘道正在執行

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

開啟儀表板

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

傳送第一則訊息

在 Control UI 聊天中輸入訊息，你應該會收到 AI 回覆。想改從手機聊天嗎？最快設定的頻道是 Telegram（只需要 Bot token）。所有選項請參閱 頻道。
如果你維護本地化或自訂的儀表板建置，請將 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"
    }
  }
}
重新啟動閘道並重新開啟儀表板：
openclaw gateway restart
openclaw dashboard

​
接下來要做什麼

連接頻道

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

配對與安全性

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

設定閘道

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

瀏覽工具

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

​
相關