EN·ES·DE·PT·FR
⌘K

Telegram-Bot-Einrichtung

Telegram ist aidaemons primärer Channel, aufgebaut auf dem teloxide-Framework. Siehe auch Slack für Workspace-Integration.

Einen Bot erstellen

  1. Sende eine Nachricht an @BotFather auf Telegram
  2. Sende /newbot und folge den Anweisungen
  3. Kopiere das Bot-Token (Format: 123456789:ABCdefGHIjklMNOpqrSTUvwxYZ)

Deine Benutzer-ID ermitteln

Deine numerische Telegram-Benutzer-ID wird für die allowed_user_ids-Liste benötigt. Du findest sie, indem du @userinfobot eine Nachricht sendest.

Konfiguration

config.toml
[telegram]
bot_token = "123456789:ABCdefGHIjklMNOpqrSTUvwxYZ"
allowed_user_ids = [123456789]
Zugriffskontrolle
Wenn allowed_user_ids leer ist, kann jeder, der deinen Bot findet, mit ihm chatten. Setze dies immer in der Produktion.

Funktionen

  • Tipp-Indikator — wird alle 4 Sekunden während der Agent-Verarbeitung gesendet
  • Markdown-Rendering — Agent-Antworten werden in Telegram-HTML konvertiert
  • Aufteilung langer Nachrichten — Antworten über 4096 Zeichen werden an Absatz-/Zeilengrenzen aufgeteilt
  • Screenshot-Freigabe — Browser-Screenshots werden als Fotos mit Bildunterschriften gesendet
  • Dateiübertragung — sende und empfange Dokumente, Fotos, Audio, Video über Telegram
  • Live-Aufgabenstatus/tasks zeigt laufende Agent-Aufgaben mit verstrichener Zeit
  • Inline-Genehmigungsschaltflächen — Einmal erlauben / Immer erlauben / Ablehnen-Schaltflächen für Befehlsgenehmigung
  • Multi-Bot-Unterstützung — konfiguriere mehrere Telegram-Bots über [[telegram.bots]]
  • Erweiterte Dateiverarbeitung — MIME-Typ-Erkennung, Größenbeschränkungen und Pfadsicherheitsvalidierung

Wiederholungsverhalten

Der Telegram-Dispatcher verwendet exponentielles Backoff bei Abstürzen:

  • Initiales Backoff: 5s
  • Verdoppelt sich bei jedem Absturz: 5s → 10s → 20s → 40s → 60s (max)
  • Wird auf 5s zurückgesetzt, wenn der Bot 60+ Sekunden stabil läuft