适合谁
这条路径适合：
- 想先跑通一套可见的本地流程
- 需要边装边看日志
- 暂时不准备做长期在线部署
如果你的目标只是“先知道 OpenClaw 能不能帮我做事”，macOS 往往是最省时间的第一条路。
安装前先做版本检查
先不要急着执行安装命令。Mac 上第一次安装时，先准备这几样：
- 一个可以正常使用的终端
- 已安装好的 Node.js
- 如果你偏好容器管理，Mac 可以额外装一个 OrbStack 作为 Docker 替代入口
然后再确认本地工具链：
node -v
npm -v
docker --version
git --version
预期输出示例：
v22.12.0 ← Node.js 版本（≥22，推荐 24）
10.2.4 ← npm 版本
Docker version 25.0.3 ← 走 Docker 路线才需要
git version 2.43.0
如果 node -v 返回 command not found，先用 Homebrew 安装：
brew install node
如果你打算走 Docker 路线，还应该确认 Docker Desktop 或 OrbStack 已经能正常启动。
网络不稳时的可选处理
如果安装依赖时明显很慢，可以先临时切 npm 镜像：
npm config set registry https://registry.npmmirror.com/
这不是必须项。网络正常时，优先保持默认源。
关键步骤
1. 先核对官方当前安装方式
OpenClaw 的推荐安装方式可能会随着版本变化。Mac 第一次安装时，最稳的做法还是：
- 先打开 官方中文安装教程
- 再按当前版本要求执行安装
- 不要把旧博客、旧脚本和当前官方步骤混着用
2. 把实例放在容易观察的位置
第一次安装时，目录结构不要过深，也不要直接放进装满项目和密钥的工作目录。单独准备一个测试目录更稳。
3. 装好之后立刻做首轮测试
首轮测试不要上复杂任务。先确认：
- 服务能启动 →
openclaw命令输出版本号和帮助信息 - 基础配置能保存 →
openclaw config list显示你刚设置的模型和认证信息 - 一个最简单的输入可以正常返回结果 →
openclaw run --prompt "你好"返回中文回复 openclaw doctor没有明显报错 → 所有检查项显示为通过状态
4. 接一个你真正会看的渠道
在本地环境里跑通安装后，尽快接上一个你会实际查看的聊天渠道。否则你仍然停留在“能启动，但不算能用”的状态。
常见误区
- 先追求最复杂的本地模型方案
- 一次接很多渠道
- 一开始就装很多第三方技能
- 没想好回滚路径就反复改配置
跑不通时先做什么
如果你已经装上了，但行为很怪，先不要急着删目录重来。Mac 本地调试时，优先这样做：
openclaw doctor
openclaw doctor --repair
如果当前聊天上下文已经混乱，也可以先在 OpenClaw 里用 /new 开一个新对话，再测试最小任务。
下一步建议
- 想继续走完整链路，去看 开始使用
- 想先接团队协作场景，去看 飞书接入
- 想先收敛技能范围，去看 新手技能推荐
- 想集中看高频命令和入口，去看 资源精选
- 遇到安装问题 → GitHub Issues
- 查看官方安装文档 → OpenClaw 文档