核心用法
tg-media-resolve 是一个专门解决 Telegram 消息中媒体占位符（如 <media:image>、<media:document>、<media:video> 等）的工具。当AI助手在引用消息或群聊历史中遇到无法直接查看的媒体标记时，该工具通过 Telegram Bot API 临时转发目标消息，获取文件元数据并下载到本地，最终返回可供 image 工具或 exec 处理的本地文件路径。
使用流程：从消息上下文中提取 chat_id 和 message_id → 读取 OpenClaw 配置中的 Bot Token → 执行 fetch_media.py 脚本 → 获得本地文件路径 → 配合视觉工具分析内容。
显著优点
1. 无缝集成：专为 OpenClaw/Telegram 场景设计，自动处理消息格式解析
2. 多格式支持：覆盖图片、文档、视频、GIF、贴纸、语音、视频笔记等全类型媒体
3. 隐私可控：支持 --forward-to 参数指定私有聊天，避免在公开群组中产生可见转发痕迹
4. 自动清理：下载完成后删除临时转发消息，减少数据残留
潜在局限
- 成员权限依赖：Bot 必须是目标聊天室的成员才能访问消息
- 文件大小限制：Telegram Bot API 限制无法下载超过 20MB 的文件
- 临时可见性：转发操作在清理前可能短暂可见（可通过私聊转发缓解）
- 令牌安全：需要读取 Bot Token，存在凭证泄露风险
适合人群
- 使用 OpenClaw 框架的 Telegram 机器人开发者
- 需要分析群聊媒体内容的 AI 助手运维人员
- 重视隐私控制、希望避免公开转发的企业用户
常规风险
| 风险类型 | 说明 | 缓解建议 |
|---------|------|---------|
| 凭证泄露 | Bot Token 被脚本日志或进程暴露 | 使用环境变量传递，避免硬编码 |
| 隐私泄露 | 敏感媒体被转发到非预期聊天 | 始终配置 `--forward-to` 为私聊 |
| 滥用下载 | 大文件或恶意文件导致资源耗尽 | 限制文件大小，设置超时机制 |
| 权限提升 | Bot 被加入未授权群组获取敏感信息 | 严格管控 Bot 的群组加入权限 |
总体评估
该工具在特定生态内功能完整，但设计上的临时转发机制和文件大小限制意味着它更适合中小型媒体文件的辅助分析，而非大规模数据提取场景。