OpenClaw Docs CN

安装部署 / 社区案例

案例:零基础装好 OpenClaw(保姆教程)

这篇微信文章是一份典型的“面向纯新手”的保姆教程,优点是非常耐心:它不仅拆开了 Mac / Windows 两条安装路线,还把“终端是什么”“怎么复制粘贴命令”“怎么验证安装成功”都讲得很细。你给我的离线网页包里,正文和 34 张图片我都已经完整保存到了站点里。

OpenClaw 概念图:你的 AI 私人助手
原文一开头先用“AI 私人助手”的方式解释 OpenClaw,定位非常适合完全没有技术背景的读者。

这篇原文讲了什么

它的结构其实很完整,分成六大段:

  1. 先用很口语的方式解释 OpenClaw 是什么,以及为什么它和普通聊天 AI 不一样。
  2. 把 Mac 和 Windows 的安装流程彻底拆开,避免新手来回跳步骤。
  3. 把 onboarding 向导单独讲一遍,包括模型、API Key、默认模型和聊天渠道。
  4. 补了安装成功后的验证动作,比如 openclaw statusopenclaw dashboardopenclaw doctor
  5. 给了一页“常用命令速查表”和“常见问题排查”。
  6. 最后又延伸到 Skills、人格文件和长期自定义,试图让读者理解 OpenClaw 不只是“装好就结束”。

这篇文章最值得保留的地方

  • 它对“终端是什么”“如何粘贴命令”讲得很细,特别适合第一次接触命令行的人。
  • 把 Mac 和 Windows 拆成两条路线,是对新手最友好的写法。
  • 安装、验证、排障、后续玩法都写到了,读者不容易“装完就断片”。
  • 它不是只停在“装软件”,而是试图让用户理解 OpenClaw 后面还有 Skills、工作区和人格配置这些层次。
Mac 终端和 Windows PowerShell 对比
这张图很适合新手理解:Mac 和 Windows 的安装入口不同,所以文章才分成两条路线。

按原文整理后的安装主线

1. 先判断系统类型

原文做得很对的一点是,没有强行把所有系统混在一页里,而是明确分成:

  • Mac:终端 -> Homebrew / Node -> 安装脚本
  • Windows:PowerShell(管理员)-> WSL -> WSL 内安装 Node -> 安装脚本

2. 安装本体之后直接进入 onboarding

原文默认用官方安装脚本:

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

然后把重点放到 onboarding 向导:先过安全提醒,再选快速模式、模型提供商、连接方式、默认模型和渠道配置。

配置向导:五步完成设置
原文把 onboarding 讲得很细,这部分对第一次跑通 OpenClaw 的用户确实有帮助。

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.mdBOOTSTRAP.mdIDENTITY.mdUSER.md
  • 启动问答后写入:IDENTITY.mdUSER.mdSOUL.md

所以像 HEARTBEAT.mdMEMORY.md 这类内容,更适合视为社区扩展思路,不应当写成“官方默认就有”。

6. “在聊天框里说安装 xxx 技能就行”更像体验描述,不是稳定安装规范

这句对新手很有诱惑力,但不适合作为知识库里的标准安装说明。更稳的路线还是走官方的 Skills / ClawHub 能力说明,先判断这个 Skill 来自哪里,再决定怎么装。

常见问题排查指南
原文的排障章节很有参考价值,但里面个别命令需要按官方当前 CLI 重新校正。

适合谁读这篇案例

  • 完全没有命令行经验,第一次碰 OpenClaw。
  • 需要一份“从打开终端开始讲”的保姆文章。
  • 想先跑通安装,再慢慢理解 Skills、人格文件和长期使用方式。

本地归档

原文参考

零基础装好OpenClaw 小龙虾:小学生都能看懂的保姆教程

OpenClaw 官方文档:Installation

OpenClaw 官方 CLI:onboard

OpenClaw 官方 CLI:uninstall

OpenClaw 官方文档:Workspace Bootstrapping