ARTICLE

OpenClaw 安装教程:先确认版本要求,再走最短部署路径

这是一篇面向第一次上手者的 OpenClaw 安装教程,重点不是让你照抄过时命令,而是帮你先核对官方当前版本要求,再根据自身环境选择本地或云端部署路径。从系统依赖检查到最终启动验证,每一步都给出判断标准和常见问题排查方式,让你把时间花在正确的安装决策上。

更新于 2026年3月10日
安装教程部署

先说结论

一篇真正省时间的 OpenClaw 安装教程,重点不是给你抄一长串旧命令,而是帮你先回答下面三个问题:

  1. 当前官方版本要求是什么
  2. 我更适合本地还是云端
  3. 装好之后下一步怎么验证

如果这三个问题没想清楚,你就算装上了,也很容易卡在"能启动,但不知道接下来怎么办"。

第一步:确认环境要求

截至 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 检查一轮。

安装完成后的推荐下一步

FAQ

文章常见问题

因为官方安装方式可能随版本变化。本文更强调如何核对当前要求,并做出正确路径选择。

大多数情况下先选本地路径更稳,因为反馈更快,也更容易观察日志和权限问题。