快速上手
目標：從零開始，用最少的設定完成第一次對話。
Info: 最快的對話方式：打開 Control UI（不需要設定頻道）。執行
openclaw dashboard然後在瀏覽器中聊天，或直接開啟http://127.0.0.1:18789/（也就是 執行 OpenClaw gateway 服務的機器）。 文件：Dashboard 和 Control UI。
前置需求
- 建議使用 Node 24（Node 22 LTS，目前
22.16+，仍可相容使用）
提示： 不確定的話，用
node --version確認你的 Node 版本。
快速設定（CLI）
步驟一：安裝 OpenClaw（建議方式）
#### macOS/Linux
```bash
curl -fsSL https://openclaw.ai/install.sh | bash
```
<imgsrc=“https://cdn.openclaws.io/public/docs/assets/install-script.svg” alt=“Install Script Process” class=“rounded-lg” />
#### Windows (PowerShell)
```powershell
iwr -useb https://openclaw.ai/install.ps1 | iex
```
> **注意：** 其他安裝方式與需求請參考：[安裝](/docs/install)。步驟二：執行 onboarding 精靈
```bash
openclaw onboard --install-daemon
```
精靈會設定驗證、gateway 選項和可選頻道。
詳情請參考 [Onboarding 精靈](/docs/start/wizard)。步驟三：檢查 Gateway
如果你安裝了服務，它應該已經在執行了：
```bash
openclaw gateway status
```步驟四：開啟 Control UI
```bash
openclaw dashboard
```Check: 如果 Control UI 能正常載入，你的 Gateway 就已經就緒了。
額外的檢查與選項
在前景執行 Gateway
適合快速測試或疑難排解。
```bash
openclaw gateway --port 18789
```發送測試訊息
需要已設定好的頻道。
```bash
openclaw message send --target +15555550123 --message "Hello from OpenClaw"
```實用的環境變數
如果你用服務帳號執行 OpenClaw，或想自訂設定檔和狀態目錄的位置：
OPENCLAW_HOME設定內部路徑解析使用的主目錄。OPENCLAW_STATE_DIR覆寫狀態目錄。OPENCLAW_CONFIG_PATH覆寫設定檔路徑。
完整的環境變數參考：環境變數。
深入了解
- Onboarding 精靈（詳細說明） — 完整的 CLI 精靈參考與進階選項。
- macOS app onboarding — macOS app 的首次執行流程。
完成後你會擁有
- 執行中的 Gateway
- 已設定的驗證
- Control UI 存取或已連線的頻道