Hermes Agent koppelen aan Telegram

Kort antwoord. Maak in Telegram een bot met @BotFather (/newbot) en kopieer het token. Geef Hermes Agent het token en je numerieke Telegram-gebruikers-ID: alleen de ID's op zijn toegangslijst, of mensen die je goedkeurt met een koppelcode, kunnen ermee praten; zonder toegangslijst krijgt een vreemde alleen een koppelcode die jij zou moeten goedkeuren. Op je eigen machine zijn dat TELEGRAM_BOT_TOKEN en TELEGRAM_ALLOWED_USERS in ~/.hermes/.env, of hermes gateway setup. Op PlayNHost plak je het token en je ID op de pagina Agent en herstart je.

Gecontroleerd op 7 november 2026, geldig voor Hermes Agent v0.23.0.

Deze gids gebruikt de Telegram- en beveiligingsdocumentatie van Hermes Agent en het PlayNHost-paneel zoals het nu werkt. Telegram-ondersteuning zit ingebouwd in de berichtengateway van Hermes Agent: je hoeft niets extra te installeren.

Stap 1: maak de bot en kopieer het token

1. Open in Telegram een chat met @BotFather (of t.me/BotFather). Controleer of de naam precies @BotFather is.
2. Stuur /newbot, kies een weergavenaam en daarna een gebruikersnaam die eindigt op bot.
3. BotFather antwoordt met het token, dat eruitziet als 123456789:ABCdefGHIjklMNOpqrSTUvwxYZ. Houd het privé: iedereen die het heeft kan je bot besturen. Lekt het uit, trek het dan in met /revoke in BotFather.

Eén programma per bot. De FAQ van Hermes Agent zegt dat elk chatplatform exclusief gebruik van een bottoken nodig heeft. Gebruikt een oudere kopie van Hermes Agent, of een ander programma, hetzelfde token nog, stop die dan eerst of maak een nieuwe bot.

Stap 2: zoek je Telegram-gebruikers-ID

De toegangslijst van Hermes Agent wil je numerieke gebruikers-ID, een getal zoals 123456789, niet je @gebruikersnaam. Zo kom je eraan:

• Op PlayNHost, via de console. Stuur je bot een bericht voordat je een ID hebt ingesteld: de console toont je ID. Details bij stap 3 hieronder.
• Uit het log van Hermes Agent. Als iemand die niet op de lijst staat een direct bericht stuurt, krijgt zijn log (~/.hermes/logs/gateway.log) een waarschuwing die begint met "Unauthorized user" en het numerieke ID van de afzender (tussen haakjes achter de naam wanneer vreemden worden genegeerd, zoals op PlayNHost).
• Een bot van derden. De documentatie van Hermes Agent stelt @userinfobot of @get_id_bot voor, die met je ID antwoorden.

Stap 3 op PlayNHost: plak het token en je ID

Op dezelfde pagina heb je een sleutel van een AI-provider nodig. Zonder die stopt Starten met "Your agent is not set up yet: it needs an API key from one AI provider and a Telegram or Discord bot token."

1. Open je server op panel.playnhost.com en dan het tabblad Agent.
2. Stel onder AI-provider één sleutel in als je dat nog niet hebt gedaan (zie welke sleutel van een AI-provider je gebruikt).
3. Druk onder Chat-apps op Instellen bij Telegram-bottoken, plak het token van BotFather en druk op Opslaan. Het paneel controleert de vorm; een verkeerde plak geeft "That is not a valid telegram bot token." Eenmaal opgeslagen toont de rij alleen de laatste vier tekens, en het token wordt nooit meer getoond.
4. Weet je je ID nog niet? Laat Telegram-gebruikers-ID’s leeg en druk op Starten. De eerste start installeert Hermes Agent, wat in onze tests ongeveer 2,5 tot 4 minuten duurde. Als de agent draait, toont de console:

   [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.

   Stuur je bot in Telegram een bericht. Hij antwoordt niet, ook niet met een koppelcode: op PlayNHost negeert Hermes Agent iedereen die niet op de lijst staat. Binnen ongeveer 20 seconden (de console controleert het log van Hermes Agent elke 20 seconden) toont hij je 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. Typ onder Wie hem mag berichten het getal in Telegram-gebruikers-ID’s en druk op Opslaan. Meerdere ID's staan op één regel, gescheiden door komma's of spaties.
6. De pagina zegt "Wijzigingen gelden de volgende keer dat je agent start." Druk op Nu herstarten. De console bevestigt dan:

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

7. Stuur je bot een bericht. Je agent antwoordt. Berichten van elk ander Telegram-account worden genegeerd, en elke nieuwe afzender die de bot direct een bericht stuurt, verschijnt één keer per start in de console, zodat je op dezelfde manier een vriend kunt toevoegen.

Wat PlayNHost voor je instelt

• De ID's op de pagina Agent komen bij Hermes Agent aan als TELEGRAM_ALLOWED_USERS. Elke andere manier om mensen binnen te laten (allow-all-schakelaars, andere toegangslijsten, groepsrechten, koppelgoedkeuringen) wordt bij elke start uitgezet, en de agent wordt gestopt als er een verschijnt terwijl hij draait.
• Vreemden worden genegeerd (unauthorized_dm_behavior: ignore) in plaats van de standaardkoppelcode van Hermes Agent te krijgen, omdat een PlayNHost-server geen opdrachtregel heeft om een code mee goed te keuren.
• Het token komt bij Hermes Agent aan als TELEGRAM_BOT_TOKEN. Een kopie ervan die in .hermes/.env is geschreven, wordt bij de volgende start verwijderd, zodat het token op de pagina Agent het token is dat gebruikt wordt.
• Alleen Telegram en Discord staan aan. WhatsApp wordt geweigerd: de eigen documentatie van Hermes Agent zegt dat de WhatsApp-bridge een WhatsApp Web-sessie nabootst en een risico op een ban met zich meebrengt.

Stap 3 op je eigen machine

1. Draai de installatiewizard en kies Telegram. Die vraagt om het token en de toegestane gebruikers-ID's en schrijft ze voor je weg:

   hermes gateway setup

2. Of voeg ze met de hand toe aan ~/.hermes/.env:

   TELEGRAM_BOT_TOKEN=123456789:ABCdefGHIjklMNOpqrSTUvwxYZ
   TELEGRAM_ALLOWED_USERS=123456789

   Meerdere ID's worden door komma's gescheiden.
3. Start de gateway met hermes gateway en stuur je bot een bericht. Om hem te laten draaien nadat je uitlogt, zie Hermes Agent 24/7 draaien.

Zonder toegangslijst weigert Hermes Agent iedereen. Zijn standaard voor vreemden is een koppelcode die je goedkeurt met hermes pairing approve telegram <code>; codes verlopen na een uur. De documentatie van Hermes Agent biedt ook GATEWAY_ALLOW_ALL_USERS=true, en waarschuwt ertegen voor een bot die opdrachten kan uitvoeren.

Als hij niet antwoordt

Op PlayNHost is het eigen log van Hermes Agent .hermes/logs/gateway.log in Files. Wil je ook Discord? Zie Hermes Agent koppelen aan Discord. Nog niet ingesteld? Maak een Hermes Agent-server aan.

PlayNHost is niet verbonden aan Nous Research. Hermes Agent is open-sourcesoftware onder de MIT-licentie.