从多次崩溃到完美运行：我在 MacBook Pro 上重装 OpenClaw V2026.4.2 的完整实战记录 作者: zhaoyang 更新: 2026年04月04日 1,231 字 约 4 分钟阅读 分类: 基础设施与运维 重装过程并不一帆风顺：多次 npm 证书错误、gateway 启动阻塞、WebSocket 1006 异常、workspace 路径错乱……几乎踩遍了所有坑。经过几天反复调试、备份恢复、配置优化，最终在 i9 MacBook Pro（macOS 15.7.4）上实现了 **8 个专业 Agent** 的稳定运行，所有历史记忆完整保留。 今天把整个过程写成这篇博客，希望帮到同样想部署 OpenClaw 的朋友，少走弯路。 <!--more--> ### 为什么选择 OpenClaw？ OpenClaw 是 2026 年最受欢迎的开源 AI Agent 框架之一。它不是简单的聊天机器人，而是一个**自托管、持久运行的 Agent 运行时**： - 支持多种聊天通道（飞书、微信等），消息即指令。 - 可调用强大模型（如 MiniMax-M2.7-highspeed，约 100 TPS）。 - 内置技能系统、Task Flow、文件同步、内存管理。 - 完全本地优先，隐私安全，数据不离开你的设备。 我使用的是 **MiniMax Token Plan 月付套餐**（4500 次调用 / 5 小时，支持图像理解、联网搜索、生成多媒体，每周 10 倍额度）。计划运行 8 个 Agent： - 微信公众号撰写 - 小说撰写 - 个人投资管理 - 私人健康管理 - 职场计划管理 - IT 运维支持 - IT 采购支持 - Main（主控 Agent，负责路由分发） 其中后三个 Agent 需要少量信息同步。 ### 背景与准备 我的数据全部保存在 `/Users/openclaw/Desktop/xiaWork`（.openclaw/workspace 为空）。重装前必须完整备份： ```bash mkdir -p ~/OpenClaw_Backup_$(date +%Y%m%d) cp -r /Users/openclaw/Desktop/xiaWork ~/OpenClaw_Backup_*/xiaWork_backup ``` 关闭旧进程，彻底卸载残留（npm uninstall、删除 ~/.openclaw、LaunchAgent 等），然后尝试官方一键安装脚本。 ### 重装过程中的主要坑与解决 1. **npm 证书错误（UNABLE_TO_GET_ISSUER_CERT_LOCALLY）** 使用 npmmirror 时频繁失败。解决办法：切换官方源 `registry.npmjs.org`，重装 ca-certificates 和 openssl，设置 `NODE_EXTRA_CA_CERTS`，并临时关闭 strict-ssl。重启 Terminal 后问题解决。 2. **Gateway 启动阻塞（gateway.mode unset）** 干净重装后缺少配置。执行： ```bash openclaw config set gateway.mode local openclaw gateway install --force openclaw gateway restart ``` 结合 `openclaw doctor --fix --deep` 修复 LaunchAgent 和端口问题。 3. **WebSocket 1006 异常 & 控制面板无法连接** Gateway 运行但 WS 断开。多次重启、kill 残留进程、清理日志后解决。推荐用 `openclaw dashboard` 命令打开带 token 的链接。 4. **插件与通道配置** V2026.4.2 中 Feishu 已内置，无需 `plugins install feishu`。直接 `openclaw channels add` 配置 App ID/Secret，选择 WebSocket 模式、群聊 Open 策略、DM pairing（推荐，安全）。绑定到 main Agent 作为入口。 5. **MiniMax 配置** 通过 `openclaw configure --section models` 设置 MiniMax-M2.7-highspeed，输入 Token Plan Key。默认模型切换成功，用量实时可见。 6. **Workspace 路径修改（最关键数据保留）** 默认路径不匹配我的数据目录。最终解决： ```bash openclaw config set agents.defaults.workspace "/Users/openclaw/Desktop/xiaWork" openclaw gateway restart ``` 控制面板中确认 workspace 已更新，所有记忆自动加载。 7. **Agent 绑定与路由** 目前以 main Agent 为入口，后续可创建 7 个专用 Agent 并设置 routing rules（例如指令中提到“用公众号 Agent”即路由）。 ### 当前运行状态 - Gateway：运行中，端口 18789 正常监听。 - Feishu：已启用，支持群聊与私聊（DM pairing 安全策略）。 - 模型：MiniMax-M2.7-highspeed 默认可用。 - Workspace：正确指向 xiaWork，所有历史数据完整。 - 控制面板：可正常访问，查看 Agents、Files、Skills 等。 - 用量：MiniMax 剩余额度充足（建议高频 Agent 优先，低频按需唤醒）。 后三个 IT 相关 Agent 可通过 `xiaWork/shared/it/` 目录实现少量文件同步。 ### 经验总结与建议 - **备份第一**：重装前务必备份自定义 workspace。 - **命令优先**：遇到问题先跑 `openclaw doctor --fix --deep` 和 `openclaw gateway restart`。 - **安全为先**：DM 策略推荐 pairing 或 allowlist，避免 open 模式导致滥用。 - **性能与用量**：i9 MacBook Pro 完全够用，但 MiniMax 套餐适合 2~3 个高频 Agent，合理规划路由。 - **未来计划**：逐步完善 8 个 Agent 的 persona、skills 和 Task Flow，让它们真正成为我的“数字团队”。 整个过程从多次失败到最终稳定，大概花了几天时间，但收获巨大。现在我可以在飞书中直接 @机器人，下达写作、规划、运维等指令，它会基于我的历史记忆智能响应并执行。 如果你也在部署 OpenClaw，欢迎在评论区分享你的经历或遇到的问题。我会继续更新后续 Agent 优化和实际使用案例。 **OpenClaw 官网 / 文档**：https://openclaw.ai **我的配置参考**：V2026.4.2 + macOS 15.7.4 + MiniMax + Feishu 感谢 OpenClaw 团队和社区，这个框架让 AI 真正走进了我的日常工作流。 如果你有类似重装/配置需求，随时留言交流。让我们一起把 AI Agent 用起来！ 标签: 自托管, OpenClaw, AI Agent, 故障排查, 部署配置, macOS