qclaw v2流式输出失效需依次检查配置、模型与协议层：1.启用config.yaml中streaming:true及flush_interval_ms:50并重启；2.验证/debug stream test逐字输出；3.用curl或debug日志定位中断节点；4.确认模型原生支持流式、禁用response_compressor、调整微信心跳间隔。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
当你在QClaw V2中输入指令后，界面长时间空白、光标静止不动，或只显示“正在思考…”却迟迟不吐出任何文字，说明流式输出链路中断或模型推理结果未被正确捕获；这通常不是模型没响应，而是输出缓冲未刷新、token流被截断、或调试钩子未挂载到位。
强制触发流式输出并验证实时性
这一步操作起来很简单，直接把文件拖进去就行。但必须先确认底层传输通道已启用流式支持，否则所有后续调试都建立在虚假前提上。
1、打开QClaw V2安装目录下的~/.openclaw/config.yaml，定位到output节区；
2、将streaming: false改为streaming: true，并添加字段flush_interval_ms: 50；
3、保存后执行openclaw restart重启服务——【不重启则修改无效】；
4、在微信对话框中发送/debug stream test，观察是否每50ms出现一个字符（如“t→e→s→t”逐字浮现）；若仍为整块返回，则说明模型后端未启用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"，大幅延长心跳间隔；高频心跳会抢占HTTP长连接的写入通道，导致token流被阻塞。
