从多次崩溃到完美运行:我在 MacBook Pro 上重装 OpenClaw V2026.4.2 的完整实战记录 作者: Quesiter 时间: 2026-04-04 分类: 系统运维 重装过程并不一帆风顺:多次 npm 证书错误、gateway 启动阻塞、WebSocket 1006 异常、workspace 路径错乱……几乎踩遍了所有坑。经过几天反复调试、备份恢复、配置优化,最终在 i9 MacBook Pro(macOS 15.7.4)上实现了 **8 个专业 Agent** 的稳定运行,所有历史记忆完整保留。 今天把整个过程写成这篇博客,希望帮到同样想部署 OpenClaw 的朋友,少走弯路。 ### 为什么选择 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 用起来! 标签: none
评论已关闭