核心用法
Feishu Interactive Card Fetcher 是一个用于获取飞书消息内容的工具，主要通过 message_id 调用飞书 IM API 获取消息详情。
主要功能
- 单条消息获取：通过
python3 scripts/fetch_message.py <message_id>获取指定消息 - 话题上下文获取：添加
--thread参数获取整个话题链（根消息及所有回复） - 原始响应输出：使用
--raw获取未处理的 API 原始响应
显著优点
1. 自动化认证：自动读取 ~/.openclaw/openclaw.json 中的 appId/appSecret，或支持环境变量/命令行参数传递 token
2. 结构化输出：返回 JSON 格式，包含 message_id、msg_type、sender_id、chat_id、content 等关键字段
3. 话题上下文补齐：针对交互卡片无法获取完整内容的限制，通过话题上下文获取上游文本/富文本消息
4. 多消息类型支持：支持 text、post、interactive、image、merge_forward 等飞书消息类型
潜在缺点与局限性
1. 交互卡片内容限制：飞书平台 API 本身限制，/im/v1/messages/{id} 只能返回交互卡片的降级文本（fallback），无法获取完整卡片 JSON 结构。这是平台级限制，非工具缺陷
2. 依赖外部配置：需要预先配置飞书应用凭证，无法独立运行
3. Python 环境依赖：需要本地 Python 3 环境及依赖库
适合人群
- 需要处理飞书机器人/应用接收到的交互卡片消息的开发者
- 需要追溯话题上下文进行内容分析的场景
- 需要自动化获取飞书消息元数据的运维/开发人员
常规风险
- 凭证泄露风险：
openclaw.json包含敏感应用凭证，需确保文件权限安全 - API 限流风险：高频调用可能触发飞书 API 频率限制
- 隐私合规风险：获取的消息内容可能包含敏感信息，需遵守数据安全规范