明明已经在配置里打开了流式输出，机器人在飞书里回复消息时，却还是"哗"地一下全部吐出来，完全没有 ChatGPT 那种逐字显示的流畅感。这是怎么回事？
说实话，我也卡在这里很久。翻遍了文档、改了好几轮配置，最后才发现问题根本不在 OpenClaw 这边。今天就把这段踩坑经历分享出来，希望能帮你少走弯路。
先确认 OpenClaw 这边的配置
首先，确保 OpenClaw 本身的配置是对的。下面两种方法，选一种顺手的就行：
方法一是命令行配置：
# 开启流式输出
openclaw config set channels.feishu.streaming true
# 可选：显示耗时信息
openclaw config set channels.feishu.footer.elapsed true
# 可选：显示状态信息
openclaw config set channels.feishu.footer.status true
# 别忘了重启 Gateway
openclaw gateway restart
方法二是直接改配置文件。
找到 ~/.openclaw/openclaw.json（Windows 用户在 %USERPROFILE%\.openclaw\openclaw.json），加上这几行：
{
channels: {
feishu: {
streaming: true,
blockStreaming: true,
},
},
}
改完记得重启 Gateway。
配置对了还是不行？看看排查方法
如果上面的配置都检查过了，流式输出还是没反应，建议按这个顺序排查：
执行 openclaw gateway status 看一眼。配置是不是真的保存了？可以用 openclaw config get channels.feishu.streaming 确认。或者直接打开配置文件瞅一眼。最后，重启 Gateway 。
如果这些都做了，还是不行，那问题八成在飞书那边。
真正的问题：飞书开放平台的权限
如果你 OpenClaw 这边的配置都搞定了，流式输出还是不工作，几乎可以肯定是因为飞书开放平台的权限没开对。
为什么这么说？得先理解流式输出的技术原理。
OpenClaw 的流式输出，靠的不是普通文本消息，而是飞书的 CardKit 卡片。具体流程是这样的：机器人先发一张卡片，上面写着"正在输入..."，然后随着 AI 不断生成内容，OpenClaw 会一次次调用飞书 API 去更新这张卡片。用户看到的就是卡片内容在实时变化，产生那种逐字输出的效果。
所以你看，流式输出能不能用，完全取决于你有没有权限创建和更新 CardKit 卡片。
必须开启的权限有哪些
登录飞书开放平台，进入你的机器人应用，找到权限管理，确保下面这几个权限都加上了：
最重要的是 cardkit:card:write（创建与更新卡片）。没有它，OpenClaw 根本没法创建和更新流式卡片，流式输出自然就失效了。
另外还需要 cardkit:card:read（读取卡片）、im:message:send_as_bot（以机器人身份发消息）、im:message:readonly（读取消息）。
添加步骤很简单：进权限管理，点批量添加或添加权限，搜索上面这几个权限代码，勾选上，保存。
文章评论