> ## 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.22.3+、24.15+ 或 25.9+**（建議預設使用 24）
* 來自模型供應商（Anthropic、OpenAI、Google 等）的**API 金鑰**——新手引導會提示你輸入

<Tip>
  使用 `node --version` 檢查你的 Node 版本。
  \*\*Windows 使用者：\*\*原生 Windows Hub 應用程式是最簡便的桌面使用方式。
  也支援 PowerShell 安裝程式與 WSL2 閘道。請參閱 [Windows](/zh-TW/platforms/windows)。
  需要安裝 Node？請參閱 [Node 設定](/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 金鑰，以及設定閘道。快速入門通常只需幾分鐘，但供應商登入、頻道配對、常駐程式安裝、網路下載、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
    ```

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

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

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

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

  ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
  mkdir -p "$HOME/.openclaw/control-ui-custom"
  # 將已建置的靜態檔案複製到該目錄。
  ```

  接著設定：

  ```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">
    瀏覽器、執行、網頁搜尋、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)