Skip to content
TakoAPI
Back to skills

tg-media-resolve

by kurinzo

Coding Agents & IDEs
743Downloads reported by clawskills.sh
0Views
0 likesSign in to like this skill
—Not yet rated
Your rating

Brief

Resolve Telegram <media:image>, <media:document>, <media:video> and other media placeholders into actual files.

Description

What This Skill Does

Resolves Telegram media placeholders like `<media:image>` or `<media:video>` into actual downloaded files. When a Telegram message contains a media reference the agent cannot directly see, this skill uses the Bot API to forward, download, and clean up the file. Returns a local file path ready for vision analysis or further processing.

Directly bridges the gap between opaque media placeholders in Telegram message context and usable local files, without requiring manual download steps.

When to Use It

  • Analyzing an image shared in a Telegram group chat
  • Reading a document sent as a reply in a bot conversation
  • Inspecting a video or GIF from a forwarded Telegram message
  • Running OCR on a photo referenced in group history
  • Processing voice messages or stickers from Telegram chats

Example Workflow

INPUT

User asks: 'What does the image in that replied message show?'

AGENT
  1. 1

    Extract chat_id and message_id from the message context format [id:CHAT_ID] [id:MSG_ID]

  2. 2

    Read bot token from ~/.openclaw/openclaw.json

  3. 3

    Run fetch_media.py with --bot-token, --chat-id, --message-id, and --forward-to a private DM chat

  4. 4

    Receive local file path of the downloaded image

  5. 5

    Pass file path to the image tool for vision analysis

OUTPUT

Description of the image content from the downloaded file

Requirements

  • Telegram Bot API token (configured in OpenClaw as channels.telegram.botToken)
  • Telegram bot must be a member of the target chat

Installation

clawhub install kurinzo/tg-media-resolve

Run the CLI command, or paste the prompt into Claude Code, Cursor, Codex or whichever coding agent you use.

Links