⚠️ 注意
本次 v2.0.0 为大版本重写,由于时间紧迫,测试覆盖尚不完全,欢迎大家测试并反馈问题!
如遇到问题请在 Issues 中报告。
Breaking Changes
- 移除 HTTP 回调模式,全面切换至 WebSocket 长连接(需配合企微 AI 助理 WebSocket 模式)
- 删除
crypto.js、webhook.js、stream-manager.js及相关 HTTP handler 模块 - OpenClaw 2026.3.8 兼容基础测试通过
New Features
- 🔌 多账号 WebSocket 并行连接 — 支持同时连接多个企微 AI 助理,自动重连 + 指数退避
- 🤖 动态 Agent 选择 — 按关键词/正则/默认规则路由消息到不同 Agent
- 🔄 Agent API 回调兜底 — WebSocket 断连时自动降级到 Agent API 投递消息
- 📦 待发送消息队列 — WS 断连期间缓存未发送消息,重连后自动投递(5 分钟 TTL)
- ⏱️ 推理流 800ms 节流 — 防止 SDK 100 条队列溢出导致 thinking 内容丢失
- 👥 群聊 @机器人 支持 — 群消息策略(仅响应 @bot 的消息)
- 🎙️ 语音消息识别 — 自动将语音转文字后发送给 Agent
- 🖼️ 图片消息发送 — 通过 Agent API media_id 发送图片
- 📊 运行时遥测 — 连接状态、消息计数、错误统计
- 🏖️ 沙箱隔离 — 账号级状态隔离
- 📋 入职引导 — 新用户自动引导流程
Refactor
- 按职责拆分模块:
ws-monitor、ws-state、dm-policy、group-policy、onboarding、sandbox、runtime-telemetry constants.js统一管理所有配置常量- 测试套件重写,覆盖新模块(113/116 tests passing)
安装 / 升级
openclaw plugins install @sunnoy/wecom迁移指南
从 v1.x HTTP 回调迁移到 v2.0 WebSocket 长连接,请参考 README 迁移指南。