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.22.3+、24.15+ 或 25.9+（建議預設使用 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