A definitive guide and technical workflow for integrating OpenClaw agents with the Telegram messaging platform for secure, automated communication.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install telegram-agent-setup
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-agent-setup 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 Agent Setup?
The Telegram Agent Setup is a specialized configuration protocol designed to bridge OpenClaw with the Telegram Bot API. By leveraging these Openclaw Skills, developers can transform a standard Telegram bot into a powerful AI assistant capable of handling private messages, group discussions, and forum topics. This integration prioritizes security and production readiness, offering a streamlined path from initial bot creation to a fully secured, multi-functional messaging interface.
Telegram Agent Setup Use Cases
- Creating a private AI assistant for personal productivity and task management via mobile.
- Implementing automated moderators or assistants within Telegram group chats and large community forums.
- Setting up voice-to-text workflows using faster-whisper to process audio notes directly through Openclaw Skills.
- Deploying multi-agent architectures where different Telegram topics are routed to specialized AI personalities.
How Telegram Agent Setup Works
- Initialize a new bot entity using Telegram's @BotFather to generate a secure API token.
- Configure the OpenClaw gateway to listen for incoming Telegram updates via long polling.
- Implement security filtering by mapping specific Telegram User IDs or Group IDs to the authorized access list.
- Define interaction behaviors, such as responding only to mentions or specific slash commands.
- Enable optional processing modules like voice transcription or media handling for enriched agent interactions.
Telegram Agent Setup Setup
To begin using these Openclaw Skills, ensure OpenClaw is running and you have a bot token from @BotFather. Run the following command to start the interactive setup:
openclaw telegram setup
For manual configuration, update your ~/.openclaw/openclaw.json with your credentials:
{
"channels": {
"telegram": {
"enabled": true,
"botToken": "YOUR_BOT_TOKEN_HERE",
"allowedChatIds": ["YOUR_ID"]
}
}
}
Apply the changes by restarting the gateway:
openclaw gateway restart
Telegram Agent Setup Data Schema & Taxonomy
The integration manages data through the OpenClaw gateway configuration, organizing communication channels and security parameters as follows:
| Parameter | Type | Description |
|---|---|---|
| botToken | String | The unique authentication token for the Telegram API. |
| allowedChatIds | Array | A whitelist of IDs authorized to interact with the Openclaw Skills bot. |
| rejectUnknown | Boolean | When true, prevents unauthorized users from triggering agent responses. |
| groupBehavior | Object | Configures how the agent reacts to messages in group settings (e.g., mention-only). |
| topic_id | Integer | Maps specific forum threads to unique agent processing workflows. |
Telegram Agent Setup Advanced Features
- Forum Support: Route different Telegram topics to distinct AI agents for specialized department handling.
- Voice Transcription: Integrated STT using faster-whisper for processing audio messages in real-time.
- Security Hardening: Production-grade access control using allowedChatIds and silent error policies.
- Inline Interaction: Support for Telegram inline buttons and custom bot commands for improved UX.
- Proactive Monitoring: Built-in logging and status checks via the OpenClaw CLI to ensure high availability.
SKILL.md
Loading
Related Openclaw Skills
JD.com API
A specialized tool for extracting precise JD.com product details, customer reviews, and shop inventories via the JustOneAPI interface.
ClawGuard Guardian
ClawGuard Guardian is a runtime security monitor that intercepts, controls, and replays AI agent operations to ensure safe and compliant behavior.
Multi-Agent Architecture
A high-performance architecture guide for running multiple specialized AI agents on a single OpenClaw server with workspace isolation and shared knowledge.
Solana Monitor
A comprehensive real-time monitoring tool for the Solana blockchain, offering price alerts, whale tracking, and liquidity insights.
IMDb API
Integrate 19 specialized IMDb operations into your AI agent for comprehensive title research, cast analysis, and release monitoring.
Data Scraper
An intelligent data extraction tool designed to crawl websites and APIs to generate structured data in JSON, CSV, or Excel formats.
Featured*
