Connect OpenClaw to Telegram in under 5 minutes using BotFather. This guide covers OpenClaw v2026.2+, Node.js 22+ requirements, bot token configuration, and security best practices for self-hosted AI assistants.

✈️

Telegram Integration

Connect OpenClaw to Telegram and have your AI assistant respond to messages instantly.

Bot API 5 min setup Group chat support

TL;DR

  • Create a bot via @BotFather on Telegram
  • Add bot token to openclaw.json
  • Time: ~5 minutes

Setup Steps

Step 1: Create a Bot

  1. Open Telegram and search for @BotFather
  2. Send /newbot command
  3. Follow the instructions to name your bot
  4. Copy the bot token

Step 2: Configure openclaw.json

{
  "channels": {
    "telegram": {
      "enabled": true,
      "botToken": "YOUR_BOT_TOKEN"
    }
  }
}

Step 3: Start OpenClaw

openclaw start

Your Telegram bot is now active! Start a conversation with your bot.

Frequently Asked Questions

Is Telegram bot secure?

Yes, Telegram bots are secure. OpenClaw runs locally, so your API keys and conversation data never leave your server. You can also restrict bot access to specific users using allowFrom.

Can I use Telegram bot in group chats?

Yes, OpenClaw supports Telegram group chats. Configure mention keywords or require the bot to be mentioned (@yourbot) to respond in groups.

How do I get a Telegram bot token?

Open @BotFather on Telegram, use /newbot command, follow the prompts to name your bot, then copy the API token. Keep this token secure and never share it publicly.

Does Telegram support voice messages?

Yes, OpenClaw supports voice messages on Telegram. The AI can process voice input and respond with text or voice messages using text-to-speech.