Macbook Pro M5配置OpenClaw排坑记录

OpenClaw实用避坑指南：从安装到配置的完整心得

折腾OpenClaw的过程中，确实踩了不少坑。这里把几个关键问题和解决方案记录下来，希望能帮你绕过这些弯路。

1. 环境准备：版本与安装方法

首先，npm和Node.js建议直接安装最新版本。别被一些过时的信息误导，比如“Node只建议装22版本”之类的说法，实际情况并非如此。

更重要的是安装方式。别再尝试用npm或从GitHub拉源码编译安装了，这些方法都已被官方弃用，不再是推荐路径。

最靠谱的方案，是直接去GitHub下载最新的.dmg安装包，或者从OpenClaw官网（https://openclaw.ai/）下载。安装步骤很简单：双击dmg文件，把图标拖到右侧的“应用程序”文件夹，然后在“访达”的应用列表里找到OpenClaw.app并启动。

这时通常会弹出一个对话框，询问是否安装CLI（命令行工具）。一定选择“是”。 接下来会有一个等待期——Mac可能没有任何反应，但后台其实正在安装。千万别重启电脑，耐心等上大概5分钟，直到提示CLI安装完成。

2. 配置验证与环境变量

安装后，先在终端里输入 openclaw -v 试试，能打印出版本号就算成功。

如果没反应，大概率是环境变量没配置。执行下面这几步：

执行：open ~/.zshrc
在文件末尾添加一行：export PATH="$HOME/.openclaw/bin:$PATH"
保存退出后，执行：source ~/.zshrc

之后再试 openclaw -v，版本号应该就能出来了。接着执行 openclaw configure 命令，开始配置模型。

3. 模型选择：本地部署的“坑”

这里有个血泪教训：别轻易尝试部署本地模型。 即使用的是MacBook Pro M5配24G内存，配置不算低了，但实际体验很糟糕。

曾用LM Studio本地部署了glm-4.6v-flash-7b和qwen3-vl-8b，虽然能跑起来，但一旦关联到OpenClaw，几乎成了“智障”，解决不了任何实际问题。更头疼的是，关联glm-4.6v-flash时还出现了对话返回乱码且不停止的问题，折腾半天也无解。

所以，直接选用云端模型是更明智的选择。 实测下来，glm-4.7性价比最高，配合OpenClaw也最“聪明”。另外，glm-4.7-flash目前免费，虽然速度慢点，但作为备用选项完全可行。

4. 关键配置与档案管理

回到配置步骤：执行 openclaw configure 后，选择 models –> z.ai –> cn –> 输入你的API Key，配置就完成了。

之后在终端里依次执行：openclaw gateway stop 和 openclaw gateway，服务应该就能正常启动。

一个小建议： 配置完成后，记得把 /Users/{你的mac账号}/.openclaw/openclaw.json 这个配置文件备份一下。以后难免会经常调整里面的设置，有份原始备份，万一改乱了还能对照还原。

5. 环境彻底清理：解决顽固连接问题

最大的一个坑，足足折腾了三天。情况是这样的：第一次安装OpenClaw并配置glm-4.7很顺利，但后来捣鼓本地模型把环境搞乱了。之后无论如何重装、重配，OpenClaw都连不上glm-4.7了，一直报连接错误。

查遍资料，问遍豆包、千问、GPT，给的方案都试了，还是不行。最后发现，根本原因是旧有文件没删干净。解决办法就是彻底清理所有相关文件，再重新安装。

具体操作：
执行：sudo find / -name "*openclaw*" 2>/dev/null
把搜出来的所有文件和目录，一个个删除干净。有些可以通过 npm uninstall 来卸载，具体操作不确定时可以问问AI助手。

关键就在于必须删彻底。 中间有一次没删干净，导致用dmg重装时，一打开OpenClaw.app就无限弹框。后来按上述方法把找到的所有OpenClaw相关痕迹都清除后，问题才真正解决。

以上就是目前趟过的主要坑点。安装和配置这类工具，有时候就是个精细活，一步不对就可能绕个大圈子。先把这些记录下来，后续如果再遇到新问题，再来补充。