重装过程并不一帆风顺:多次 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 为空)。重装前必须完整备份:
mkdir -p ~/OpenClaw_Backup_$(date +%Y%m%d)
cp -r /Users/openclaw/Desktop/xiaWork ~/OpenClaw_Backup_*/xiaWork_backup关闭旧进程,彻底卸载残留(npm uninstall、删除 ~/.openclaw、LaunchAgent 等),然后尝试官方一键安装脚本。
重装过程中的主要坑与解决
- npm 证书错误(UNABLE_TO_GET_ISSUER_CERT_LOCALLY)
使用 npmmirror 时频繁失败。解决办法:切换官方源registry.npmjs.org,重装 ca-certificates 和 openssl,设置NODE_EXTRA_CA_CERTS,并临时关闭 strict-ssl。重启 Terminal 后问题解决。 Gateway 启动阻塞(gateway.mode unset)
干净重装后缺少配置。执行:openclaw config set gateway.mode local openclaw gateway install --force openclaw gateway restart结合
openclaw doctor --fix --deep修复 LaunchAgent 和端口问题。- WebSocket 1006 异常 & 控制面板无法连接
Gateway 运行但 WS 断开。多次重启、kill 残留进程、清理日志后解决。推荐用openclaw dashboard命令打开带 token 的链接。 - 插件与通道配置
V2026.4.2 中 Feishu 已内置,无需plugins install feishu。直接openclaw channels add配置 App ID/Secret,选择 WebSocket 模式、群聊 Open 策略、DM pairing(推荐,安全)。绑定到 main Agent 作为入口。 - MiniMax 配置
通过openclaw configure --section models设置 MiniMax-M2.7-highspeed,输入 Token Plan Key。默认模型切换成功,用量实时可见。 Workspace 路径修改(最关键数据保留)
默认路径不匹配我的数据目录。最终解决:openclaw config set agents.defaults.workspace "/Users/openclaw/Desktop/xiaWork" openclaw gateway restart控制面板中确认 workspace 已更新,所有记忆自动加载。
- 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 用起来!