各位Mac用户好,我是一名在苹果售后干了八年的工程师,每天接待的客户里,最近十个有三个来问"我的MacBook能不能装那个龙虾"。能,当然能,而且Mac装OpenClaw是所有平台里最丝滑的,我来给你讲讲怎么弄,顺便把我见过的坑都标注出来。
第一步:确认你的Node.js版本
打开终端(不知道终端在哪?启动台搜"终端"或者用Spotlight搜"Terminal"),输入:
node -v
如果显示的版本号低于22,或者压根提示"command not found",说明你需要先装Node.js。去 Node.js — 在任何地方运行 JavaScript 下载macOS安装包,双击安装即可。
这里有个我在售后经常见到的问题:有些客户的Mac很久没更新系统,macOS版本太老装不了新版Node.js。建议至少升到macOS 12 Monterey以上。如果你不确定系统版本,点左上角苹果图标,选"关于本机"就能看到。
第二步:配置国内镜像加速
这步非常关键,不做的话下载速度会让你怀疑人生。在终端执行:
npm config set registry https://registry.npmmirror.com/
你看到光标正常回到下一行、没有报错,就说明设置成功了。不需要重启终端。
第三步:安装OpenClaw
终端输入:
npm i -g openclaw
如果报权限错误(Permission denied),不要慌,这是Mac的安全机制在起作用。加个sudo再来一次:
sudo npm i -g openclaw
会要求你输入开机密码,注意输入时屏幕上不会显示任何字符,这是正常的安全设计,打完回车就行。
我在售后遇到过不少客户在这一步卡住,以为键盘坏了——真的不是,这是Unix系统的传统,密码输入时不会有任何反馈。
第四步:交互式配置
安装完会自动进入配置流程,我帮你整理一下各项怎么选:
| 配置项 | 建议选择 | 说明 |
|---|---|---|
| Continue? | Yes | 安全确认,放心选 |
| Onboarding mode | QuickStart | 新手就选这个,别折腾 |
| Model/auth provider | Qwen | 免费的,先用着体验 |
| 其他配置项 | 直接回车 | 默认值就行 |
模型选Qwen Chat的原因很简单:免费。等你玩熟了再换DeepSeek或者其他模型都来得及。
第五步:验证安装
openclaw -v
能看到版本号(比如2026.3.2)就算成功了。然后启动控制面板:
openclaw dashboard
浏览器会自动打开,看到龙虾面板就大功告成。
常用命令速查表
这些命令我建议你截图保存,以后用得上:
openclaw doctor # 遇到问题先跑这个,全面诊断
openclaw status # 看整体运行状态
openclaw dashboard # 打开Web控制台
openclaw tui # 终端里直接管理(适合不想开浏览器的时候)
openclaw gateway run # 启动网关
openclaw gateway restart # 重启网关
openclaw gateway stop # 停止网关
售后工程师的额外建议
-
M系列芯片的Mac表现最好。如果你用的是M1/M2/M3/M4的MacBook,OpenClaw跑起来非常流畅,8GB内存就够了。Intel的老款也能用,就是稍微慢一点。
-
不要在系统更新的时候同时装OpenClaw。我见过好几个客户在macOS大版本升级过程中折腾安装,结果环境变量全乱了,回来找我们排障。
-
Terminal和iTerm2都可以用,效果一样。如果你有装Homebrew的习惯,也可以用brew来管理Node.js版本,更灵活。
-
遇到问题先跑
openclaw doctor。这个命令就像我们Genius Bar的诊断工具一样,能帮你快速定位大部分问题。
有什么装不上的情况,评论区说一下你的Mac型号和系统版本,我尽量帮大家看看。毕竟帮人排障这事儿,干了八年已经是肌肉记忆了。