OpenClawDocs
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

First steps

開始使用

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

所需項目

  • Node.js 22.19+、23.11+ 或 24+（建議預設使用 24）
  • 模型提供者（Anthropic、OpenAI、Google 等）的API 金鑰——初始設定期間會提示您輸入

快速設定

  • 安裝 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 金鑰，以及設定閘道。快速入門通常只需幾分鐘，但提供者登入、頻道配對、常駐程式安裝、網路下載、Skills 或選用外掛，可能會讓完整初始設定花費更長時間。您可以略過選用步驟，稍後再使用 openclaw configure 返回設定。

    如需完整參考資料，請參閱初始設定（命令列介面）。

  • 確認閘道正在執行

    bash
    openclaw gateway status

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

  • 開啟儀表板

    bash
    openclaw dashboard

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

  • 傳送您的第一則訊息

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

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

    • 進階：掛載自訂控制介面版本

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

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

    接著設定：

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

    重新啟動閘道，然後再次開啟儀表板：

    bash
    openclaw gateway restartopenclaw dashboard

    接下來可以做什麼

    連接頻道

    Discord、Feishu、iMessage、Matrix、Microsoft Teams、Signal、Slack、Telegram、WhatsApp、Zalo 等更多選項。
    配對與安全性

    控制哪些人可以傳訊息給您的代理程式。
    設定閘道

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

    瀏覽器、執行工具、網頁搜尋、Skills 與外掛。
    進階：環境變數

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

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

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

    相關內容

    Was this useful?
    On this page

    On this page