Skip to main content

Channel Setup - Telegram

Token Provisioning​

  1. Open BotFather and run /newbot.
  2. Set bot display name and username (must end with bot).
  3. Copy the HTTP API token (123456:ABC...).
  4. Optional for group behavior: run /setprivacy and tune as needed.

Single-token Single-bot​

telegram_bot_token: "123456:ABC-DEF1234..."
bot_username: "my_microclaw_bot"

Notes:

  • bot_username must not include @.
  • In groups, mention @my_microclaw_bot unless your privacy/group settings allow broader visibility.

Multi-token Multi-bot​

channels:
  telegram:
    enabled: true
    default_account: "main"
    accounts:
      main:
        enabled: true
        bot_token: "123456:ABC-DEF1234..."
        bot_username: "my_microclaw_main_bot"
      support:
        enabled: true
        bot_token: "987654:XYZ-DEF9999..."
        bot_username: "my_microclaw_support_bot"
        # Optional per-account group allowlist
        # allowed_groups: [-1001234567890]
        # Optional per-account DM sender allowlist (Telegram user IDs)
        # allowed_user_ids: [123456789]

Notes:

  • Each account runs as an independent Telegram bot in the same MicroClaw process.
  • Mention the specific bot username that should answer in group chats.
  • For group chats with multi-token multi-bot, configure each bot in BotFather:
    • Bot Settings -> Allow Groups: enabled
    • Bot Settings -> Group Privacy: disabled (/setprivacy -> Disable)

Verify​

  1. microclaw start
  2. DM each bot: /skills
  3. In a group, mention each bot and verify replies.

Quick Troubleshooting​

  • Bot replies in DM but not group: check mention and privacy mode.
  • Token rotated in BotFather: update token and restart MicroClaw.