OpenClaw 飞书消息只显示最后几个字?我折腾一两天才搞定

背景
升级 OpenClaw 之后,飞书消息只显示最后几个字。Web UI 看着正常,手机端打开一看——好家伙,就剩个尾巴。
排查了一两天才解决。记录一下过程,供踩到同样坑的人参考。
问题现象
-
• 飞书卡片消息只显示最后几个字 -
• Web UI 正常,手机端显示不完整 -
• 消息被截断,看不到完整内容

完整排查过程
第一阶段:飞书完全连不上(5月22日 → 5月31日)
问题描述:飞书 bot 完全无法连接
排查过程:
-
1. 检查网络、防火墙、API 配置 -
2. 发现 OpenClaw 版本太旧(5月22日版本) -
3. 查官方文档,5月28日之后的版本才修复了飞书连接问题
解决:升级到 v2026.5.31-beta.4
第二阶段:消息截断(5月31日 beta 版本)
问题描述:飞书卡片消息只显示最后几个字
排查过程:
-
1. 检查飞书 channel 配置 -
2. 发现开启了 streaming: true 和 blockStreaming: true -
3. 流式卡片在移动端显示不完整
尝试方案 A:关闭 streaming\ 结果:完全不回复,失败
尝试方案 B:关闭 blockStreaming\ 结果:依然截断

第三阶段:6月1日 beta 版本
问题描述:升级到 v2026.6.1-beta.1,截断问题依然存在
最终解决方案
核心发现:需要同时关闭两个参数
streaming: falseblockStreaming: false
配置位置:~/.openclaw/openclaw.json → channels.feishu
生效方式:修改配置后重启网关
命令:
openclaw gateway restart
效果:消息完整显示,不再截断

参数解释
streaming:开启流式卡片输出,默认 true
-
• streaming: true — 边生成边显示,卡片实时更新 -
• streaming: false — 等生成完一次性发送
blockStreaming:已完成块提前刷新,默认 false
-
• blockStreaming: true — 已完成的内容块先发出去 -
• blockStreaming: false — 等最终回复才发送
为什么只关一个不行:需要两个参数配合使用才能正常非流式发送。
升级命令参考
# 查看当前版本openclaw --version# 升级到最新版openclaw update# 重启网关openclaw gateway restart# 查看 channel 状态openclaw channels status
当前配置(6月2日):
streaming: falseblockStreaming: falsetextChunkLimit: 2000

经验总结
-
1. 遇到飞书连接问题 → 先查版本,可能需要升级 -
2. 遇到消息截断 → 尝试关闭流式输出 -
3. 只关 streaming 不行 → 记得同时关 blockStreaming -
4. 改配置后 → 必须重启网关才能生效
#OpenClaw#飞书#踩坑记录#AI工具#配置文件
夜雨聆风