Read Feishu chat history and replies within discussion threads, search across conversations by keyword, sender, or time, and download attached images and files. Retrieve additional pages when a complete conversation is needed.
中文简介正在准备中。当前显示英语简介。
飞书 IM 消息读取工具使用指南，覆盖会话消息获取、话题回复读取、跨会话消息搜索、图片/文件资源下载。
**当以下情况时使用此 Skill**: (1) 需要获取群聊或单聊的历史消息 (2) 需要读取话题（thread）内的回复消息 (3) 需要跨会话搜索消息（按关键词、发送者、时间等条件） (4) 消息中包含图片、文件、音频、视频，需要下载 (5) 用户提到"聊天记录"、"消息"、"群里说了什么"、"话题回复"、"搜索消息"、"图片"、"文件下载" (6) 需要按时间范围过滤消息、分页获取更多消息
安装前可以查看交给 AI 代理的指令内容。
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" | - |
当用户没有明确指定时间范围时，根据用户意图推断合适的 relative_time，确保返回的消息能完整覆盖用户关心的内容。用户明确指定时间时直接使用用户的值。
page_size 范围 1-50，默认 50has_more=true 时，可使用 page_token 继续获取下一页获取历史消息时，返回的消息中如果包含 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 限制），只能通过分页获取。
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 和名字）。
消息内容中可能出现以下资源标记，用 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，不支持下载表情包、卡片中的资源。
feishu_im_user_get_messages 和 feishu_im_user_search_messages 支持时间过滤，话题消息不支持。
| 方式 | 参数 | 示例 |
|---|---|---|
| 相对时间 | relative_time | today、yesterday、this_week、last_3_days、last_24_hours |
| 精确时间 | start_time + end_time | ISO 8601 格式：2026-02-27T00:00:00+08:00 |
relative_time 和 start_time/end_time 互斥，不能同时使用today、yesterday、day_before_yesterday、this_week、last_week、this_month、last_month、last_{N}_{unit}（unit: minutes/hours/days）| 参数 | 格式 | 适用场景 |
|---|---|---|
| chat_id | oc_xxx | 已知会话 ID（群聊或单聊均可） |
| open_id | ou_xxx | 已知用户 ID，获取与该用户的单聊消息（自动解析为 chat_id） |
两者必须二选一，优先使用 chat_id。
步骤 1：获取群聊消息
{ "chat_id": "oc_xxx" }
步骤 2：返回的消息中发现 thread_id，展开话题最新回复：
{ "thread_id": "omt_xxx", "page_size": 10, "sort_rule": "create_time_desc" }
{ "query": "项目进度", "chat_id": "oc_xxx" }
第一次调用返回 has_more: true 和 page_token: "xxx"，继续获取：
{ "chat_id": "oc_xxx", "page_token": "xxx" }
{ "message_id": "om_xxx", "file_key": "img_v3_xxx", "type": "image" }
| 错误现象 | 根本原因 | 解决方案 |
|---|---|---|
| 消息结果太少 | 时间范围太窄或未传时间参数 | 根据用户意图推断合适的 relative_time |
| 消息不完整 | 没有检查 has_more 并翻页 | has_more=true 时用 page_token 翻页 |
| 话题讨论内容不完整 | 没有展开 thread_id | 发现 thread_id 时获取话题回复 |
| "open_id 和 chat_id 不能同时提供" | 同时传了两个参数 | 只传其中一个 |
| "relative_time 和 start_time/end_time 不能同时使用" | 时间参数冲突 | 选择一种时间过滤方式 |
| "未找到与 open_id=xxx 的单聊会话" | 没有单聊记录 | 改用 chat_id，或确认存在单聊 |
| 话题消息返回为空 | thread_id 格式不正确 | 确认为 omt_xxx 格式 |
| 图片/文件下载失败 | file_key 或 message_id 不匹配 | 确认 file_key 来自该 message_id |
| 权限不足 | 用户未授权或无权限 | 确认已完成 OAuth 授权且是会话成员 |
还没有评价。欢迎分享你的使用感受。
无需登录即可发表。欢迎分享使用感受、提问，或说明在哪些环境下无法运行。
还没有评论。来写第一条吧。
Use the ClawHub command-line tool to find and install agent skills, update them to the latest or a specified version, list installed skills, and publish skill folders with version numbers and change notes.
中文简介正在准备中。当前显示英语简介。
Delegate feature development, code refactoring, and pull request reviews to Codex, Claude Code, Pi, or OpenCode. It guides background execution, progress monitoring, and parallel work in separate working directories.
中文简介正在准备中。当前显示英语简介。
Investigate Nexu production issues through the Datadog Logs API. Search crash events, error output, startup activity, and API failures, then summarize findings by time, running instance, and deployed version to help trace related events.
中文简介正在准备中。当前显示英语简介。
Turn a broad research topic into a structured report with traceable sources. The workflow defines questions, prioritizes authoritative material, separates facts from assumptions, compares evidence, and uses an independent agent to check key data and reasoning.
中文简介正在准备中。当前显示英语简介。
Send bug reports, suggestions, or other feedback to the Nexu team using `/feedback`. The submission script automatically includes conversation history and images, then reports whether the feedback was successfully forwarded.
中文简介正在准备中。当前显示英语简介。
Create and manage Feishu Bitable tables for work such as customer tracking. Add, search, update, or delete records, configure columns using 27 field types, filter and sort data, and manage views or batch imports.
中文简介正在准备中。当前显示英语简介。