feishu-im-read
飞书 IM 消息读取工具使用指南，覆盖会话消息获取、话题回复读取、跨会话消息搜索、图片/文件资源下载。 **当以下情况时使用此 Skill**: (1) 需要获取群聊或单聊的历史消息 (2) 需要读取话题（thread）内的回复消息 (3) 需要跨会话搜索消息（按关键词、发送者、时间等条件） (4) 消息中包含图片、文件、音频、视频，需要下载 (5) 用户提到"聊天记录"、"消息"、"群里说了什么"、"话题回复"、"搜索消息"、"图片"、"文件下载" (6) 需要按时间范围过滤消息、分页获取更多消息
Install via CLI (Recommended)
clawhub install openclaw/skills/skills/a3152557994-ship-it/feishu-im-read飞书 IM 消息读取
执行前必读
- 该 Skill 中的所有消息读取工具均以用户身份调用，只能读取用户有权限的会话
feishu_im_user_get_messages中open_id和chat_id必须二选一- 消息中出现
thread_id时，根据用户意图判断是否用feishu_im_user_get_thread_messages读取话题内回复 - 以用户身份读取后，如果消息内容中出现资源标记时，用
feishu_im_user_fetch_resource下载，需要message_id+file_key+type
快速索引：意图 → 工具
| 用户意图 | 工具 | 必填参数 | 常用可选 |
|---|---|---|---|
| 获取群聊/单聊历史消息 | feishu_im_user_get_messages | chat_id 或 open_id（二选一） | relative_time, start_time/end_time, page_size, sort_rule |
| 获取话题内回复消息 | feishu_im_user_get_thread_messages | thread_id（omt_xxx） | page_size, sort_rule |
| 跨会话搜索消息 | feishu_im_user_search_messages | 至少一个过滤条件 | query, sender_ids, chat_id, relative_time, start_time/end_time, page_size |
| 下载消息中的图片 | feishu_im_user_fetch_resource | message_id, file_key（img_xxx）, type="image" | - |
| 下载消息中的文件/音频/视频 | feishu_im_user_fetch_resource | message_id, file_key（file_xxx）, type="file" | - |
核心约束
1. 时间范围：确保消息覆盖完整
当用户没有明确指定时间范围时，根据用户意图推断合适的 relative_time，确保返回的消息能完整覆盖用户关心的内容。用户明确指定时间时直接使用用户的值。
2. 分页：根据需要翻页获取更多结果
page_size范围 1-50，默认 50- 返回结果中
has_more=true时，可使用page_token继续获取下一页 - 根据用户需求判断是否需要翻页：需要完整结果时继续翻页，浏览概览时第一页通常够用
3. 话题回复：主动展开话题获取上下文
获取历史消息时，返回的消息中如果包含 thread_id 字段，推荐主动获取话题的最新 10 条回复（page_size: 10, sort_rule: "create_time_desc"）以提供更完整的上下文。
| 场景 | 行为 |
|---|---|
| 获取历史消息并需要理解上下文（默认） | 对发现的 thread_id 调用 feishu_im_user_get_thread_messages 获取最新 10 条回复 |
| 用户要求"完整对话"、"详细讨论"、"看看回复" | 获取话题全部回复（page_size: 50, sort_rule: "create_time_asc"），需要时翻页 |
| 用户只浏览消息概览 / 用户明确说不看回复 | 跳过话题展开 |
注意：话题消息不支持时间过滤（飞书 API 限制），只能通过分页获取。
4. 跨会话消息搜索
feishu_im_user_search_messages 支持跨所有会话搜索消息：
| 参数 | 说明 |
|---|---|
query | 搜索关键词，匹配消息内容 |
sender_ids | 发送者 open_id 列表 |
chat_id | 限定搜索范围的会话 ID |
mention_ids | 被@用户的 open_id 列表 |
message_type | 消息类型：file / image / media |
sender_type | 发送者类型：user / bot / all（默认 user） |
chat_type | 会话类型：group / p2p |
搜索结果每条消息额外包含 chat_id、chat_type（p2p/group）、chat_name。单聊消息还有 chat_partner（对方 open_id 和名字）。
5. 图片/文件/媒体资源的提取
消息内容中可能出现以下资源标记，用 feishu_im_user_fetch_resource 下载：
| 资源类型 | 内容中的标记格式 | fetch_resource 参数 |
|---|---|---|
| 图片 |  | message_id=om_xxx, file_key=img_xxx, type="image" |
| 文件 | <file key="file_xxx" .../> | message_id=om_xxx, file_key=file_xxx, type="file" |
| 音频 | <audio key="file_xxx" .../> | message_id=om_xxx, file_key=file_xxx, type="file" |
| 视频 | <video key="file_xxx" .../> | message_id=om_xxx, file_key=file_xxx, type="file" |
从消息的 message_id 字段和内容中的 file_key 组合即可调用 fetch_resource。
注意：文件大小限制 100MB，不支持下载表情包、卡片中的资源。
6. 时间过滤
feishu_im_user_get_messages 和 feishu_im_user_search_messages 支持时间过滤，话题消息不支持。
Metadata
Not sure this is the right skill?
Describe what you want to build — we'll match you to the best skill from 16,000+ options.
Find the right skillPaste this into your clawhub.json to enable this plugin.
{
"plugins": {
"official-a3152557994-ship-it-feishu-im-read": {
"enabled": true,
"auto_update": true
}
}
}Related Skills
feishu-fetch-doc
获取飞书云文档内容。返回文档的 Markdown 内容，支持处理文档中的图片、文件和画板（需配合 feishu_doc_media 工具）。
feishu-bitable
飞书多维表格（Bitable）的创建、查询、编辑和管理工具。包含 27 种字段类型支持、高级筛选、批量操作和视图管理。 **当以下情况时使用此 Skill**： (1) 需要创建或管理飞书多维表格 App (2) 需要在多维表格中新增、查询、修改、删除记录（行数据） (3) 需要管理字段（列）、视图、数据表 (4) 用户提到"多维表格"、"bitable"、"数据表"、"记录"、"字段" (5) 需要批量导入数据或批量更新多维表格
feishu-calendar
飞书日历与日程管理工具集。包含日历管理、日程管理、参会人管理、忙闲查询。
Lobster Config
Skill by a3152557994-ship-it
feishu-create-doc
创建飞书云文档。从 Lark-flavored Markdown 内容创建新的飞书云文档，支持指定创建位置（文件夹/知识库/知识空间）。