Hermes Agent mit Telegram verbinden und Aufgaben vom Smartphone aus verwalten

Du kannst Hermes Agent über Telegram auf deinem Smartphone Nachrichten senden oder ihm Aufgaben diktieren, wenn du nicht an deinem Computer bist, und das Ergebnis im selben Chat erhalten. Ergebnisse geplanter Aufgaben kommen einmalig in dem Chat an, den du als deinen Home-Chat festlegst.

Wenn du Hermes noch nicht hast, beginne mit der Anleitung dazu, was dieser Agent ist und wie du ihn installierst, und kehre dann zurück, um Telegram zu verbinden.

Weitere Anleitungen findest du in der Ailoot-Dokumentation.

Was brauchst du, um Hermes Agent mit Telegram zu verbinden?#

Der Befehl hermes doctor überprüft deine Hermes-Installation und die Verbindung zum Modell. Wir erstellen den Bot in der Telegram-App, und du brauchst einen Computer, um Befehle im Terminal auszuführen.

Wie erstellst du einen Bot über BotFather?#

Jeder Telegram-Bot hat ein Token — einen geheimen Schlüssel zur Steuerung des Bots. Es wird vom offiziellen Telegram-Bot @BotFather ausgegeben.

1. @BotFather öffnen

   Suche in Telegram nach @BotFather oder öffne t.me/BotFather. Der echte BotFather hat ein blaues Verifizierungszeichen. Tippe auf „Start“, um das Gespräch zu beginnen.

2. Den Befehl /newbot senden

   BotFather fragt nach zwei Namen. Der erste ist der Anzeigename; er kann beliebig sein, zum Beispiel „Mein Agent“. Der zweite ist der Benutzername: Er muss eindeutig sein und auf bot enden, zum Beispiel moy_agent_bot.

3. Das Token abrufen

   BotFather sendet eine Glückwunschnachricht und eine lange Zeichenfolge im Format 123456789:ABCdefGHIjklMNOpqrSTUvwxYZ. Das ist das Bot-Token. Kopiere die gesamte Zeichenfolge.

Es gibt auch einen schnellen Weg, für den kein manuelles Gespräch mit BotFather nötig ist. Im Hermes-Web-Dashboard (hermes dashboard) und in der Desktop-App gibt es auf der Seite „Messaging → Telegram“ die Schaltfläche „Create with QR“: Scanne den Code mit deinem Smartphone, und Hermes erstellt einen Bot, erkennt deine ID, speichert das Token in den Einstellungen und startet das Gateway neu. Die folgenden Schritte beschreiben die manuelle Methode; wenn du QR gewählt hast, gehe direkt zur Überprüfung der Verbindung.

Wie findest du deine Telegram-ID, und wozu brauchst du sie?#

Ein Telegram-Konto hat zwei Kennungen: einen öffentlichen Benutzernamen mit @ und eine interne numerische ID. Hermes verwendet die Zahl.

Die schnelle Methode „Mit QR-Code erstellen“ erkennt deine ID automatisch. Notiere sie neben deinem Token.

Wie übergibst du Hermes Agent das Token und startest das Gateway?#

1. Den Einrichtungsassistenten ausführen

   hermes gateway setup
   

   Führe den Befehl auf dem Computer aus, auf dem Hermes installiert ist. Der Assistent zeigt eine Liste von Messaging-Apps an.

2. Telegram auswählen und deine Angaben eingeben

   Der Assistent fragt nach dem Bot-Token und den erlaubten IDs (du kannst mehrere, durch Kommas getrennte IDs eingeben) und speichert alles direkt in den Einstellungen.

3. Das Gateway starten

   hermes gateway
   

   Das Gateway startet und verbindet sich mit Telegram. Sende deinem Bot nach wenigen Sekunden eine beliebige Nachricht über die App: Wenn Hermes antwortet, ist die Verbindung bereit.

Bei der manuellen Methode öffnest du statt des Assistenten die Datei ~/.hermes/.env und fügst zwei Zeilen hinzu. Ersetze dabei die Werte durch das Token von BotFather und deine numerische ID:

TELEGRAM_BOT_TOKEN=123456789:ABCdefGHIjklMNOpqrSTUvwxYZ
TELEGRAM_ALLOWED_USERS=123456789

Die zweite Zeile erlaubt diesen Personen den Zugriff in privaten Chats und Gruppen. Eine separate Gruppenfreigabe kann weiteren Zugang gewähren. Trenne mehrere Personen durch Kommas. Speichere die Datei und starte das Gateway mit demselben Befehl hermes gateway.

Wenn der Bot selbst in einem privaten Chat stumm bleibt, überprüfe die Gateway-Protokolle im selben Terminal und kontrolliere zuerst das Token sowie deine ID in der Zugriffsliste; weitere Fehler werden in der Tabelle am Ende des Artikels behandelt.

Was kann der Telegram-Bot auf deinem Smartphone?#

Auf deinem Smartphone brauchst du am häufigsten fünf Funktionen.

Text- und Sprachnachrichten. Schreibe eine Aufgabe in Worten oder diktiere eine Sprachnachricht — wenn die Spracherkennung eingerichtet ist, transkribiert Hermes sie und versteht sie. Bei einem lokalen Anbieter sind keine Schlüssel erforderlich; die gesamte Verarbeitung erfolgt auf dem Computer, auf dem der Agent läuft.

Dateien und Bilder. Du kannst dem Bot ein Dokument, eine Tabelle oder einen Screenshot weiterleiten — der Agent erhält es als Anhang. Er kann auch erstellte Dateien zurücksenden: Bitte um einen Bericht, und er schickt ihn als Datei im Chat.

Bestätigungen für gefährliche Aktionen. Wenn der Agent etwas Riskantes tun will, etwa Dateien löschen, fragt er zuerst im Chat nach: Antworte mit „yes“ oder „y“, führt er es aus; antworte mit „no“ oder „n“, bricht er ab.

Schaltflächen statt Antworten durch Tippen. Wenn der Agent eine Klarstellung braucht, sendet er eine Frage mit Inline-Schaltflächen zur Auswahl — tippe auf eine Option, und der Agent arbeitet weiter. Der Befehl /model ohne Argumente zeigt ein Menü zur Modellauswahl mit denselben Schaltflächen.

Benachrichtigungen ohne ständiges Klingeln. Standardmäßig klingelt dein Smartphone nur bei endgültigen Antworten, Zustimmungsanfragen und Befehlsbestätigungen. Systembenachrichtigungen wie „calling a tool“ und „compressing context“ kommen lautlos an, damit dein Smartphone nicht bei jedem Schritt klingelt. Wenn du bei jedem Schritt eine Tonbenachrichtigung möchtest, ändere den Modus in den Einstellungen.

Wie erhältst du Ergebnisse von Hintergrundaufgaben im Chat?#

Home-Chat für geplante Aufgaben. Hermes unterstützt geplante Aufgaben, zum Beispiel: „Stell mir jeden Morgen um 7:43 eine Zusammenfassung zusammen.“ Die Ergebnisse werden an den Home-Chat gesendet, den du einmalig festlegst, indem du den Befehl /sethome direkt im Gespräch mit dem Bot sendest. Solange das Gateway läuft, kommen die Zusammenfassungen automatisch an.

Hintergrundaufgaben. Du kannst eine lange Aufgabe zur Ausführung im Hintergrund senden und deinem Tag weiter nachgehen: Der Bot schreibt dir, wenn sie fertig ist. Eine Aufgabe, die in einem Thema gestartet wird, gibt ihre Antwort in dasselbe Thema zurück, sodass nichts verloren geht.

Wichtige Einschränkung: Der Bot antwortet nur, solange das Gateway läuft. Wenn du den Computer, auf dem Hermes läuft, ausschaltest oder in den Ruhezustand versetzt, antwortet der Bot erst wieder, wenn der Computer läuft. Damit der Bot immer online bleibt, verschiebe den Agenten auf einen Server: Dazu gibt es eine separate Anleitung, wie du Hermes Agent rund um die Uhr laufen lässt. Standardmäßig fragt das Gateway Telegram regelmäßig nach neuen Nachrichten ab; für Cloud-Plattformen, die ohne eingehenden Datenverkehr in den Ruhezustand wechseln, bietet die Dokumentation einen Webhook-Modus, der die Verbindungsrichtung umkehrt, sodass Telegram selbst Anfragen an den Bot sendet.

Wie hältst du Fremde vom Bot fern?#

Dein Bot kann in der Telegram-Suche anhand seines Benutzernamens gefunden werden. Der Schutz beruht daher auf zwei Dingen: der Zugriffsliste und einem geheim gehaltenen Token.

Richte zuerst Absenderzugang über TELEGRAM_ALLOWED_USERS ein. Prüfe bei Gruppen zusätzlich TELEGRAM_GROUP_ALLOWED_CHATS: Ein dort eingetragener Chat erlaubt allen Mitgliedern den Zugriff, auch ohne ihre ID in der persönlichen Liste. Eine leere persönliche Liste belegt deshalb allein keine vollständig geschlossenen Gruppen.

Zweitens gibt es das Token. Es darf nicht in Screenshots, weitergeleiteten Nachrichten oder Repositories landen. Wenn das Token offengelegt wird, widerrufe es mit dem Befehl /revoke bei BotFather. Trage dann das neue Token in den Einstellungen ein und starte das Gateway neu.

Ein separater Hinweis zu Gruppen: Absender- und Chatberechtigung sind getrennt. Ein Mitglied einer über TELEGRAM_GROUP_ALLOWED_CHATS erlaubten Gruppe kann den Bot auch ohne Eintrag in TELEGRAM_ALLOWED_USERS nutzen. Soll der Zugriff individuell bleiben, erteile nicht der ganzen Gruppe Zugang. Konfiguriere und prüfe die Absenderbeschränkungen deiner installierten Version. Wenn der Bot in einer Gruppe nur auf Zuruf antworten soll, gibt es die Einstellung telegram.require_mention — dann reagiert er auf eine @-Erwähnung, eine Antwort auf seine Nachricht, einen Befehl wie /command@yourbot und Übereinstimmungen mit deinen Mustern in telegram.mention_patterns; gewöhnliche Gruppennachrichten ignoriert er.

Warum bleibt der Bot in einer Gruppe stumm, und wie behebst du das?#

Bei neuen Telegram-Bots ist der Datenschutzmodus standardmäßig aktiviert; die Hermes-Dokumentation beschreibt ihn als häufigste Ursache für Verwirrung bei Bots in Gruppen. In diesem Modus empfängt der Bot nur Nachrichten, die mit einem /-Befehl beginnen, Antworten auf seine eigenen Nachrichten und Systembenachrichtigungen. Gewöhnliche Gruppennachrichten empfängt er schlicht nicht — Telegram sendet sie ihm nicht, und keine Agenteneinstellung kann das beheben.

So behebst du das Problem:

1. Öffne @BotFather und sende /mybots.
2. Wähle deinen Bot aus.
3. Öffne „Bot Settings“ → „Group Privacy“ → „Turn off“.
4. Entferne den Bot aus der Gruppe und füge ihn erneut hinzu.

Der vierte Schritt wird leicht übersehen; dann „bleibt der Bot weiterhin stumm“. Telegram merkt sich die Datenschutzeinstellung, die galt, als der Bot der Gruppe beigetreten ist, und aktualisiert sie erst, wenn du den Bot entfernst und erneut hinzufügst.

Wenn du den Datenschutzmodus nicht global deaktivieren möchtest, gibt es eine zweite Möglichkeit: Mache den Bot zum Gruppenadministrator. Administrator-Bots empfangen in jedem Datenschutzmodus alle Nachrichten.

Häufige Verbindungsfehler und was du dagegen tun kannst#

Was fragen Menschen sonst noch zu Hermes Agent in Telegram?#

Wenn du so weit bist, lerne Ailoot kennen.