Feishu Message Recall
飞书消息撤回/删除工具——用于撤回或删除已发送的普通群消息和话题(Thread)消息,支持批量删除。
When to Use
Use this skill when:
- 需要删除自己误发的单条群消息时
- 需要批量删除话题(Thread)中的多条消息时
- 需要清理测试消息或历史垃圾消息时
- 需要查询话题中的消息列表以便选择性删除时
Do NOT use this skill if:
- 需要删除别人发送的消息 → 飞书 API 仅支持删除自己发送的消息
- 消息发送已超过 24 小时 → 可能无法撤回
- 需要撤回系统消息或机器人自动消息 → 权限可能受限
Typical triggers:
- 「撤回这条消息」「删除话题里的消息」
- "批量清理我刚才发的消息", "Recall the last Feishu message I sent"
Workflow
探查 (Probe) 确认消息 ID(
om_xxx)或话题 ID(omt_xxx),以及是否需要批量删除。约束 (Constrain) 只能删除自己发送的消息。超过 24 小时的消息可能无法删除。话题消息的删除权限与普通群消息相同。批量删除前建议先用
--list-thread查询话题中的消息列表。删除操作不可恢复,请谨慎执行。不降级——尝试删除别人的消息时报告权限错误。证据 (Evidence) 确认目标消息由当前应用/用户发送。批量删除前查询话题中的消息列表确认范围。
执行 (Execute)
# 删除单条消息
python3 skills/feishu-message-recall/scripts/recall.py --msg-id om_x100b5741b264fca0c12f636d26d1cdd
# 删除话题中的所有消息
python3 skills/feishu-message-recall/scripts/recall.py --thread-id omt_1ae2d7a2164f9ce5
# 查询话题中的消息
python3 skills/feishu-message-recall/scripts/recall.py --list-thread omt_xxx
验证 (Verify) 确认删除成功,返回成功/失败计数。检查消息是否已从群聊中移除。
交付 (Deliver) 返回操作结果摘要,清理临时文件。
Output
返回操作结果摘要,包含删除的消息数量、成功/失败计数和涉及的消息 ID 列表。
Guardrails
Anti-patterns
- NEVER 尝试删除别人发送的消息(飞书 API 不支持)
- Do NOT 在未查询话题消息列表的情况下批量删除
- Do NOT 对超过 24 小时的消息强行撤回(可能失败)
- 禁止删除操作后不验证(可能部分失败)
Constraints
- 只能删除自己发送的消息
- 超过 24 小时的消息可能无法删除
- 话题消息的删除权限与普通群消息相同
- 批量删除前建议先用
--list-thread查询话题中的消息列表 - 删除操作不可恢复,请谨慎执行
APP_ID和APP_SECRET从环境变量或config.py读取,需要 Python 3.8+ 和requests
API Limitations
APP_ID和APP_SECRET从环境变量或config.py读取- 需要 Python 3.8+ 和
requests - 飞书 API 仅支持删除自己发送的消息
- 超过 24 小时的消息可能无法撤回
Usage Examples
# 删除单条消息
python3 skills/feishu-message-recall/scripts/recall.py --msg-id om_xxx
# 删除话题中的所有消息
python3 skills/feishu-message-recall/scripts/recall.py --thread-id omt_xxx
# 查询话题中的消息
python3 skills/feishu-message-recall/scripts/recall.py --list-thread omt_xxx
Related Skills
- feishu-chat-monitor — 检查遗漏的 @提及
- feishu-group-welcome — 群聊欢迎消息管理
- feishu-chat-extractor — 提取和分析聊天记录
About UniqueClub
Part of the UniqueClub toolkit. 🌐 https://uniqueclub.ai