> ## Documentation Index
> Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# 開始使用

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

## 你需要準備

* **Node.js 22.19+、23.11+ 或 24+**（建議預設使用 24）
* **API 金鑰**，來自模型供應商（Anthropic、OpenAI、Google 等）— 初始設定會提示你輸入

<Tip>
  使用 `node --version` 檢查你的節點版本。
  **Windows 使用者：** 原生 Windows Hub 應用程式是最簡單的桌面路徑。
  也支援 PowerShell 安裝程式與 WSL2 閘道路徑。請參閱 [Windows](/zh-TW/platforms/windows)。
  需要安裝節點？請參閱 [節點設定](/zh-TW/install/node)。
</Tip>

## 快速設定

<Steps>
  <Step title="安裝 OpenClaw">
    <Tabs>
      <Tab title="macOS / Linux">
        ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
        curl -fsSL https://openclaw.ai/install.sh | bash
        ```

        <img src="https://mintcdn.com/clawdhub/U8jr7qEbUc9OU9YR/assets/install-script.svg?fit=max&auto=format&n=U8jr7qEbUc9OU9YR&q=85&s=50706f81e3210a610262f14facb11f65" alt="安裝指令碼流程" className="rounded-lg" width="1370" height="581" data-path="assets/install-script.svg" />
      </Tab>

      <Tab title="Windows (PowerShell)">
        ```powershell theme={"theme":{"light":"min-light","dark":"min-dark"}}
        iwr -useb https://openclaw.ai/install.ps1 | iex
        ```
      </Tab>
    </Tabs>

    <Note>
      其他安裝方式（Docker、Nix、npm）：[安裝](/zh-TW/install)。
    </Note>
  </Step>

  <Step title="執行初始設定">
    ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
    openclaw onboard --install-daemon
    ```

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

    完整參考請參閱 [初始設定（命令列介面）](/zh-TW/start/wizard)。
  </Step>

  <Step title="確認閘道正在執行">
    ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
    openclaw gateway status
    ```

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

  <Step title="開啟儀表板">
    ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
    openclaw dashboard
    ```

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

  <Step title="傳送第一則訊息">
    在 Control UI 聊天中輸入訊息，你應該會收到 AI 回覆。

    想改從手機聊天嗎？最快設定的頻道是
    [Telegram](/zh-TW/channels/telegram)（只需要 Bot token）。所有選項請參閱 [頻道](/zh-TW/channels)。
  </Step>
</Steps>

<Accordion title="進階：掛載自訂 Control UI 建置">
  如果你維護本地化或自訂的儀表板建置，請將
  `gateway.controlUi.root` 指向包含已建置靜態
  資產和 `index.html` 的目錄。

  ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
  mkdir -p "$HOME/.openclaw/control-ui-custom"
  # Copy your built static files into that directory.
  ```

  然後設定：

  ```json theme={"theme":{"light":"min-light","dark":"min-dark"}}
  {
    "gateway": {
      "controlUi": {
        "enabled": true,
        "root": "$HOME/.openclaw/control-ui-custom"
      }
    }
  }
  ```

  重新啟動閘道並重新開啟儀表板：

  ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
  openclaw gateway restart
  openclaw dashboard
  ```
</Accordion>

## 接下來要做什麼

<Columns>
  <Card title="連接頻道" href="/zh-TW/channels" icon="message-square">
    Discord、Feishu、iMessage、Matrix、Microsoft Teams、Signal、Slack、Telegram、WhatsApp、Zalo，以及更多。
  </Card>

  <Card title="配對與安全性" href="/zh-TW/channels/pairing" icon="shield">
    控制誰可以傳訊息給你的代理。
  </Card>

  <Card title="設定閘道" href="/zh-TW/gateway/configuration" icon="settings">
    模型、工具、沙盒和進階設定。
  </Card>

  <Card title="瀏覽工具" href="/zh-TW/tools" icon="wrench">
    瀏覽器、exec、網頁搜尋、Skills 和外掛。
  </Card>
</Columns>

<Accordion title="進階：環境變數">
  如果你以服務帳戶執行 OpenClaw，或想要自訂路徑：

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

  完整參考：[環境變數](/zh-TW/help/environment)。
</Accordion>

## 相關

* [安裝概覽](/zh-TW/install)
* [頻道概覽](/zh-TW/channels)
* [設定](/zh-TW/start/setup)