Hermes Agent mit Telegram verbinden

Kurz gesagt. Erstelle in Telegram mit @BotFather einen Bot (/newbot) und kopiere sein Token. Gib Hermes Agent das Token und deine numerische Telegram-Nutzer-ID: Nur die IDs auf seiner Allowlist oder Personen, die du mit einem Pairing-Code freigibst, können mit ihm sprechen; ohne Allowlist bekommt ein Fremder nur einen Pairing-Code, den du freigeben müsstest. Auf deiner eigenen Maschine sind das TELEGRAM_BOT_TOKEN und TELEGRAM_ALLOWED_USERS in ~/.hermes/.env oder hermes gateway setup. Bei PlayNHost fügst du Token und ID auf der Seite Agent ein und startest neu.

Geprüft am 7. November 2026, gültig für Hermes Agent v0.23.0.

Dieser Leitfaden nutzt die Telegram- und Sicherheitsdokumentation von Hermes Agent und das PlayNHost-Panel in seinem heutigen Stand. Die Telegram-Unterstützung ist fester Bestandteil des Messaging-Gateways von Hermes Agent: Du musst nichts zusätzlich installieren.

Schritt 1: Bot erstellen und Token kopieren

1. Öffne in Telegram einen Chat mit @BotFather (oder t.me/BotFather). Prüfe, dass der Name genau @BotFather lautet.
2. Sende /newbot, wähle einen Anzeigenamen und dann einen Benutzernamen, der auf bot endet.
3. BotFather antwortet mit dem Token, das so aussieht: 123456789:ABCdefGHIjklMNOpqrSTUvwxYZ. Halte es geheim: Wer es hat, kann deinen Bot steuern. Wenn es offengelegt wird, widerrufe es mit /revoke in BotFather.

Ein Programm pro Bot. Laut FAQ von Hermes Agent braucht jede Chat-Plattform die alleinige Nutzung eines Bot-Tokens. Wenn eine ältere Kopie von Hermes Agent oder ein anderes Programm noch dasselbe Token verwendet, stoppe es zuerst oder erstelle einen neuen Bot.

Schritt 2: deine Telegram-Nutzer-ID herausfinden

Die Allowlist von Hermes Agent erwartet deine numerische Nutzer-ID, eine Zahl wie 123456789, nicht deinen @Benutzernamen. So kommst du an sie:

• Bei PlayNHost, aus der Console. Schreibe deinem Bot, bevor du eine ID eingetragen hast: Die Console gibt deine ID aus. Einzelheiten in Schritt 3 unten.
• Aus dem Log von Hermes Agent. Wenn jemand, der nicht auf seiner Liste steht, eine Direktnachricht schickt, steht im Log (~/.hermes/logs/gateway.log) eine Warnung, die mit „Unauthorized user“ beginnt, mit der numerischen ID des Absenders (in Klammern hinter dem Namen, wenn Fremde ignoriert werden sollen, wie bei PlayNHost).
• Ein Bot eines Drittanbieters. Die Dokumentation von Hermes Agent schlägt @userinfobot oder @get_id_bot vor, die dir mit deiner ID antworten.

Schritt 3 bei PlayNHost: Token und ID einfügen

Du brauchst auf derselben Seite einen KI-Anbieter-Schlüssel. Ohne ihn bricht Starten mit „Your agent is not set up yet: it needs an API key from one AI provider and a Telegram or Discord bot token.“ ab.

1. Öffne deinen Server unter panel.playnhost.com und dann den Tab Agent.
2. Setze unter KI-Anbieter einen Schlüssel, falls noch nicht geschehen (siehe Welchen KI-Schlüssel du für Hermes Agent verwendest).
3. Drücke unter Chat-Apps bei Telegram-Bot-Token auf Setzen, füge das Token von BotFather ein und drücke Speichern. Das Panel prüft die Form; bei einem falsch eingefügten Wert erscheint „That is not a valid telegram bot token.“ Nach dem Speichern zeigt die Zeile nur die letzten vier Zeichen, und das Token wird nie wieder angezeigt.
4. Du kennst deine ID noch nicht? Lass Telegram-Nutzer-IDs leer und drücke Starten. Der erste Start installiert Hermes Agent, was in unseren Tests etwa 2,5 bis 4 Minuten dauerte. Wenn der Agent läuft, gibt die Console aus:

   [PlayNHost] Your agent is running
   [PlayNHost] Telegram: nobody can message your agent yet. Send your bot any message: your Telegram user ID appears here in the console. Put it on the Agent page, then restart.

   Schicke deinem Bot eine Nachricht in Telegram. Er antwortet nicht, nicht einmal mit einem Pairing-Code: Bei PlayNHost ignoriert Hermes Agent alle, die nicht auf der Liste stehen. Innerhalb von etwa 20 Sekunden (die Console prüft das Log von Hermes Agent alle 20 Sekunden) zeigt sie deine ID:

   [PlayNHost] Telegram user 123456789 messaged your agent and was ignored. If that is you, add 123456789 to the Telegram user IDs on the Agent page, then restart.

5. Tippe die Zahl unter Wer ihm schreiben darf bei Telegram-Nutzer-IDs ein und drücke Speichern. Mehrere IDs kommen in eine Zeile, getrennt durch Kommas oder Leerzeichen.
6. Die Seite zeigt „Änderungen gelten ab dem nächsten Start deines Agents.“ Drücke Jetzt neu starten. Die Console bestätigt dann:

   [PlayNHost] Telegram: only user 123456789 can message your agent.

7. Schreibe deinem Bot. Dein Agent antwortet. Nachrichten von jedem anderen Telegram-Konto werden ignoriert, und jeder neue Absender, der dem Bot direkt schreibt, erscheint pro Start einmal in der Console, sodass du einen Freund auf dieselbe Weise hinzufügen kannst.

Was PlayNHost für dich einstellt

• Die IDs auf der Seite Agent erreichen Hermes Agent als TELEGRAM_ALLOWED_USERS. Jeder andere Weg, Leute hereinzulassen (Allow-all-Schalter, andere Allowlists, Gruppenfreigaben, Pairing-Freigaben), wird bei jedem Start abgeschaltet, und der Agent wird gestoppt, wenn einer davon während des Betriebs auftaucht.
• Fremde werden ignoriert (unauthorized_dm_behavior: ignore), statt den standardmäßigen Pairing-Code von Hermes Agent zu bekommen, denn ein PlayNHost-Server hat keine Kommandozeile, mit der man einen Code freigeben könnte.
• Das Token erreicht Hermes Agent als TELEGRAM_BOT_TOKEN. Eine Kopie davon in .hermes/.env wird beim nächsten Start entfernt, damit das Token auf der Seite Agent das verwendete ist.
• Nur Telegram und Discord sind aktiv. WhatsApp wird abgelehnt: Laut eigener Dokumentation von Hermes Agent emuliert seine WhatsApp-Bridge eine WhatsApp-Web-Sitzung und birgt ein Sperrrisiko.

Schritt 3 auf deiner eigenen Maschine

1. Starte den Einrichtungsassistenten und wähle Telegram. Er fragt nach dem Token und den erlaubten Nutzer-IDs und schreibt sie für dich:

   hermes gateway setup

2. Oder trage sie von Hand in ~/.hermes/.env ein:

   TELEGRAM_BOT_TOKEN=123456789:ABCdefGHIjklMNOpqrSTUvwxYZ
   TELEGRAM_ALLOWED_USERS=123456789

   Mehrere IDs werden durch Kommas getrennt.
3. Starte das Gateway mit hermes gateway und schreibe deinem Bot eine Nachricht. Damit es nach dem Abmelden weiterläuft, siehe Hermes Agent 24/7 betreiben: VPS oder gehostet.

Ohne jede Allowlist verweigert Hermes Agent allen den Zugriff. Sein Standard für Fremde ist ein Pairing-Code, den du mit hermes pairing approve telegram <code> freigibst; Codes laufen nach einer Stunde ab. Die Dokumentation von Hermes Agent bietet auch GATEWAY_ALLOW_ALL_USERS=true an und warnt bei einem Bot, der Befehle ausführen kann, davor.

Wenn er nicht antwortet

Bei PlayNHost ist das eigene Log von Hermes Agent .hermes/logs/gateway.log unter Files. Du willst auch Discord? Siehe Hermes Agent mit Discord verbinden. Noch nicht eingerichtet? Erstelle einen Server für Hermes Agent.

PlayNHost ist nicht mit Nous Research verbunden. Hermes Agent ist Open-Source-Software unter der MIT-Lizenz.