OpenClaw 快速上手：安装、引导配置和第一次对话
用一条命令安装 OpenClaw，跑完引导向导，把网关装成后台服务，打开控制台完成第一次对话，以及安装后排查问题的几个命令。
大约 5 分钟可以装好 OpenClaw 并完成第一次对话。
准备
- Node.js 24.16+ 或 26.1+（官方推荐 Node 26）。用
node --version检查。安装脚本在缺少 Node 时会自动装上 - 一条可用的模型通道：已有的 Claude Code 或 Codex CLI 登录，或者任意服务商的 API Key
先试一下，不安装
npx openclaw@latest全新环境下选择 Quick start。如果机器上已经有可用的 Claude Code、Codex CLI 登录或 API Key，它会自动检测、用一次真实请求验证、保存配置并打开控制台。
这种方式下网关运行在当前终端里，按 Ctrl+C 停止，配置会保留。
正式安装
macOS / Linux / WSL2：
curl -fsSL https://openclaw.ai/install.sh | bashWindows（PowerShell）：
iwr -useb https://openclaw.ai/install.ps1 | iex脚本会识别系统、按需安装 Node、安装 OpenClaw，然后自动进入引导向导。Windows 用户也可以直接装官方的桌面应用 Windows Hub。
已经自己管理 Node 的，可以用 npm：
npm install -g openclaw@latest --allow-scripts=openclaw
openclaw onboard --install-daemon--allow-scripts=openclaw 是 npm 12 需要的参数（新版 npm 默认拦截未批准的安装脚本）；npm 11.15 及更早版本去掉这个参数。
跑完引导向导
安装脚本会自动启动向导：
- Quick start：复用检测到的模型通道，直接打开控制台
- Custom setup：把所有选项走一遍，包括选择服务商、填 Key、选模型、接消息渠道
以后想改设置，运行 openclaw configure；想重新走经典的分步向导，运行 openclaw onboard --classic。
各家模型在向导里怎么选，见官方文档。
把网关装成后台服务
Quick start 让网关跑在前台。要让它常驻，先 Ctrl+C 停掉，再执行：
openclaw gateway install它在 macOS 上安装 LaunchAgent，在 Linux 和 WSL2 上安装 systemd 用户服务，在 Windows 上创建计划任务。
确认运行状态：
openclaw gateway status应该能看到网关在监听 18789 端口。
第一次对话
openclaw dashboard浏览器会打开 Control UI，在聊天框里发一条消息，能收到回复就说明一切正常。
喜欢终端的话用 openclaw tui。想在手机上用，最快的渠道是 Telegram，只需要一个 bot token。
常用命令
| 命令 | 作用 |
|---|---|
openclaw dashboard | 打开浏览器控制台 |
openclaw tui | 打开终端界面 |
openclaw configure | 修改配置 |
openclaw gateway status / stop / restart | 查看、停止、重启网关 |
openclaw models list | 列出可用模型 |
openclaw doctor | 检查配置问题 |
openclaw --version | 查看版本 |
出问题时
openclaw triage它会做只读的健康检查，把结果整理成一段脱敏的说明，并可以交给机器上检测到的编程智能体（Claude Code、Codex CLI 等）来诊断。在你选择之前，没有任何内容离开本机。
想自己看检查结果，用 openclaw doctor。
提示找不到 openclaw 命令，几乎都是 PATH 问题：npm 的全局 bin 目录不在 PATH 里。
node -v
npm prefix -g
echo "$PATH"