先说结论
一篇真正省时间的 OpenClaw 安装教程,重点不是给你抄一长串旧命令,而是帮你先回答下面三个问题:
- 当前官方版本要求是什么
- 我更适合本地还是云端
- 装好之后下一步怎么验证
如果这三个问题没想清楚,你就算装上了,也很容易卡在"能启动,但不知道接下来怎么办"。
第一步:确认环境要求
截至 2026 年 3 月,OpenClaw 的环境要求:
- Node.js ≥ 22(推荐 Node 24)
- Git
- Docker(可选,走容器路线时需要)
先确认本地工具链:
node -v
npm -v
git --version
如果 node -v 返回版本低于 22,先升级 Node。macOS 用 brew install node,Windows 去 nodejs.org 下载。
第二步:选安装路径
一键脚本(推荐第一次上手)
macOS / Linux:
curl -fsSL https://openclaw.ai/install.sh | bash
Windows PowerShell:
iwr -useb https://openclaw.ai/install.ps1 | iex
NPM 安装
npm install -g openclaw@latest
openclaw onboard --install-daemon
本地路径 vs 云端路径
本地路径更适合:
- 第一次验证
- 想快速看日志
- 先跑通流程
云端路径更适合:
- 长时间在线运行
- 需要团队共享
- 本地资源不足
如果你还不确定 OpenClaw 是否适合自己,先选本地通常更省时间。
第三步:初始化
安装完成后,运行初始化向导:
openclaw onboard --install-daemon
这个命令会引导你完成:
- 模型提供商选择
- API Key 配置
- 消息平台接入
- 权限设置
第四步:验证安装
安装成功不代表"能用"。至少做下面四步验证:
openclaw --version
openclaw gateway status
openclaw dashboard
openclaw doctor
预期结果:
--version返回当前版本号gateway status显示 Gateway 在运行dashboard打开管理面板(默认http://127.0.0.1:18789/)doctor所有检查项通过
再做一次最小对话测试:
openclaw run --prompt "你好"
如果能返回正常回复,安装就算跑通了。
第五步:别把安装当成终点
OpenClaw 真正开始有价值,是在它完成下面闭环之后:
安装
服务可以运行。
接渠道
它能出现在你真的会看的地方。OpenClaw 支持 12 个渠道,通过 openclaw channels add 接入。
装技能
它有最基本的读资料、处理内容和发送结果能力。
openclaw skills install @clawhub/web-search
openclaw skills install @clawhub/browser
openclaw skills install @clawhub/summarize
试任务
你拿真实任务验证过它。
新手常见误区
一上来就追求复杂部署
这会拉长安装时间,也会让排障难度直线上升。
安装完成后不做首轮任务验证
这会让你停留在"看起来装好了"的阶段。
还没看权限边界就装一堆技能
这会把安装问题和安全问题混在一起。先用 openclaw security audit --deep 检查一轮。
安装完成后的推荐下一步
- 继续看 开始使用
- 如果你要接中文团队协作场景,去看 飞书接入
- 如果你准备装第一批技能,读 新手技能推荐
- 查看官方安装文档 → docs.openclaw.ai
- 遇到问题 → GitHub Issues