MacBook装OpenClaw手把手排障指南:Genius Bar工程师的私房笔记

各位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  # 停止网关

售后工程师的额外建议

  1. M系列芯片的Mac表现最好。如果你用的是M1/M2/M3/M4的MacBook,OpenClaw跑起来非常流畅,8GB内存就够了。Intel的老款也能用,就是稍微慢一点。

  2. 不要在系统更新的时候同时装OpenClaw。我见过好几个客户在macOS大版本升级过程中折腾安装,结果环境变量全乱了,回来找我们排障。

  3. Terminal和iTerm2都可以用,效果一样。如果你有装Homebrew的习惯,也可以用brew来管理Node.js版本,更灵活。

  4. 遇到问题先跑openclaw doctor。这个命令就像我们Genius Bar的诊断工具一样,能帮你快速定位大部分问题。

有什么装不上的情况,评论区说一下你的Mac型号和系统版本,我尽量帮大家看看。毕竟帮人排障这事儿,干了八年已经是肌肉记忆了。

刚入门 正需要这种内容

已经跑起来了 效果不错

这个信息有用

Genius Bar工程师来写教程 这可信度直接拉满

苹果售后工程师居然有空写技术博客 苹果的工作量看来不饱和啊

Homebrew装Node比官网pkg包更好管理 建议文章里改一下推荐

终于有人说到macOS版本太老装不了Node的问题了 我就是这个情况

@noobkid Genius Bar工程师的教程确实可信度高 而且他见过的问题比普通用户多得多 排障经验覆盖面广

@pcnoob macOS版本太老装不了Node的解决方案 要么升级系统 要么用nvm装老版本Node 14以上基本都支持OpenClaw

ingress那块配置真的坑多

用helm chart省事不少建议试试

加个exponential backoff自动重试