Community Guide
在 macOS 上安装 OpenClaw
按推荐顺序完成 OpenClaw 的第一条本地安装路径，包括 Node 22、onboard、诊断和备份。
2026/03/13
为什么 macOS 仍然是最适合起步的本地路线
橙色皮书把本地安装视为最安全的学习路径，而 macOS 仍然是最容易把环境看清楚的一条路线之一。
你现在不是要搭一个生产环境，而是要先确认四件事：
- OpenClaw 能正常运行
- 至少一条模型路径可用
- onboarding 流程是通的
- 你理解了基础操作闭环
开始前确认
你至少应该具备：
- Node.js 22 或更高版本
- npm、pnpm 或 bun 其中之一
- 已安装 Xcode Command Line Tools
- 开始前先想好一条模型路线
推荐顺序
1. 先把机器准备好
先补齐运行时，再谈安装。很多“装不上”问题，本质上是版本不匹配。
2. 安装 CLI 并执行 onboard
橙色皮书推荐的起步命令是：
npm install -g openclaw@latest
openclaw onboard --install-daemon这比你一开始就自己拼一条手工路径更接近当前支持的主流程。
3. 安装后先做环境校验
onboard 完成后，先把验证和安装分开看：
openclaw doctor不要把渠道、模型和安装问题混在一起排查。
4. 先做一次备份
2026 年 3 月线增加本地备份工具，不是摆设：
openclaw backup create在你开始激进更新或改配置之前，先把可回滚点留好。
5. 本地稳定后再走下一步
本地安装稳定后，下一步通常才是：
- 接渠道
- 配模型栈
- 转托管 / 云部署
macOS 上最常见的错误
旧 shell 环境状态太重
先检查 PATH、Node 版本和包管理器状态。
一次调试所有层
安装、渠道、模型是三类问题，不要揉成一团。
过早上云
一个正确的本地安装，远比一个模糊可用的服务器更有价值。