Skip to content

[Bug] OpenClaw 2026.9.x 上流式草稿零 chunk:工具执行过程在 QQ 端完全不可见(升级前正常),希望获得与其他通道一致的进度显示体验(已更新根因分析与处理建议) #318

Description

@itanyplus

环境

  • 插件版本:@tencent-connect/openclaw-qqbot 2.0.3(npm 最新)
  • OpenClaw 版本:2026.9.4(从 2026.7.1-2 原地升级)
  • 运行环境:Ubuntu / systemd --user / npm 全局安装
  • 渠道:QQ Bot C2C 私聊
  • 配置:channels.qqbot.streaming = {"mode": "partial"}

问题一(核心):流式草稿自升级起从未收到过一个 chunk

升级到 2026.9.4 后,无论任务长短,mode: partial 的流式草稿从未启动过。跨两天观测到的全部相位记录均为:

[qqbot][streaming] phase: idle → failed (finalize:fallback)

共 6 次观测(9/11~9/12),零次 idle → streaming、零次 first_chunk。按 streaming-controller.ts 的实现语义,finalize:fallback = 无会话+零下发——即整个回合期间 controller 从未收到任何 chunk。

升级前对照:2026.7.1-2 + 官方第一方插件 @openclaw/qqbot(同样 streaming=partial 配置)时,草稿渐进更新正常工作,用户能在处理期间看到打字机式进度。升级后此体验完全消失。

问题二(连带):streaming=off 时工具进度消息发出但 QQ 端不显示

作为绕过尝试,我们把 streaming 改为 off。框架确实开始投递工具进度消息(长任务期间观测到多次 API 发送、HTTP 200),但 QQ 客户端一条都收不到——猜测是被动回复限额(ReplyLimiter 默认 4 次/消息)耗尽后降级主动消息、被平台静默丢弃,或插件侧合并防抖后未送达。结果是两个模式下"过程显示"都不可用,只有最终回复可靠送达。

其他通道的效果对照(我们希望 QQ 达到同样的体验)

以 飞书(feishu)通道为例(同为 OpenClaw 2026.9.4、streaming mode=off),工具执行过程中用户能实时收到独立进度气泡:

🧠 Memory Search  <查询关键词>
📄 Web Fetch      <来源 URL>
📖 Read           <文件路径>
🛠️ Exec           <任务标题/命令摘要>   ← 9.4 核心默认隐藏命令文本,我们已通过补丁恢复

用户能全程看到 Agent 在做什么、做到哪一步,长任务(数分钟的检索分析)期间不会"失联"。这正是 QQ 端升级前拥有、升级后失去的体验。恳请贵插件在 9.4 上恢复等价能力——无论是修好流式草稿的 chunk 喂送(问题一),还是确保 streaming=off 时工具进度消息可靠送达(问题二),二选一即可大幅改善。

复现步骤

  1. OpenClaw 2026.9.4 + 本插件 2.0.3,streaming.mode="partial",重启网关
  2. 在 QQ 私聊发一条需要多工具协作的检索类请求(Agent 回合 2 分钟以上)
  3. 观察 journal:全程无任何 phase: idle → streaming;处理期间 QQ 客户端无任何显示;回合结束才收到最终回复

相关引用

请求

  1. 优先:排查 9.4 核心下 preview chunk 的喂送链路为何到不了 streaming controller(从 controller 侧看是 sendUpdate 从未被调用)
  2. 若短期难修草稿,建议确保 streaming=off 时工具进度消息能可靠送达(参照飞书通道的独立气泡效果),给用户一个可用的过渡方案

感谢维护这么活跃的插件(注意到 9/11 还有推送),有需要我们随时可以补充 journal 完整摘录、相位日志或稳定性证据。

Activity

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions