An AI agent skill designed to send rich media, including technical analysis charts and ElevenLabs voice notes, directly to Telegram.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install telegram-media
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 telegram-media 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?
The Telegram Media skill is a specialized extension for AI agents that enables the transmission of complex media types beyond simple text. By integrating this Openclaw Skills package, agents can provide visual technical analysis, system documents, and high-fidelity voice messages to users. It prioritizes technical accuracy and real-world execution, ensuring that every media asset is successfully processed and delivered through the Telegram Bot API before the agent confirms the action.
This skill is particularly valuable for developers building automated trading assistants, reporting bots, or interactive AI personalities. It leverages Python-based automation to bridge the gap between local data generation (like financial charting) and mobile-first communication, making it a cornerstone for sophisticated Openclaw Skills deployments.
Telegram Media Use Cases
- Delivering automated technical analysis charts (BTC, ETH, etc.) upon user request.
- Converting text responses into natural-sounding voice notes using ElevenLabs TTS.
- Sending generated PDF reports, logs, or system files directly to a mobile device.
- Providing visual confirmation of agent tasks through photos and screenshots.
How Telegram Media Works
- The AI agent identifies a request for media delivery or generation.
- Environment variables are initialized via a configuration loader to access Telegram and ElevenLabs credentials.
- If a chart is requested, a local Python script generates updated PNG files with technical indicators like RSI and Fibonacci levels.
- For voice requests, the agent sends text to the ElevenLabs API to produce a high-quality audio file.
- The agent executes a shell command to post the media file to the Telegram Bot API using a specific chat ID.
- The response from the API is captured and verified to ensure the message was delivered successfully.
Telegram Media Setup
Ensure your environment is configured in ~/clawd with a .env file containing your credentials.
# Required environment variables
TELEGRAM_TOKEN="your_bot_token"
TELEGRAM_CHAT_ID="your_chat_id"
ELEVEN_API_KEY="your_elevenlabs_key"
ELEVEN_VOICE_ID="preferred_voice_id"
Install the necessary Python dependencies:
pip install requests
Telegram Media Data Schema & Taxonomy
The skill manages data across specific directories and temporary paths:
| Location | Data Type | Description |
|---|---|---|
~/clawd/charts/ |
PNG Images | Technical analysis charts generated by crypto_charts.py. |
/tmp/frank_voice.mp3 |
MP3 Audio | Temporary storage for ElevenLabs text-to-speech output. |
~/clawd/.env |
Metadata | Configuration file containing API tokens and target chat IDs. |
Telegram Media Advanced Features
- Multi-Asset Batching: Generate and send a complete suite of financial charts for multiple assets in a single command.
- One-Shot TTS: Streamlined workflow that generates synthetic speech and transmits it as a native Telegram voice note.
- Strict Execution Rule: A protocol-level constraint that prevents the agent from hallucinating delivery; every action must be verified via shell output.
- Custom Captioning: Support for dynamic Markdown captions on all sent photos and documents.
SKILL.md
Loading
Related Openclaw Skills
crypto-prices
A specialized Python-based price oracle for retrieving live cryptocurrency and precious metal data from multiple reliable providers.
Advisory Council AI Market Analysis
A multi-persona AI analysis engine that synthesizes five distinct market viewpoints into actionable crypto intelligence.
Yijing Divination AI Skill
An advanced I Ching divination engine that combines traditional coin and yarrow methods with poetic, AI-driven Oracle interpretations for deep introspection.
mcd-cn McDonald's China Assistant
A CLI-based MCP client for McDonald's China that enables campaign calendar tracking, coupon lookups, and automated coupon claiming.
Backup
A comprehensive disaster recovery and migration suite for Openclaw Skills that protects your agent's memory, skills, and configuration.
AgentCloak
A secure email proxy for AI agents that provides credential isolation, PII redaction, and prompt injection detection while enabling search and drafting capabilities.
Featured*
