Macbook Pro M5配置OpenClaw排坑记录

OpenClaw 完整使用攻略：从零安装到高效配置的实战经验

在深度使用 OpenClaw 的过程中，我遇到了不少典型问题。本文将系统梳理从环境准备到最终配置的核心步骤与避坑要点，旨在帮助你高效部署，避免重复踩坑。

1. 环境准备：正确安装方法与版本选择

首先，确保你的 npm 和 Node.js 环境为最新稳定版。无需刻意寻找特定旧版本，新版本通常兼容性更好。

最关键的一步是安装方式。 请避免通过 npm 全局安装或从 GitHub 克隆源码编译，这些方式已被官方明确弃用，可能导致兼容性问题。

官方推荐且最稳妥的方案是：直接访问 OpenClaw 官方网站（https://openclaw.ai/）下载最新版本的 .dmg 安装包，或在 GitHub Releases 页面获取。安装过程十分简单：打开下载的 dmg 文件，将 OpenClaw 图标拖拽至“应用程序”文件夹，然后在“访达”中启动 OpenClaw.app。

首次启动时，系统会提示安装命令行工具（CLI）。务必点击“是”或“安装”。 接下来会出现一段等待时间，Mac 可能看似无响应，但后台正在进行安装。请保持耐心，不要关闭窗口或重启电脑，通常约 5 分钟后会提示 CLI 安装完成。

2. 配置验证与环境变量设置

安装完成后，打开终端（Terminal），输入命令 openclaw -v 来验证 CLI 是否成功安装。若能正常显示版本号，则说明基础安装成功。

若命令未找到，大概率是环境变量（PATH）未正确配置。请按顺序执行以下步骤进行修复：

执行：open ~/.zshrc
在该配置文件末尾新增一行：export PATH="$HOME/.openclaw/bin:$PATH"
保存并关闭文件后，执行：source ~/.zshrc

再次尝试 openclaw -v，此时应能正确输出版本信息。接着，运行 openclaw configure 命令，开始配置你的 AI 模型。

3. 模型选择策略：本地部署的陷阱与云端方案

这是一个重要的经验分享：初学者或追求稳定性的用户，不建议首选本地部署模型。 即便使用 MacBook Pro M5 搭配 24GB 内存，硬件性能不俗，实际体验也往往不尽如人意。

我曾尝试通过 LM Studio 本地部署 glm-4.6v-flash-7b 和 qwen3-vl-8b 等模型。虽然模型本身可以运行，但一旦与 OpenClaw 关联，其问题解决能力大幅下降，响应质量不佳。更棘手的是，关联 glm-4.6v-flash 时还出现了对话回复乱码且无法自动停止的 Bug，耗时良久也未能解决。

因此，直接选用可靠的云端模型是更高效、稳定的解决方案。 经过实际测试，glm-4.7 系列模型在性价比和与 OpenClaw 的协同智能程度上表现最佳。此外，glm-4.7-flash 目前提供免费额度，虽然响应速度稍慢，但作为备用或测试模型完全可行。

4. 核心配置步骤与配置文件管理

继续配置流程：执行 openclaw configure 后，在交互界面中依次选择：models –> z.ai –> cn –> 输入你从平台获取的 API Key，即可完成核心配置。

配置完成后，建议在终端中依次执行两条命令以重启服务：openclaw gateway stop 然后 openclaw gateway。正常情况下，服务将成功启动并运行。

一个重要提示： 完成初始配置后，建议立即备份你的配置文件。其路径通常为：/Users/{你的用户名}/.openclaw/openclaw.json。未来进行参数调整或模型切换时，若不小心导致配置错乱，这份原始备份能帮助你快速恢复。

5. 环境彻底清理：根治顽固的连接故障

这是我遇到过最耗时的问题，前后排查了三天。场景是：初次安装配置 glm-4.7 很顺利，但在尝试并清理本地模型后，环境出现异常。此后无论如何重装 OpenClaw、重新配置 API，都会持续报连接错误，无法正常工作。

查阅了大量社区资料并咨询了多个 AI 助手（如豆包、通义千问、ChatGPT），尝试了所有常见解决方案均告失败。最终定位到的根本原因是：旧版本的残留文件和配置未被彻底清除。 唯一的解决办法是进行全盘的彻底清理，然后重新安装。

具体操作步骤：
在终端中执行：sudo find / -name "*openclaw*" 2>/dev/null
此命令会列出系统中所有与 OpenClaw 相关的文件和目录（可能需要输入密码）。请谨慎地逐一删除它们。对于通过 npm 安装的组件，可先尝试 npm uninstall -g openclaw 等命令进行卸载，如有不确定之处，可随时询问 AI 助手获取针对性命令。

成败的关键在于“彻底”二字。 我曾因一次清理不彻底，导致用 dmg 重装后，一启动 OpenClaw.app 就出现无限弹窗循环。直到按照上述方法，将搜寻到的所有相关痕迹完全清除后，重新安装才一次性成功，所有功能恢复正常。

以上便是从安装到配置 OpenClaw 全流程中，总结出的主要注意事项与解决方案。这类工具的部署有时确实需要耐心和细致，希望这份实战指南能助你一路顺畅，快速开启高效的使用体验。后续若发现新的问题，将持续更新补充。