快速上手

目标：从零开始，用最少的步骤跑通第一次对话。

提示： 最快的聊天方式：打开 Control UI（无需配置任何渠道）。运行 openclaw dashboard 即可在浏览器中聊天，或者直接访问 Gateway 主机（运行 OpenClaw Gateway 服务的机器）上的 http://127.0.0.1:18789/。文档：Dashboard 和 Control UI。

前置要求

推荐 Node 24（Node 22 LTS，目前 22.16+，仍兼容支持）

提示： 不确定版本？运行 node --version 查看。

快速安装（CLI）

第 1 步：安装 OpenClaw（推荐方式）

  #### macOS/Linux
    ```bash
    curl -fsSL https://openclaw.ai/install.sh | bash
    ```
    <img

src=“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)。

第 2 步：运行 onboarding 向导

```bash
openclaw onboard --install-daemon
```

向导会配置认证、Gateway 设置以及可选的消息渠道。
详情请参阅 [Onboarding 向导](/docs/start/wizard)。

第 3 步：检查 Gateway

如果你已安装服务，Gateway 应该已经在运行了：

```bash
openclaw gateway status
```

第 4 步：打开 Control UI

```bash
openclaw dashboard
```

验证： 如果 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 应用 onboarding — macOS 应用的首次运行流程。

完成后你将拥有

一个运行中的 Gateway
已配置的认证
Control UI 访问权限或已连接的消息渠道

接下来

DM 安全与审批：配对
接入更多渠道：消息渠道
高级工作流和从源码运行：进阶设置