OpenClaw2026.3.1更新要点及飞书特殊处理
OpenClaw 2026.3.1版本更新,与飞书相关的新增功能包括文档表格操作、文件上传、消息反应感知等,并修复了媒体附件发送、群组会话路由等多项Bug。更新后需注意处理旧插件路径,通过npm update -g openclaw升级后,飞书功能恢复正常运行。解决插件重复的问题。
·
日常高频使用飞书,总感觉该收到消息的时候,就是没收到,又懒得查日志。
今天看到OpenClaw更新了2026.3.1版本。赶紧看看更新了哪些,有没有更新跟飞书有关的。果然很多,火速更新。
更新OpenClaw
OpenClaw升级后OpenClaw和飞书“未建立有效的长链接“的问题修复过程
上次更新后飞书不可用,这次更新前特意确认了下,我的飞书插件保存在
~/.openclaw/extensions/feishu
更新OpenClaw用的命令是
npm update -g openclaw
安装更新之后,在~/.npm-global/lib/node_modules/openclaw/extensions又出现了飞书插件。果然飞书插件重复的问题又来了。
确认OpenClaw版本
openclaw gateway status
检查飞书插件的版本
openclaw plugins list
# feishu plugin 版本是2026.3.1
因为上次升级OpenClaw2026.2.26时,不能用飞书,只好安装了我之前安装了openclaw plugins install @m1heng-clawd/feishu,而这次生效的是OpenClaw默认安装的插件,而不是通过openclaw plugins install xxx的插件。让我有点意外。


解决飞书插件重复问题
以防万一,我将~/.openclaw/extension/feishu移动到别的目录。
cd ~/.openclaw/extensions
mv feishu/ ~/
openclaw gateway restart
一切正常。
本次更新关于飞书的新功能
| 功能 | 说明 | PR |
|---|---|---|
| 文档表格操作 | 新增 feishu_doc 表格创建/写入:create_table、write_table_cells、create_table_with_values |
#20304 |
| 文档上传 | 新增图片/文件上传:upload_image、upload_file |
#20304 |
| 消息反应 | 支持接收 im.message.reaction.created_v1 事件,当用户对消息添加表情反应时,Agent 可以感知 |
#16716 |
| 聊天查询 | 新增 feishu_chat 工具,支持获取聊天信息和成员列表,可通过 channels.feishu.tools.chat 配置启用 |
#14674 |
| 文档权限 | 创建文档时支持可选的 owner 权限授予字段 | #28295 |
Bug 修复
| 问题 | 修复内容 | PR |
|---|---|---|
| 回复媒体附件丢失 | 之前回复消息时,mediaUrl/mediaUrls 媒体附件不会发送。现在会正确将媒体作为附件发送 |
#28959 |
| DM/群组路由误判 | 之前假设所有 oc_ 开头的 ID 都是群聊,导致 DM 被错误路由到群组会话。现在支持显式的 dm:/group: 前缀,默认按 DM 路由 |
#10407 |
| 群组会话隔离 | 新增群组会话范围配置 (group, group_sender, group_topic, group_topic_sender),可按发送者/主题隔离会话 |
#17798 |
| 回复进线程 | 新增 replyInThread 配置,群组回复可以自动进入线程,保持会话连续性 |
#27325 |
| 机器人状态缓存 | 探测飞书机器人信息时缓存 10 分钟,减少重复 API 调用 | #28907 |
| Opus 音频发送 | .opus 附件现在用 msg_type: "audio" 发送(之前错误用 "media"),语音消息能正确送达 |
#28269 |
| 移动端视频接收 | 修复移动端发送的视频消息无法正确解析的问题,message_type: "media" 现在视为视频 |
#25502 |
| 发送者 ID 回退 | 当 sender_id.open_id 缺失时,回退到 sender_id.user_id,确保移动端消息的发送者身份正确 |
#26703 |
对我的实际影响
- 语音消息 - 之前可能有问题的
.opus语音,现在能正常发送 - DM 回复 - 之前如果用
oc_xxxID 发 DM,可能被误判为群聊,现在修复 - 消息反应 - 可以感知用户对消息的表情反应(如果你需要这个功能)
- 文档操作 - 可以创建表格和上传图片/文件到飞书文档
更多推荐

所有评论(0)