Setup & Installation
Or with the ClawHub CLI, for registry-managed skill folders outside a full OpenClaw workspace:
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
Here's how your AI assistant might use this skill in practice.
User asks: 'What does the image in that replied message show?'
- 1Extract chat_id and message_id from the message context format [id:CHAT_ID] [id:MSG_ID]
- 2Read bot token from ~/.openclaw/openclaw.json
- 3Run fetch_media.py with --bot-token, --chat-id, --message-id, and --forward-to a private DM chat
- 4Receive local file path of the downloaded image
- 5Pass file path to the image tool for vision analysis
Description of the image content from the downloaded file
Requirements
Accounts, API keys, or tools you or your AI assistant may need to set up while using this skill.