> ## Documentation Index
> Fetch the complete documentation index at: https://claw-tw.jackle.pro/llms.txt
> Use this file to discover all available pages before exploring further.

# Getting Started（開始使用）

# 開始使用

目標：從零開始到第一個能運作的聊天，最少設定。

<Info>
  最快的聊天方式：開啟 Control UI（不需要頻道設定）。執行 `openclaw dashboard` 並在瀏覽器中聊天，或開啟 `http://127.0.0.1:18789/` 在
  <Tooltip headline="Gateway host（Gateway 主機）" tip="執行 OpenClaw Gateway 服務的機器。">Gateway 主機</Tooltip>上。
  文件：[Dashboard](/zh-Hant/web/dashboard) 和 [Control UI](/zh-Hant/web/control-ui)。
</Info>

## 先決條件

* 建議使用 Node 24（Node 22 LTS，目前 `22.16+`，仍支援相容性）

<Tip>
  如果不確定，可以用 `node --version` 檢查 Node 版本。
</Tip>

## 快速設定（CLI）

<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/magicchoco/y30I-9caIpwEnaJu/assets/install-script.svg?fit=max&auto=format&n=y30I-9caIpwEnaJu&q=85&s=d0a7b00807c82f10d2a3a36bcb452ef7" alt="Install Script Process" 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>
      其他安裝方式和需求：[安裝](/zh-Hant/install)。
    </Note>
  </Step>

  <Step title="執行入門精靈">
    ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
    openclaw onboard --install-daemon
    ```

    精靈會設定認證、Gateway 設定和可選的頻道。
    詳見[入門精靈](/zh-Hant/start/wizard)。
  </Step>

  <Step title="檢查 Gateway">
    如果你已安裝服務，它應該已在執行中：

    ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
    openclaw gateway status
    ```
  </Step>

  <Step title="開啟 Control UI">
    ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
    openclaw dashboard
    ```
  </Step>
</Steps>

<Check>
  如果 Control UI 載入成功，你的 Gateway 已準備好使用。
</Check>

## 可選的檢查和額外功能

<AccordionGroup>
  <Accordion title="在前景執行 Gateway">
    適合快速測試或疑難排解。

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

  <Accordion title="傳送測試訊息">
    需要已設定的頻道。

    ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
    openclaw message send --target +15555550123 --message "Hello from OpenClaw"
    ```
  </Accordion>
</AccordionGroup>

## 有用的環境變數

如果將 OpenClaw 作為服務帳戶執行或想要自訂設定/狀態位置：

* `OPENCLAW_HOME` 設定用於內部路徑解析的主目錄。
* `OPENCLAW_STATE_DIR` 覆蓋狀態目錄。
* `OPENCLAW_CONFIG_PATH` 覆蓋設定檔路徑。

完整環境變數參考：[環境變數](/zh-Hant/help/environment)。

## 深入了解

<Columns>
  <Card title="入門精靈（詳細）" href="/zh-Hant/start/wizard">
    完整 CLI 精靈參考和進階選項。
  </Card>

  <Card title="macOS 應用入門" href="/zh-Hant/start/onboarding">
    macOS 應用的首次執行流程。
  </Card>
</Columns>

## 你會獲得什麼

* 一個執行中的 Gateway
* 已設定的認證
* 對 Control UI 的存取或已連接的頻道

## 後續步驟

* DM 安全和批准：[Pairing](/zh-Hant/channels/pairing)
* 連接更多頻道：[Channels](/zh-Hant/channels)
* 進階工作流和從來源開始：[Setup](/zh-Hant/start/setup)