A utility for AI agents to resolve Telegram media placeholders into downloadable files for vision and data analysis.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install tg-media-resolve
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install tg-media-resolve using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is Telegram Media Resolver?
The Telegram Media Resolver is a specialized tool designed to bridge the gap between Telegram's messaging interface and AI vision capabilities. When working with Telegram messages within the Openclaw Skills ecosystem, agents often encounter placeholders like media:image or media:video instead of raw binary data. This skill enables agents to programmatically fetch the underlying files by interacting with the Telegram Bot API, facilitating deeper content analysis.
By automating the process of forwarding, metadata retrieval, and downloading, it ensures that your AI agents have the context they need to process visual and audio information accurately. This is particularly useful in complex chat histories where media is nested in replies or group contexts that the agent cannot natively see without explicit resolution.
Telegram Media Resolver Use Cases
- Analyzing images or documents sent within Telegram group chats or private messages.
- Processing replied-to messages where media is referenced via placeholders.
- Converting voice messages or video notes into local files for transcription or analysis tools.
- Automating media backup and categorization within an Openclaw Skills workflow.
How Telegram Media Resolver Works
- The agent identifies a media placeholder (e.g., media:image) in a Telegram message context.
- It extracts the message ID and chat ID provided by the OpenClaw message format.
- The skill triggers a temporary message forward via the Telegram Bot API to retrieve file metadata.
- The file is downloaded from Telegram servers to a local directory (typically /tmp).
- The temporary forward is immediately deleted to maintain privacy and chat hygiene.
- The local file path is returned to the agent for use with vision models or other processing tools.
Telegram Media Resolver Setup
To configure this skill within your Openclaw Skills environment, ensure you have your Telegram Bot Token available in your configuration file. Use the following steps:
- Extract your Bot Token from your configuration:
cat ~/.openclaw/openclaw.json | python3 -c "import sys,json; print(json.load(sys.stdin)['channels']['telegram']['botToken'])"
- Run the fetch script with the necessary parameters:
python3 scripts/fetch_media.py \
--bot-token "$BOT_TOKEN" \
--chat-id CHAT_ID \
--message-id MESSAGE_ID \
--out /tmp
- Note: Ensure your bot is a member of the target chat to access the media.
Telegram Media Resolver Data Schema & Taxonomy
The skill uses standard Telegram Bot API structures and OpenClaw message context to organize data.
| Parameter | Description | Source |
|---|---|---|
| chat-id | Unique identifier for the chat | Extracted from [id:CHAT_ID] |
| message-id | Unique identifier for the message | Extracted from [id:MSG_ID] |
| out | Destination directory | Default is /tmp |
| file_path | Local path to the resolved asset | Returned as script output |
Telegram Media Resolver Advanced Features
- Support for diverse media types including stickers, animations, voice messages, and video notes.
- Private forwarding using the --forward-to flag to prevent visible activity in public groups.
- Automatic cleanup logic that deletes temporary forwards after metadata retrieval.
- Direct integration compatibility with vision-based Openclaw Skills for automated image labeling and analysis.
SKILL.md
Loading
Related Openclaw Skills
Da Ai Xian Zun Persona
A ruthless and calculating persona for AI agents based on the 500-year-reincarnated immortal Gu Yue Fang Yuan.
Upbit Market Data Skill
A high-performance CLI skill for fetching real-time cryptocurrency market data and historical candles from the Upbit exchange.
Trading Upbit Skill
A professional-grade automated trading bot for Upbit designed to execute aggressive breakout strategies through scheduled cron tasks.
Uptime Monitor
A persistent monitoring sentinel that tracks agent availability and logs continuous uptime streaks or downtime events every five minutes.
Aerobase Activities & Tours
A specialized AI agent skill for discovering and booking tours, attractions, and layover activities near airports globally.
Aerobase Flight Alerts
A real-time flight operations center that monitors delays, contextualizes impact, and automates recovery for travelers.
Featured*
