这篇微信文章是一份典型的“面向纯新手”的保姆教程,优点是非常耐心:它不仅拆开了 Mac / Windows 两条安装路线,还把“终端是什么”“怎么复制粘贴命令”“怎么验证安装成功”都讲得很细。你给我的离线网页包里,正文和 34 张图片我都已经完整保存到了站点里。
这篇原文讲了什么
它的结构其实很完整,分成六大段:
- 先用很口语的方式解释 OpenClaw 是什么,以及为什么它和普通聊天 AI 不一样。
- 把 Mac 和 Windows 的安装流程彻底拆开,避免新手来回跳步骤。
- 把 onboarding 向导单独讲一遍,包括模型、API Key、默认模型和聊天渠道。
- 补了安装成功后的验证动作,比如
openclaw status、openclaw dashboard、openclaw doctor。 - 给了一页“常用命令速查表”和“常见问题排查”。
- 最后又延伸到 Skills、人格文件和长期自定义,试图让读者理解 OpenClaw 不只是“装好就结束”。
这篇文章最值得保留的地方
- 它对“终端是什么”“如何粘贴命令”讲得很细,特别适合第一次接触命令行的人。
- 把 Mac 和 Windows 拆成两条路线,是对新手最友好的写法。
- 安装、验证、排障、后续玩法都写到了,读者不容易“装完就断片”。
- 它不是只停在“装软件”,而是试图让用户理解 OpenClaw 后面还有 Skills、工作区和人格配置这些层次。
按原文整理后的安装主线
1. 先判断系统类型
原文做得很对的一点是,没有强行把所有系统混在一页里,而是明确分成:
- Mac:终端 -> Homebrew / Node -> 安装脚本
- Windows:PowerShell(管理员)-> WSL -> WSL 内安装 Node -> 安装脚本
2. 安装本体之后直接进入 onboarding
原文默认用官方安装脚本:
curl -fsSL https://openclaw.ai/install.sh | bash
然后把重点放到 onboarding 向导:先过安全提醒,再选快速模式、模型提供商、连接方式、默认模型和渠道配置。
3. 装完之后先做三件事
原文建议装完后立刻做这三步检查,这个思路是对的:
openclaw status
openclaw dashboard
openclaw doctor
这样能快速区分“OpenClaw 没装上”“Gateway 没起来”“模型没连通”这几类问题。
4. 最后再讲 Skills 和长期自定义
原文没有把内容停在安装成功,而是继续讲新手技能、国内用户推荐和人格文件配置。这部分虽然有混合了社区经验和官方能力,但方向是好的:让读者知道 OpenClaw 的重点不是“开机”,而是“后面怎么变成自己的助手”。
这篇文章里最需要校正的地方
1. Homebrew 安装命令写错了格式
原文写成了:
/bin/bash-c"$(curl-fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
正确写法应该是:
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
2. “OpenClaw 会自动安装 Homebrew 和 Node.js”说得太满
官方安装器会处理 Node 22+ 的检测和安装,但把 “Homebrew 一定会自动装好” 写成默认事实就有点过头了。更稳妥的说法应该是:官方安装脚本会处理 Node 检测和 onboarding;如果你想手动准备 Node,Homebrew 是 macOS 上的推荐路线。
3. PATH 配置命令被写成了一行,复制会出错
原文把下面两步糊成了一行:
echo 'export PATH=$(npm config get prefix)/bin:$PATH' >> ~/.zshrc source ~/.zshrc
正确应该拆成两条命令分别执行:
echo 'export PATH=$(npm config get prefix)/bin:$PATH' >> ~/.zshrc
source ~/.zshrc
4. 卸载命令既不安全,也不符合官方主路线
原文把卸载写成了这种连在一起的危险命令:
openclaw gateway stop npm uninstall -g openclaw rm -rf ~/.openclaw
这既是格式错误,也不适合直接教给新手。官方更推荐:
openclaw uninstall
如果只是想重置配置,优先考虑 openclaw reset,不要一上来就手动删目录。
5. ~/clawd/ 不是官方默认工作区
原文后半段把人格文件写在 ~/clawd/ 下面,这更像作者自己的社区习惯,不是 OpenClaw 官方默认布局。官方当前文档里,默认工作区是:
~/.openclaw/workspace
而 bootstrapping 默认会种下的文件,也不是它列出来的那一整套。官方说明更接近:
- 默认种子文件:
AGENTS.md、BOOTSTRAP.md、IDENTITY.md、USER.md - 启动问答后写入:
IDENTITY.md、USER.md、SOUL.md
所以像 HEARTBEAT.md、MEMORY.md 这类内容,更适合视为社区扩展思路,不应当写成“官方默认就有”。
6. “在聊天框里说安装 xxx 技能就行”更像体验描述,不是稳定安装规范
这句对新手很有诱惑力,但不适合作为知识库里的标准安装说明。更稳的路线还是走官方的 Skills / ClawHub 能力说明,先判断这个 Skill 来自哪里,再决定怎么装。
适合谁读这篇案例
- 完全没有命令行经验,第一次碰 OpenClaw。
- 需要一份“从打开终端开始讲”的保姆文章。
- 想先跑通安装,再慢慢理解 Skills、人格文件和长期使用方式。