開始使用

安裝 OpenClaw、執行新手引導，並在大約 5 分鐘內與你的 AI 助理聊天。完成後，你將擁有一個運作中的閘道、已設定的驗證，以及可正常使用的聊天工作階段。

​

你需要準備

• Node.js 22.22.3+、24.15+ 或 25.9+（建議預設使用 24）
• 來自模型供應商（Anthropic、OpenAI、Google 等）的API 金鑰——新手引導會提示你輸入

使用 node --version 檢查你的 Node 版本。 **Windows 使用者：**原生 Windows Hub 應用程式是最簡便的桌面使用方式。 也支援 PowerShell 安裝程式與 WSL2 閘道。請參閱 Windows。 需要安裝 Node？請參閱 Node 設定。

​

快速設定

1. 安裝 OpenClaw

   macOS / Linux

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

   

   Windows (PowerShell)

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

   其他安裝方式（Docker、Nix、npm）：安裝。

2. 執行新手引導

   openclaw onboard --install-daemon
   

   精靈會引導你選擇模型供應商、設定 API 金鑰，以及設定閘道。快速入門通常只需幾分鐘，但供應商登入、頻道配對、常駐程式安裝、網路下載、Skills 或選用外掛，可能使完整的新手引導耗時更久。你可以略過選用步驟，稍後使用 openclaw configure 返回設定。

   如需完整參考資料，請參閱新手引導（命令列介面）。

3. 確認閘道正在執行

   openclaw gateway status
   

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

4. 開啟儀表板

   openclaw dashboard
   

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

5. 傳送第一則訊息

   在控制介面的聊天中輸入訊息，你應該會收到 AI 回覆。

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

進階：掛載自訂的控制介面建置版本

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

mkdir -p "$HOME/.openclaw/control-ui-custom"
# 將已建置的靜態檔案複製到該目錄。

接著設定：

{
  "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 等。

配對與安全性

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

設定閘道

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

瀏覽工具

瀏覽器、執行、網頁搜尋、Skills 與外掛。

進階：環境變數

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

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

完整參考資料：環境變數。

​

相關內容

• 安裝概覽
• 頻道概覽
• 設定