OpenClaw + Telegram: Build Your Personal AI Bot
Connect your OpenClaw agent to Telegram for a personal AI assistant accessible from your phone. Setup guide with BotFather and configuration.
Why Telegram?
Telegram is ideal for personal AI agents: - Available on every device (phone, tablet, desktop, web) - Rich message formatting (markdown, buttons, media) - Instant push notifications - No cost for bot usage - Excellent API
Step 1: Create a Bot with BotFather
- Open Telegram and search for @BotFather
- Send
/newbot - Choose a name (e.g., "My OpenClaw Agent")
- Choose a username (must end in
bot, e.g.,my_openclaw_bot) - Copy the API token
Step 2: Configure OpenClaw
bashopenclaw config set telegram.token YOUR_BOT_TOKEN openclaw gateway restart
Step 3: Start Chatting
Open your bot in Telegram and send a message. Your OpenClaw agent will respond!
Features
Voice Messages
Send voice messages to your bot — OpenClaw can transcribe and respond.
File Sharing
Send documents, images, and code files. Your agent can read and process them.
Location Sharing
Share your location for weather forecasts and local recommendations.
Inline Buttons
OpenClaw can send messages with interactive buttons for quick actions.
Advanced Configuration
Private Only
Restrict your bot to only respond to you:
yamltelegram: token: "YOUR_TOKEN" allowedUsers: - "your_telegram_id"
Group Chat Mode
Add your bot to Telegram groups:
yamltelegram: token: "YOUR_TOKEN" groups: - id: "-100123456789" mode: "mention" # Only respond when @mentioned
Use Cases
- Quick questions while away from your desk
- Reminders — "remind me to deploy at 5 PM"
- Status checks — "is the website up?"
- File access — "send me the latest report"
- Smart home — "turn off the living room lights"
Tips
- Set a profile picture for your bot in BotFather (
/setuserpic) - Add a description (
/setdescription) so others know what it does - Pin important messages from your agent for quick reference
- Use /commands in BotFather to register bot commands
Ready to Learn by Doing?
Go beyond blog posts with hands-on video courses. Build real projects with Docker, Ansible, Node.js, and more.