Anleitung: KI-Workflows mit Telegram steuern

Warum Telegram zur Steuerung?

Telegram ist schnell, sicher und auf jedem Gerät verfügbar. Mit der Bot-API kannst du deine KI-Workflows direkt aus dem Chat starten – ohne SSH, ohne Dashboard, ohne Umwege. Ein Befehl genügt, und dein Agent beginnt zu arbeiten.

Voraussetzungen

Ein laufender Hermes Agent (lokal oder auf deinem Server)
Ein Telegram-Konto und die Telegram-App
Ein Telegram Bot Token (von @BotFather)
Deine Telegram User ID (von @userinfobot)

Schritt 1: Bot erstellen und Token holen

SCHRITT 1/5

Bot bei BotFather registrieren

Öffne Telegram und starte eine Unterhaltung mit @BotFather. Sende den Befehl /newbot und folge den Anweisungen. Du erhältst einen Token im Format:

1234567890:ABCdefGHIjklMNOpqrsTUVwxyz

Dieser Token ist der Schlüssel – speichere ihn sicher in deiner .env-Datei.

Schritt 2: Hermes für Telegram freigeben

SCHRITT 2/5

Zwei Umgebungsvariablen — mehr braucht das Gateway nicht

Ältere Fassungen dieser Anleitung zeigten einen telegram:-Block mit enabled, bot_token, allowed_chats und commands in der config.yaml. Diese Struktur existiert im Hermes-Gateway nicht. Geprüft im Code: der Gateway liest die Freigabe ausschließlich über Umgebungsvariablen (gateway/authz_mixin.py), in der config.yaml steht unter gateway: nur multiplex_profiles. Ein selbst geschriebener commands:-Block wird ignoriert — er richtet nichts ein.

Setze stattdessen in deiner .env:

TELEGRAM_BOT_TOKEN=1234567890:ABCdefGHIjklMNOpqrsTUVwxyz
TELEGRAM_ALLOWED_USERS=7664467819
# optional, für Gruppen:
TELEGRAM_GROUP_ALLOWED_USERS=7664467819
TELEGRAM_GROUP_ALLOWED_CHATS=-1001234567890

Die Zahlen sind die numerischen Telegram-IDs (von @userinfobot), keine @namen. TELEGRAM_ALLOWED_USERS wirkt plattformweit (auch DM), TELEGRAM_GROUP_ALLOWED_USERS nur gruppen-scoped — Chat-IDs gehören ausschließlich nach TELEGRAM_GROUP_ALLOWED_CHATS; werden Chat-IDs fälschlich unter …_ALLOWED_USERS eingetragen, werden sie vom Gateway als Fehlkonfiguration zurückgewiesen.

Danach den Telegram-Kanal aktivieren und den Gateway neu starten:

hermes start --profile mein-profil
# oder in laufender Sitzung:
/reload-mcp          # MCP-Server neu laden
/restart             # Gateway neu starten

Schritt 3: Bot starten und testen

SCHRITT 3/5

Hermes mit Telegram-Unterstützung starten

Starte Hermes neu, damit die Config geladen wird:

hermes start --profile mein-profil

Öffne nun deinen Bot in Telegram und sende /start. Du solltest eine Begrüßung erhalten. Teste dann /status – der Bot sollte den aktuellen Systemstatus melden.

Sieht du keine Antwort? Prüfe, ob der Bot-Token korrekt ist und deine User-ID eingetragen wurde. Die Freigabe läuft nicht über allowed_chats (diesen Schlüssel gibt es im Gateway nicht), sondern über TELEGRAM_ALLOWED_USERS in der .env. Nur eingetragene User können den Bot steuern.

Schritt 4: Workflows anstoßen — mit den Befehlen, die es wirklich gibt

SCHRITT 4/5

Keine eigenen Slash-Befehle — Ziel setzen statt

Ältere Fassungen zeigten hier einen telegram.custom_commands-Block mit /recherche, /bericht und /backup. Geprüft: es gibt keine benutzerdefinierten Slash-Befehle. Das Gateway kennt eine feste, im Code hinterlegte Befehlsmenge; ein eigener Eintrag in der Config wird nicht registriert.

Was stattdessen funktioniert, ist ein stehendes Ziel — der Agent arbeitet es über mehrere Runden ab, auch zwischen Nachrichten:

/goal Recherchiere die drei besten KI-Tools für kleine
Betriebe, erstelle eine Vergleichstabelle und
schick sie mir als Nachricht in diesen Chat

/goal kennt gemessene Unterverben:

/goal status      # Ziel + Fortschritt anzeigen
/goal pause       # Ziel anhalten
/goal resume      # Ziel fortsetzen (Aliase: continue, unpause)
/goal show        # Zieltext anzeigen
/goal clear       # Ziel beenden (Aliase: stop, done)
/goal wait <text> # auf ein externes Ereignis warten
/goal gate <…>  # Freigabe-Tor setzen (nur Admin)
/goal draft      # Ziel als Entwurf anlegen
/goal -- <text> # Text, der mit einem Steuerwort beginnt

Für einen einzelnen langen Lauf im eigenen Thread:

/bg <Prompt>     # Hintergrund-Thread, eigene Session,
                 # Ergebnis kommt in denselben Chat

Schritt 5: Multi-Agenten-Pipelines steuern

SCHRITT 5/5

Komplexe Abläufe mit einem Befehl anstoßen

Mit HYPDB.ONE kannst du ganze Agenten-Ketten über Telegram starten. Ein Beispiel:

/goal "Analysiere die letzten 10 Blog-Artikel
zum Thema KI-Agenten und erstelle eine
Zusammenfassung mit Handlungsempfehlungen"

Hermes zerlegt das Ziel automatisch in Teilaufgaben, delegiert an spezialisierte Agenten und liefert das Ergebnis in den Chat zurück – vollständig asynchron.

Die gemessene Befehlsliste (Stand: geprüft im Gateway-Code)

Diese Befehle sind im Quellcode als Handler hinterlegt (gateway/slash_commands*.py). Alles, was hier nicht steht, gibt es nicht:

/status        – Session- und Systemstatus
/goal          – stehendes Ziel (siehe Schritt 4)
/stop          – laufende Arbeit beenden
/bg            – Prompt in eigenem Hintergrund-Thread
/steer         – Nachricht nach dem nächsten Tool-Call einfügen
/agents        – aktive Agenten und laufende Tasks
/tasks         – Alias für /agents
/new · /reset  – neue Session
/undo          – letzten Austausch zurücknehmen
/retry         – letzte Nachricht erneut senden
/compress      – Kontext komprimieren
/title [name]  – Session benennen
/resume [name] – Session fortsetzen
/branch · /fork– Session abzweigen
/usage         – Token-Verbrauch
/insights [d]  – Nutzungsanalyse der letzten d Tage
/model [name]  – Modell anzeigen oder wechseln
/personality   – Persönlichkeit setzen
/reasoning     – Reasoning-Stufe setzen
/voice         – on | off | tts | channel | leave | status
/platform      – Verbindungsstatus der Kanäle
/skills        – Skills suchen und laden
/cron          – Cronjobs verwalten
/plugins       – Plugins auflisten
/approve       – ausstehenden Gateway-Befehl genehmigen
/deny          – ausstehenden Gateway-Befehl ablehnen
/restart       – Gateway neu starten
/sethome       – aktuellen Chat als Home-Kanal setzen
/update        – Hermes aktualisieren
/help · /commands – Befehlsübersicht

Was es NICHT gibt: /queue als Warteschlangen-Anzeige (das Wort „queue" ist im Code nur ein Busy-Verhalten, wenn der Agent beschäftigt ist), /background (der echte Befehl ist /bg), /backup und jede andere frei erfundene Kennung. /approve und /deny bestätigen einen vom Gateway angeforderten Befehl — sie sind keine Freigabe-Kontrolle für eigene Workflows.

▸ DIESE ARBEITSUMGEBUNG — GEMESSEN

PRÜFE…

Content-System—

Chat-Modelle (lokal)—

Messaging-Kanäle—

Cronjobs—

Recherche-Rotation—

Aktive Agenten—

Persona-Registry—

Systemdienste / Skills—

▸ FORSCHUNGS-ROTATION — GEMESSEN

PRÜFE…

Zyklus / Maximum—

Quellen je Zyklus—

Abrufe—

Trefferquote—

Rotationsstufen—

Pausiert—

Häufige Fehler und Lösungen

Bot antwortet nicht: Prüfe hermes status – läuft der Agent? Prüfe den Bot-Token in der .env.
"Provider authentication failed": Der API-Key für dein KI-Modell ist falsch oder abgelaufen. Setze einen gültigen Key in der Config.
Befehl wird nicht erkannt: Es gibt keine konfigurierbare Befehlsliste — prüfe den Befehl gegen die gemessene Liste oben. Ein Tippfehler wie /queu oder ein erfundener Befehl wie /backup wird einfach nicht beantwortet.
Keine Antwort bei langen Workflows: Nutze /bg für Aufgaben, die länger dauern — der Prompt läuft in einem eigenen Hintergrund-Thread, das Ergebnis kommt in denselben Chat. Ein stehendes Ziel (/goal) arbeitet ohnehin über mehrere Runden weiter. Es gibt keinen Befehl /background — nur die Kurzform /bg, und keine gemessene 30-Sekunden-Grenze.

Warum ältere Fassungen dieser Anleitung nicht funktionierten

Der telegram:-Config-Block — existiert nicht. Freigabe läuft über TELEGRAM_ALLOWED_USERS.
User-ID 7664467819 — war in der alten Fassung als Beispiel eingetragen; die numerische ID gehört dir, nicht der Anleitung. Trage deine eigene ein.
custom_commands — kein Handler, kein Registry-Eintrag. Ganze Workflows startest du mit /goal.
„Der Bot meldet sich, wenn die Aufgabe fertig ist" — stimmt nur für /bg und für Ziele; ein einfacher Prompt läuft in der Session.
„30 Sekunden" — keine gemessene Grenze; der Timeout hängt am Modell und der Plattform, nicht an einer festen Zahl im Code.

Weiterlesen

Worker — wiederkehrende Aufträge statt Einmal-Prompts
Tarife — welcher Tarif welche Agenten freischaltet
KI-Workflows automatisieren — dieselben Aufträge, vom Aufbau her betrachtet (mit Live-Belegen aus /api/automation)
KI-Workflows mit Cron automatisieren — Zeitsteuerung statt Chat-Befehl
FAQ — häufige Fragen zu Sicherheit und Datenschutz
Impressum — JD Smart Vision e.U., Wien

Nächste Schritte

Richte Cron-Jobs ein, die tägliche Berichte per Telegram senden
Verbinde mehrere Agenten zu einer Pipeline und starte sie mit einem Befehl
Nutze Freigabe-Workflows – der Agent fragt per Telegram, bevor er kritische Aktionen ausführt
Erstelle benutzerdefinierte Tastaturen für schnelle Befehlsauswahl