← 返回 Skills 市场
kurinzo

Telegram Media Resolver

作者 kurinzo · GitHub ↗ · v1.0.0
cross-platform ⚠ suspicious
1037
总下载
0
收藏
1
当前安装
1
版本数
在 OpenClaw 中安装
/install tg-media-resolve
功能描述
Resolve Telegram <media:image>, <media:document>, <media:video> and other media placeholders into actual files for vision/analysis. Use when a Telegram message contains a media placeholder (e.g. <media:image>) that you cannot see — typically in quoted/replied-to messages or group chat history. Downloads the media via Telegram Bot API and returns a local file path for the image tool or further processing.
安全使用建议
This skill appears to do what it says (download media via the Telegram Bot API), but the documentation instructs the agent to read a local OpenClaw config (~/.openclaw/openclaw.json) to obtain the bot token while the skill metadata declares no required credentials — that mismatch is the main red flag. Before installing or using it: 1) ask the publisher to update the metadata to declare the Telegram bot token as a required credential (or remove the instruction to read the local config); 2) avoid letting the agent automatically read your OpenClaw config—prefer passing the bot token explicitly via a secure input or env var scoped to this skill; 3) review the included script (scripts/fetch_media.py) yourself — it is short and readable and only talks to api.telegram.org — and run it in an isolated environment if you must test; 4) ensure the bot token you provide has minimal permissions (use a dedicated bot) and that the bot is a member of the target chat; and 5) be aware forwarding may briefly appear in chats. If the publisher cannot justify the undeclared config access, treat the skill with caution or refuse to install it.
功能分析
Type: OpenClaw Skill Name: tg-media-resolve Version: 1.0.0 The skill is designed to resolve Telegram media placeholders by downloading files via the Telegram Bot API. It requires reading the `botToken` from the OpenClaw configuration (`~/.openclaw/openclaw.json`) as instructed in `SKILL.md`, and the `scripts/fetch_media.py` script uses this token to interact with `api.telegram.org` and download files to a specified output directory (defaulting to `/tmp`). While this involves network access, file system writes, and handling a sensitive API token, these actions are directly necessary and aligned with the skill's stated purpose. There is no evidence of intentional harmful behavior such as unauthorized data exfiltration, persistence mechanisms, or broader prompt injection attempts beyond retrieving the required token for its function.
能力评估
Purpose & Capability
The name/description, the runtime script (scripts/fetch_media.py), and the documented workflow align: the tool forwards a message, extracts file_id, downloads from api.telegram.org, and returns a local path. A Telegram bot token and chat/message IDs are legitimately required for this functionality.
Instruction Scope
SKILL.md instructs the agent to read the bot token from ~/.openclaw/openclaw.json using a shell pipeline, which accesses a specific local config path that is not declared anywhere in the skill metadata. The instructions also recommend temporarily forwarding messages (which may be visible) and to use a private DM for cleanup; these are operational notes but expand the scope to interacting with chat history and potentially visible forwards. The explicit local file read is the primary scope creep.
Install Mechanism
No install spec or remote downloads are present; the skill is instruction+one Python script included in the bundle. This is low-risk from an installation perspective (nothing fetched from arbitrary URLs).
Credentials
The metadata declares no required environment variables or credentials, but both the script and usage require a Telegram Bot API token. SKILL.md suggests reading the token from an OpenClaw config file (~/.openclaw/openclaw.json), which is a sensitive local credential access that the skill metadata does not declare or justify. The skill should explicitly declare the bot token requirement and/or avoid instructing the agent to read an undeclared config file.
Persistence & Privilege
always:false (default) and model invocation is allowed (normal). The skill does not request persistent system-wide privileges or modification of other skills. No evidence it writes persistent credentials or modifies other skills' config.
如何使用
  1. 确保已安装 OpenClaw(本地或 Docker 部署)
  2. 在对话框中输入安装命令:/install tg-media-resolve
  3. 安装完成后,直接呼叫该 Skill 的名称或使用 /tg-media-resolve 触发
  4. 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
版本历史
v1.0.0
Initial release: resolve <media:image/document/video> placeholders from Telegram messages via Bot API
元数据
Slug tg-media-resolve
版本 1.0.0
许可证
累计安装 1
当前安装数 1
历史版本数 1
常见问题

Telegram Media Resolver 是什么?

Resolve Telegram <media:image>, <media:document>, <media:video> and other media placeholders into actual files for vision/analysis. Use when a Telegram message contains a media placeholder (e.g. <media:image>) that you cannot see — typically in quoted/replied-to messages or group chat history. Downloads the media via Telegram Bot API and returns a local file path for the image tool or further processing. 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 1037 次。

如何安装 Telegram Media Resolver?

在 OpenClaw 或 Claude Code 对话框中运行命令「/install tg-media-resolve」即可一键安装,无需额外配置。

Telegram Media Resolver 是免费的吗?

是的,Telegram Media Resolver 完全免费(开源免费),可自由下载、安装和使用。

Telegram Media Resolver 支持哪些平台?

Telegram Media Resolver 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(cross-platform)。

谁开发了 Telegram Media Resolver?

由 kurinzo(@kurinzo)开发并维护,当前版本 v1.0.0。

💬 留言讨论