A specialized skill for delivering local files, remote URLs, and Telegram file IDs to specific chats and topics via the Bot API.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install telegram-send-file
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-send-file 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 Send File?
The telegram-send-file skill is a dedicated utility within the Openclaw Skills ecosystem designed specifically for robust media and document delivery. Unlike standard messaging tools, this skill focuses on the efficient transmission of files, images, and data across the Telegram Bot API. By leveraging this Openclaw Skills component, developers can automate the distribution of reports, logs, and media directly into targeted conversations or specific thread topics.
This skill is particularly powerful when used within an active session, as it can automatically detect the current chat and topic context to ensure files are delivered exactly where they are needed. It supports a variety of input types, including local system paths, remote web URLs, and reusable Telegram file identifiers, making it a versatile tool for any automated communication workflow using Openclaw Skills.
Telegram Send File Use Cases
- Automatically uploading generated PDF reports or data exports to a project management Telegram group.
- Sending system screenshots or visual logs to a specific DevOps topic for monitoring and troubleshooting.
- Forwarding existing media using Telegram file_ids to save bandwidth and improve delivery speed.
- Distributing batch sets of documents or images to a shared channel within the Openclaw Skills framework.
How Telegram Send File Works
- The skill first attempts to auto-detect the active chat_id and topic_id if it is running within an established Openclaw Skills session.
- If no context is available, the user can explicitly provide the target destination parameters via the command line.
- The skill evaluates the source of the file, determining if it is a local path, a remote URL, or a Telegram file_id.
- For local files, the system intelligently selects the appropriate Telegram upload method based on the file extension to ensure correct formatting.
- The files are then dispatched sequentially or in batch mode to the designated Telegram chat or thread.
Telegram Send File Setup
To integrate this skill into your workflow, ensure your environment is configured for Openclaw Skills and use the following CLI patterns:
# Basic file delivery using session context
python3 scripts/telegram_send_file.py --file report.pdf
# Explicit delivery to a specific chat and topic
python3 scripts/telegram_send_file.py --chat-id -1001234567890 --topic-id 5 --file screenshot.png
# Sending multiple files in batch mode
python3 scripts/telegram_send_file.py --files document1.pdf document2.png --caption "Daily Update"
Telegram Send File Data Schema & Taxonomy
The telegram-send-file skill processes inputs to facilitate precise delivery within the Openclaw Skills environment. The following parameters define the data structure:
| Parameter | Type | Description |
|---|---|---|
| --file | String | The local filesystem path to the file |
| --url | String | A direct web link to a file for Telegram to fetch |
| --file-id | String | A unique Telegram identifier for an already uploaded file |
| --chat-id | Integer | The unique identifier for the target Telegram chat |
| --topic-id | Integer | The identifier for a specific thread or topic within a group |
| --caption | String | Optional text accompanying the file delivery |
Telegram Send File Advanced Features
- Context Awareness: Automatically inherits chat and topic metadata when executed within a standard Openclaw Skills session.
- Batch Processing: Supports the sequential delivery of multiple files while maintaining the same destination parameters.
- Multi-Source Support: Seamlessly handles local files, remote URLs, and internal Telegram identifiers for maximum flexibility.
- Extension Detection: Automatically optimizes the delivery method based on file types to ensure the best user experience in the Telegram client.
SKILL.md
Loading
Related Openclaw Skills
Code Dev Pipeline
A professional 8-agent collaborative coding pipeline designed for complex software development, frontend design, and automated quality assurance.
HTML to Markdown
A versatile utility to transform HTML code, local files, or live web pages into clean Markdown formatting for AI agents and developers.
War Room Skill
A high-stakes coordination protocol for managing multi-agent teams during production outages and critical system failures.
Bilibili Transcriber
A professional Bilibili video processing agent that transcribes audio into text and generates high-quality structured summaries.
Information Extraction
A professional-grade pipeline for extracting entities, relations, and events from raw text into normalized, graph-ready structured formats.
vLLM High-Performance Inference Engine
An expert assistant for deploying and optimizing large language models using the high-throughput vLLM inference engine.
Featured*
