OpenClaw 可接收和发送的飞书消息类型、贴纸支持与线程感知回复¶
读取消息与聊天信息¶
官方通过 npm 或 ClawHub 安装的飞书插件,与内置插件使用相同的飞书访问检查,用于消息读取、回应和置顶列表、聊天和成员信息、目录列表以及已配置的贴纸搜索。现有的账户、操作和访问控制仍然适用。直聊成员查询仍限于当前发送者,目录结果仍按已配置的策略进行过滤。
对于实时对等方查询,channel-list 操作会将 query 与各提供方页面中的用户 ID 和名称进行匹配。limit 适用于匹配的对等方,默认为 50。如果分页无法在 100 页内完成,或提供方返回无效的续传令牌,该操作会报告查找失败。
来自已安装插件的委托读取需要当前的飞书账户和会话上下文。终止发起操作或停用插件会阻止后续的提供方请求,并拒绝迟到的结果。已经发送给飞书的请求无法撤销。
支持的消息类型¶
接收¶
- ✅ 文本
- ✅ 富文本(post)
- ✅ 图片
- ✅ 文件
- ✅ 音频
- ✅ 视频/媒体
- ✅ 贴纸
接收到的贴纸会将其可复用的 file_key 以 <sticker key="..."/> 形式提供给代理。飞书/Lark 不支持下载贴纸资源,因此 OpenClaw 会保留该键而不获取附件。
带有说明文字(caption)发送的文件,或一条消息中的多个文件,会以富文本 post 形式到达,并带有顶层 files[] 数组。OpenClaw 会通过与独立 file 消息相同的入站附件路径下载这些文件。
入站的飞书/Lark 音频消息会被规范化为媒体占位符,而不是原始 file_key JSON。当配置了 tools.media.audio 时,OpenClaw 会下载语音留言资源,并在代理轮次之前运行共享音频转录,因此代理会收到语音转写文本。如果飞书直接在音频负载中包含转写文本,则直接使用该文本,无需再次调用 ASR。如果没有音频转录提供方,代理仍会收到 <media:audio> 占位符以及保存的附件,而不是原始的飞书资源负载。
发送¶
- ✅ 文本
- ✅ 图片
- ✅ 文件
- ✅ 音频
- ✅ 视频/媒体
- ✅ 交互卡片(包括流式更新)
- ✅ 同一机器人先前收到的贴纸(需要
actions.sticker) - ⚠️ 富文本(post 风格格式;不支持完整的飞书/Lark 编辑能力)
原生飞书/Lark 音频气泡使用飞书 audio 消息类型,并要求以 Ogg/Opus 上传媒体(file_type: "opus")。现有的 .opus 和 .ogg 媒体会以原生音频形式直接发送。MP3/WAV/M4A 及其他可能的音频格式只有在回复请求语音投递(audioAsVoice / 消息工具 asVoice,包括 TTS 语音留言回复)时,才会通过 ffmpeg 转码为 48kHz Ogg/Opus。普通 MP3 附件仍作为普通文件。如果缺少 ffmpeg 或转换失败,OpenClaw 会回退为文件附件并记录原因。
贴纸回复¶
启用贴纸操作,让代理可以重新发送贴纸:
如果只针对一个账户,则改为设置 channels.feishu.accounts.<id>.actions.sticker: true。账户级别的 actions 对象会替换而非合并频道级别的对象。请重复设置任何你想保留的操作开关。例如,在为 work 启用贴纸的同时保持回应禁用:
{
channels: {
feishu: {
actions: { reactions: false },
accounts: {
work: {
actions: { reactions: false, sticker: true },
},
},
},
},
}
先把贴纸发送给该机器人,然后要求它重新发送该贴纸。共享的 message 工具使用 action: "sticker",并将接收到的 file_key 放在 fileId 或 stickerId 的第一个条目中。在多账户设置中,请使用与接收贴纸相同的 accountId。
只能发送该机器人先前接收到的贴纸。不支持上传新贴纸、下载贴纸资源以及搜索贴纸商店。
贴纸关键词搜索¶
添加一套精选贴纸,让代理能够按关键词找到已接收的贴纸。先将每个贴纸发送给机器人,并向其索要接收到的 file_key。然后将键和你自己的标签添加到现有飞书配置中:
{
channels: {
feishu: {
actions: { sticker: true },
stickerSets: {
cli_work: {
file_received_key: ["thumbs up", "赞", "👍"],
},
},
},
},
}
将 cli_work 替换为机器人的实际应用 ID,并将 file_received_key 替换为该机器人收到的键。stickerSets 直接位于 channels.feishu 之下,而不是在账户内部。所选账户只能搜索与其应用 ID 匹配的贴纸集;将账户切换到不同机器人不会复用先前机器人的贴纸集。使用同一机器人的账户共享该贴纸集。按上文所述保留任何现有的账户级操作开关。
让代理“发送一个大拇指贴纸”。它可以使用共享的 message 工具,带上 action: "sticker-search"、query: "thumbs up" 以及预期的 accountId,然后在同一账户上使用 action: "sticker" 发送返回的 fileId。仅在启用贴纸且机器人配置了非空贴纸集时,搜索才可用。
搜索会在贴纸键顺序中,对显式关键词进行不区分大小写的子串匹配,包括中文标签和表情符号。它不会推断贴纸的含义、搜索飞书商店,也不会自动收集已接收的贴纸。结果包含匹配的 keyword 和可复用的 fileId。如果没有匹配项,则返回空列表;truncated: true 表示匹配条目因结果限制或输出预算而被省略。请缩小查询范围以查找其他匹配项。
限制:32 个机器人贴纸集,每个贴纸集 256 个贴纸,每个贴纸 1–8 个关键词。存储关键词时不要包含前导或尾随空白;每个关键词必须非空且最多 64 个 Unicode 字符。文件键必须是规范化的已接收键,最多 512 个 Unicode 字符。每个键在其机器人的映射中只出现一次。查询必须非空且最多 128 个 Unicode 字符。limit 默认为 5,可接受 1 到 10 的整数;搜索结果也限制为 3 KiB 的 JSON 输出。移除贴纸集会将其从搜索中移除;不会创建单独的贴纸数据库或缓存。
线程与回复¶
- ✅ 内联回复
- ✅ 线程回复
- ✅ 媒体回复在回复线程消息时保持线程感知
主题组会话路由在 群组会话作用域和主题线程中介绍。
本页原文 Markdown:在 AtomGit 查看·内容源自开源项目 cl/openclaw