Why Telegram?
Telegram is the ideal platform for AI bots. It offers:
- Bot API — a rich, well-documented API purpose-built for bots
- Rich media — support for images, files, voice, video, and inline keyboards
- Groups and channels — bots can serve communities, not just individuals
- Global reach — 900M+ monthly active users worldwide
- Privacy — end-to-end encryption and self-destructing messages
Setting Up Your Telegram Bot
Creating the Bot
- Open Telegram and message @BotFather
- Send
/newbot - Choose a display name (e.g., "My AI Assistant")
- Choose a username (must end in "bot", e.g., "myai_assistant_bot")
- Save the token BotFather gives you
Connecting to OpenClaw
In the OpenClaw dashboard:
- Click Create Bot → Telegram
- Paste your bot token
- OpenClaw automatically configures the webhook
- Your bot is connected and ready
Configuring Your Bot
System Prompt Design
For Telegram bots, keep these Telegram-specific things in mind:
- Users expect quick responses — keep your system prompt concise
- Telegram supports Markdown — tell your bot to use it for formatting
- Group chats have different dynamics than private chats
You are an AI assistant on Telegram.
Use Markdown for formatting (bold, italic, code blocks).
Keep responses under 300 words unless asked for detail.
In group chats, only respond when mentioned by name.Model Selection
For Telegram bots, response speed matters. Recommended models:
- Gemini 2.0 Flash — fast, capable, great for most use cases
- Claude Haiku — extremely fast, good for simple Q&A
- GPT-4o Mini — balanced speed and capability
Skills Configuration
Popular skills for Telegram bots:
- Web Search — answer questions about current events
- Image Analysis — users can send photos for the bot to analyze
- Code Runner — great for developer communities
- File Processor — handle PDFs, spreadsheets, and documents
Advanced Features
Group Chat Behavior
Configure how your bot behaves in group chats:
- Respond only when mentioned (@botusername)
- Set a group-specific system prompt
- Limit response length in groups
- Enable or disable specific skills per context
Inline Keyboards
OpenClaw bots can use Telegram's inline keyboards for interactive experiences:
- Quick reply buttons
- Navigation menus
- Confirmation dialogs
- Poll-style interactions
Webhook Management
OpenClaw handles webhook configuration automatically:
- Automatic SSL certificate management
- Webhook health monitoring
- Automatic retry on delivery failures
- Real-time message processing
Monitoring and Analytics
Track your Telegram bot's performance in the OpenClaw dashboard:
- Messages per day — understand usage patterns
- Average response time — keep it under 3 seconds
- Token consumption — optimize costs
- Error rate — catch and fix issues quickly
- Active users — track growth over time
Optimization Tips
- Use streaming responses for long answers — users see text appear in real-time
- Set appropriate timeouts — Telegram expects responses within 60 seconds
- Handle media gracefully — configure skills to process images, voice, and files
- Rate limit per user — prevent any single user from consuming all your quota
- Monitor conversation quality — review logs periodically and refine your prompt


