OpenClaw 新版本兼容性升级公告
一、背景
OpenClaw 2026.7.1-2 版本后的 API 出现兼容性变更：
| 类型 | 旧 API | 新 API |
|---|---|---|
| API 路径 | deps.runtime.channel.reply.formatInboundEnvelope |
deps.runtime.channel.reply.formatAgentEnvelope |
使用内置版 qqbot 插件或旧版 qqbot 插件（版本 < 2.0.1）时，在高于 2026.7.1-2 的环境下处理私聊/群聊消息会报错，需将插件升级至 2.0.1+ 版本，会自动适配新旧 API。
二、如何升级
方式一：对话框升级
在后台环境中执行以下命令：
npx -y @tencent-connect/openclaw-qqbot-cli@latest若当前环境未安装该 qqbot 插件，请直接执行安装流程；若已安装该插件，请执行对应版本的更新操作，操作完成后通知我。
方式二：终端升级命令
npx -y @tencent-connect/openclaw-qqbot-cli@latest三、升级确认
完成上述任一方式升级后，发送 /bot-version 验证插件版本，确认版本号已升级至 2.0.1 及以上。
如升级过程中遇到问题，请联系技术支持。