QClaw V2的流式输出突然失灵？输入指令后界面一片空白，光标纹丝不动，或者反复显示“正在思考…”却迟迟不吐出任何文字——这种问题通常不是模型哑火了，而是输出缓冲没刷新、token流被截断，或者调试钩子没有挂到位。要解决它，得从配置、模型、协议三层依次排查。

强制触发流式输出并验证实时性

这一步操作其实很简单，但前提是底层传输通道必须启用流式支持——否则后续所有调试都建立在虚假前提上。

打开QClaw V2安装目录下的~/.openclaw/config.yaml，找到output节区。把streaming: false改成streaming: true，再额外添加一行flush_interval_ms: 50。保存后执行openclaw restart重启服务——注意：不重启的话修改无效。

然后在微信对话框里发送/debug stream test，观察响应是否变成逐字浮现，比如“t→e→s→t”这样每隔50毫秒蹦出一个字符。如果还是整块返回，那说明模型后端压根没用chunked transfer编码，流式根本没走通。

定位模型推理结果卡在哪个环节

流式中断通常卡在三个关键节点：模型token生成层、QClaw中间件封装层、微信协议回传层。要准确定位，就得逐层剥离。

方法一：绕过微信直查原始输出流
在终端执行：curl -N http://127.0.0.1:8080/api/v2/debug/stream-log
如果这里能看到连续的token流（比如data: {"token":"世"}ndata: {"token":"界"}n），那问题就出在微信通道上；如果这里也卡住，那问题在模型或者中间件。

方法二：注入调试日志到模型调用栈
编辑~/.openclaw/agents/main/agent.yaml，在model节区下添加：debug: {log_tokens: true, log_latency: true}。重启后查看qclaw-current.log，搜索字段"token_emitted"和"latency_ms"——如果一条token_emitted都找不到，说明模型压根没进入生成阶段。

修复常见流式失效场景

第一步：检查模型是否支持原生流式响应
不是所有本地模型默认就支持stream模式。比如Ollama加载qwen3.5:35b-a3b时，启动服务必须加--stream参数；LM Studio则要在Local Server设置页里勾选“Enable streaming responses”。

第二步：禁用可能导致缓冲滞留的中间件
进入~/.openclaw/middleware.yaml，把response_compressor: true临时改成false。因为gzip压缩会等完整响应体生成后才发送，这和流式逻辑是冲突的。

第三步：校验微信协议层心跳包干扰
执行openclaw config setheartbeat.interval "30m"，把心跳间隔大幅延长到30分钟。高频心跳会抢占HTTP长连接的写入通道，导致token流被阻塞——这个坑特别容易忽视。