重装过程并不一帆风顺:多次 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 等),然后尝试官方一键安装脚本。

重装过程中的主要坑与解决

  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)
    干净重装后缺少配置。执行:

    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 路径修改(最关键数据保留)
    默认路径不匹配我的数据目录。最终解决:

    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