EN·ES·DE·PT·FR
⌘K

Telegram Bot Setup

Telegram is aidaemon’s primary channel, built on the teloxide framework. See also Slack for workspace integration.

Create a Bot

  1. Message @BotFather on Telegram
  2. Send /newbot and follow the prompts
  3. Copy the bot token (format: 123456789:ABCdefGHIjklMNOpqrSTUvwxYZ)

Get Your User ID

Your numeric Telegram user ID is needed for the allowed_user_ids list. You can find it by messaging @userinfobot.

Configuration

config.toml
[telegram]
bot_token = "123456789:ABCdefGHIjklMNOpqrSTUvwxYZ"
allowed_user_ids = [123456789]
Access Control
If allowed_user_ids is empty, anyone who finds your bot can chat with it. Always set this in production.

Features

  • Typing indicator — sent every 4 seconds during agent processing
  • Markdown rendering — agent responses are converted to Telegram HTML
  • Long message splitting — responses over 4096 chars are split at paragraph/line boundaries
  • Screenshot sharing — browser screenshots sent as photos with captions
  • File transfer — send and receive documents, photos, audio, video via Telegram
  • Live task status — /tasks shows running agent tasks with elapsed time
  • Inline approval buttons — Allow Once / Allow Always / Deny buttons for command approval
  • Multi-bot support — configure multiple Telegram bots via [[telegram.bots]]
  • Enhanced file handling — MIME type detection, size limits, and path security validation

Retry Behavior

The Telegram dispatcher uses exponential backoff on crashes:

  • Initial backoff: 5s
  • Doubles each crash: 5s → 10s → 20s → 40s → 60s (max)
  • Resets to 5s if the bot runs stable for 60+ seconds
PreviousProvider SetupNextCommands