入門指南

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

最快速的聊天方式：開啟 Control UI（不需要設定頻道）。執行 openclaw dashboard 並在瀏覽器中聊天，或在 Run openclaw dashboard and chat in the browser, or open http://127.0.0.1:18789/ on the . 上開啟 http://127.0.0.1:18789/。文件： Dashboard 與 Control UI。

Prereqs

Node 22 或更新版本

如果不確定，請使用 node --version 檢查你的 Node 版本。

快速設定（CLI）

Install OpenClaw (recommended)

macOS/Linux
Windows (PowerShell)

curl -fsSL https://openclaw.ai/install.sh | bash

iwr -useb https://openclaw.ai/install.ps1 | iex

```
<Note>
其他安裝方式與需求請參考： [Install](/install)。

</Note>
```

Run the onboarding wizard

openclaw onboard --install-daemon

15. 精靈會設定驗證、gateway 設定，以及可選的頻道。詳情請見 [Onboarding Wizard](/start/wizard)。

Check the Gateway

如果你已安裝服務，它應該已經在執行中：

````
```bash
openclaw gateway status
```
````

Open the Control UI

openclaw dashboard

如果 Control UI 能成功載入，表示你的 Gateway 閘道器已準備好使用。

選用檢查與附加項目

Run the Gateway in the foreground

適合快速測試或疑難排解。

````
```bash
openclaw gateway --port 18789
```
````

Send a test message

需要已設定的頻道。

````
```bash
openclaw message send --target +15555550123 --message "Hello from OpenClaw"
```
````

有用的環境變數

如果你以服務帳戶執行 OpenClaw，或需要自訂設定／狀態位置：

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

完整的環境變數參考：Environment vars。

深入了解

Onboarding Wizard (details)

Full CLI wizard reference and advanced options.

macOS app onboarding

macOS 應用程式首次執行流程。

What you will have

一個正在執行的 Gateway 閘道器
1. 已設定完成的驗證
Control UI 存取權或已連接的頻道

後續步驟

私訊安全與核准： Pairing
連接更多頻道： Channels
進階工作流程與從原始碼開始： Setup

首頁

概覽

核心概念

入門步驟

指南

入門指南

入門指南

Prereqs

快速設定（CLI）

選用檢查與附加項目

有用的環境變數

深入了解

Onboarding Wizard (details)

macOS app onboarding

What you will have

後續步驟

​入門指南

​Prereqs

​快速設定（CLI）

​選用檢查與附加項目

​有用的環境變數

​深入了解

Onboarding Wizard (details)

macOS app onboarding

​What you will have

​後續步驟

入門指南

Prereqs

快速設定（CLI）

選用檢查與附加項目

有用的環境變數

深入了解

What you will have

後續步驟