核心用法
feishu-forward-reader 专用于解析飞书「合并转发消息」（merge_forward），解决 OpenClaw 等平台收到转发消息时仅显示 "Merged and Forwarded Message" 占位文本、无法查看实际内容的问题。
主要功能
- 完整消息还原：通过飞书 Open API 获取转发消息包含的全部子消息列表
- 多消息类型支持：覆盖 text（文本）、post（富文本）、interactive（卡片）、image（图片）、file（文件）、audio（语音）、video（视频）等类型
- 用户身份识别：可选调用用户接口，将发送者 ID 解析为真实姓名（需
contact:contact.base:readonly权限） - 灵活调用方式：提供 Python 脚本（推荐）、Shell 脚本、直接 API 调用三种接入方案
显著优点
1. 填补平台能力缺口：飞书官方客户端的合并转发功能在第三方集成场景中常丢失内容，此 skill 完整还原对话上下文
2. 结构化输出：支持 JSON 与可读文本两种格式，便于二次处理或人工阅读
3. 性能优化选项：--no-names 模式跳过用户查询，减少 API 调用次数
4. 清晰的层级关系：通过 upper_message_id 标识父子消息关系，便于追溯消息来源
潜在缺点与局限性
- 敏感权限依赖：必须申请
im:message:readonly权限，该权限可读取群组全部历史消息，权限范围较宽 - 企业级门槛：需配置飞书自建应用（app_id/app_secret），个人用户无法直接使用
- 可见性限制：非应用可见范围内的用户显示 ID 前缀而非真实姓名
- 无实时推送：仅支持被动查询，不支持消息实时订阅
适合人群
- 需要将飞书聊天记录同步至其他系统（如 CRM、工单系统）的企业开发者
- 使用 OpenClaw 等平台处理飞书消息但遇到转发消息解析失败的运维人员
- 需批量归档或审计群聊记录的合规团队
常规风险
- 数据泄露风险：
im:message:readonly权限可获取可见群组全部历史消息，需严格管控应用可见范围 - API 配额消耗：频繁调用可能触发飞书 API 频次限制
- Token 安全管理：tenant_access_token 需妥善保管，避免硬编码泄露