这里好几个坑,分别记录一下:

1. npm和node.js都安装最新版本(不要听豆包等说node建议只安装22的版本,这些信息是不正确的)

2. 安装后,无法连接glm等在线模型或者任何问题,你问豆包或千问,最终无法解决,AI都告诉你最后一招,让你回退会老的openclaw版本安装试试。别听它的,就用最新的,都不是openclaw版本的问题,我后来定位的因为是之前装过的openclaw把环境给破坏了,没删干净。删干净后重装就好了。

PS:记录一下,我安装的openclaw版本是2026.2.13,至少保证这个版本是可以正常使用的。

3. 不要用npm、github下载源码编译等安装方式。这些都已经被openclaw弃用为非推荐了。

最佳的方案就是在github上下载最新的dmg安装包安装(或者在OpenClaw的官网https://openclaw.ai/下载应该也可以)。

安装方法就是双击dmg --> 拖到右面 --> 然后在访达/应用软件/,找到OpenClaw.app的图标启动 --> 正常情况会弹出一个对话框,问你要不要Install CLI --> 选择是(这里对话框会消失,等待好几分钟,Mac电脑是没有反应的,实际上正在后台安装,不要重启电脑,就等着,过了5分钟吧,会提示CLI安装完成了)。

再下一步是在终端里,输入openclaw -v,试一下是不是打印出来版本了,打印出来就成功。

我的这步是没有打印出来。还需要执行一个步骤,添加环境变量:

执行:open ~/.zshrc

在文件最后面增加一行:export PATH="$HOME/.openclaw/bin:$PATH"

保存退出

执行:source ~/.zshrc

然后openclaw -v,就能打印出版本了。

接下来,执行openclaw configure命令,配置模型。

4. 不要尝试部署本地模型了,我买的Macbook Pro M5,24G内存,按理配置不算低了,我用LM Studio本地部署了glm-4.6v-flash 7b和qwen3-vl-8b,能跑,但是关联到openclaw后,简直是智障,解决不了任何问题(而且openclaw关联glm-4.6v-flash时,还出现对话返回乱码不会停止的问题,弄了半天也没有解决)。

所以,建议直接用云端模型。建议glm-4.7,试过性价比最高,且配合openclaw最聪明。另外,glm-4.7-flash当前免费,可以默认使用,虽然很慢,但毕竟不花钱。

5. 回到第1点,openclaw configure配置glm模型,选择models --> z.ai --> cn --> 输入API Key,然后就行了。

之后在终端里输入openclaw gateway stop --> openclaw gateway,应该就可以启动成功了。

6. 上面都配置完成后,注意把 /Users/{你的mac账号}/.openclaw/openclaw.json 这个配置文件里的内容保存一下,后面可能会经常修改里面的配置项,避免改坏了,以后还可以回来核对,正确的格式和内容是怎样的。

7. 还有一个大坑,搞了3天,就是一开始第一次安装openclaw+glm4.7成功了,后来搞本地模型把环境给破坏了,再怎么重新安装和配置openclaw+glm4.7都连不上了,显示connect error(大概是这个意思)。查了各种资料,问豆包、千问、GPT都解决不了。后来采用把所有和openclaw相关的文件都删除的方法再重新安装才成功了。

方法如下:

执行:sudo find / -name "*openclaw*" 2>/dev/null

然后把搜索出来的文件都一个一个删掉,有些用npm uninstall好一些,具体不清楚就问豆包或千问怎么删,跟着做就行了

必须所有但删干净。

中间没彻底删干净,出现了一个使用openclaw.dmg重新安装时,在访达/应用程序/openclaw.app打开时,出现无限弹框的问题。后来就是强制把sudo find / -name "*openclaw*" 2>/dev/null的所有文件目录都删干净后,就解决了。

先记录这些,后面再有坑再补充。

Logo

小龙虾开发者社区是 CSDN 旗下专注 OpenClaw 生态的官方阵地,聚焦技能开发、插件实践与部署教程,为开发者提供可直接落地的方案、工具与交流平台,助力高效构建与落地 AI 应用

更多推荐