快速开始

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

最快的对话方式

无需配置任何渠道，直接打开控制台 UI 即可开始对话。运行 openclaw dashboard，在浏览器中聊天，或者在网关主机上打开 http://127.0.0.1:18789/。

前置要求

• Node.js 22 或更新版本

提示

不确定你的 Node 版本？运行 node --version 即可查看。

快速安装（CLI）

第一步：安装 OpenClaw

macOS / Linux

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

Windows (PowerShell)

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

其他安装方式

查看 安装 获取完整安装方式和系统要求。

第二步：运行引导向导

openclaw onboard --install-daemon

向导会配置认证、网关设置和可选的渠道接入。详见 引导向导。

第三步：检查网关状态

如果你安装了守护服务，网关应已在运行：

openclaw gateway status

第四步：打开控制台 UI

openclaw dashboard

✅ 验证

如果控制台 UI 成功加载，说明你的网关已经就绪。

可选操作

在前台运行网关

适用于快速测试或排查问题：

openclaw gateway --port 18789

发送测试消息

需要先配置好渠道：

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

常用环境变量

如果你用服务账号运行 OpenClaw，或需要自定义配置/状态目录：

• OPENCLAW_HOME — 设置内部路径解析的 home 目录
• OPENCLAW_STATE_DIR — 覆盖状态目录
• OPENCLAW_CONFIG_PATH — 覆盖配置文件路径

完整的环境变量参考：环境变量

深入了解

引导向导详解CLI 向导完整参考和高级选项

→

macOS 应用初始化macOS 应用的首次运行流程

→

完成后你将获得

• 一个运行中的网关（Gateway）
• 已配置的认证
• 控制台 UI 访问权限或已连接的渠道

下一步

• DM 安全和审批：配对认证
• 接入更多渠道：渠道
• 高级工作流和源码安装：安装配置

🇨🇳 中国用户须知

• 如果遇到安装脚本下载缓慢，可以使用国内镜像加速：curl -fsSL https://openclaw.ai/install.sh | bash
• npm 安装时建议使用国内镜像源：npm install -g openclaw --registry=https://registry.npmmirror.com
• 更多国内网络配置：国内网络配置