tg-media-resolve

Telegram Media Resolver 是一款专为解决 Telegram 消息中媒体占位符可视化问题设计的实用工具。当用户在群聊或引用消息中遇到 <media:image> 等无法直接查看的媒体标记时，该技能通过 Telegram Bot API 将占位符转换为可下载的本地文件，为后续的 AI 视觉分析或内容处理提供基础。

核心用法十分直观。用户首先需要从 OpenClaw 消息上下文中提取 chat_id 和 message_id 参数，随后读取配置的 Bot Token。通过调用 fetch_media.py 脚本并传入相应参数，工具会自动执行临时转发消息、下载媒体文件、清理转发痕迹的流程，最终返回本地文件路径供 image 工具或其他分析流程使用。

该技能的显著优点体现在多个维度。首先是零依赖架构，仅使用 Python 标准库实现，彻底杜绝了第三方依赖带来的供应链攻击风险。其次是安全性设计，代码中不存在 eval/exec 等危险函数，输入参数经过严格验证，文件操作具备完善的路径遍历防护。再者，隐私保护机制完善，临时转发的消息会在获取文件信息后自动删除，且所有网络请求仅连接 Telegram 官方服务器，不存在数据泄露给第三方的风险。此外，支持照片、文档、视频、语音、贴纸等全类型媒体，适用性广泛。

然而，该技能也存在一定局限性。最突出的是 20MB 文件大小限制，这是 Telegram Bot API 的硬性约束，无法绕过。其次，Bot 必须是目标群组的成员且具备访问权限，对于私有群组或历史消息可能存在访问障碍。虽然临时转发会被删除，但在操作瞬间仍可能在聊天中产生可见痕迹，对隐私极度敏感的场景需谨慎。此外，作为 T3 来源的社区项目，长期维护的稳定性相较于企业级产品存在不确定性。

该技能特别适合以下群体：Telegram 群组管理员需要批量分析群聊中的媒体内容；AI 助手开发者需要处理引用消息中的图像进行视觉理解；自动化工作流构建者希望将 Telegram 媒体集成到本地数据处理管道中。

使用过程中的风险主要包括：Bot Token 作为敏感凭证需要严格保管，一旦泄露可能导致机器人被恶意控制；临时转发机制虽短暂但存在隐私暴露风险，建议配合 --forward-to 参数使用私聊 ID 避免在公开群组产生痕迹；下载的临时文件默认存储在 /tmp 目录，需要注意磁盘空间管理和定期清理，防止敏感文件残留。