Hoe verbind je Hermes Agent met Telegram en beheer je taken vanaf je telefoon

Je kunt Hermes Agent via Telegram berichten sturen of taken dicteren vanaf je telefoon wanneer je niet bij je computer bent, en het resultaat in dezelfde chat ontvangen. Resultaten van geplande taken komen één keer aan in de chat die je als je thu chat aanwijst.

Als je Hermes nog niet hebt, begin dan met de gids over wat deze agent is en hoe je hem installeert en kom daarna terug om Telegram te verbinden.

Aanvullende instructies vind je in de Ailoot-documentatie.

Wat heb je nodig om Hermes Agent met Telegram te verbinden?#

Met de opdracht hermes doctor controleer je je Hermes-installatie en de verbinding met het model. We maken de bot in de Telegram-app; je hebt een computer nodig om opdrachten in de terminal uit te voeren.

Hoe maak je een bot via BotFather?#

Elke Telegram-bot heeft een token: een geheime sleutel om de bot te besturen. Dit wordt uitgegeven door de officiële Telegram-bot @BotFather.

1. Open @BotFather

   Zoek in Telegram naar @BotFather of open t.me/BotFather. De echte BotFather heeft een blauw verificatievinkje. Tik op “Start” om het gesprek te beginnen.

2. Stuur de opdracht /newbot

   BotFather vraagt om twee namen. De eerste is de weergavenaam; die mag van alles zijn, bijvoorbeeld “My Agent.” De tweede is de gebruikersnaam: die moet uniek zijn en eindigen op bot, bijvoorbeeld moy_agent_bot.

3. Haal het token op

   BotFather stuurt een felicitatiebericht en een lange tekenreeks in de vorm 123456789:ABCdefGHIjklMNOpqrSTUvwxYZ. Dit is het bottoken. Kopieer de volledige tekenreeks.

Er is ook een snelle manier waarvoor je BotFather niet handmatig hoeft te benaderen. In het Hermes-webdashboard (hermes dashboard) en in de desktopapp staat op de pagina “Messaging → Telegram” een knop “Create with QR”: scan de code met je telefoon en Hermes maakt een bot aan, detecteert je ID, slaat het token op in de instellingen en herstart de gateway. De onderstaande stappen beschrijven de handmatige methode; als je QR hebt gekozen, ga dan direct naar de verbindingscontrole.

Hoe vind je je Telegram-ID en waarom heb je die nodig?#

Een Telegram-account heeft twee identificatiegegevens: een openbare gebruikersnaam met een @-teken en een interne numerieke ID. Hermes gebruikt het nummer.

De snelle methode “Create with QR” hierboven detecteert je ID automatisch. Noteer die naast je token.

Hoe geef je het token aan Hermes Agent en start je de gateway?#

1. Start de installatiewizard

   hermes gateway setup
   

   Voer de opdracht uit op de machine waarop Hermes is geïnstalleerd. De wizard biedt een lijst met berichtenapps aan.

2. Selecteer Telegram en voer je gegevens in

   De wizard vraagt om het bottoken en de toegestane ID's (je kunt er meerdere invoeren, gescheiden door komma's) en slaat alles op in de instellingen zelf.

3. Start de gateway

   hermes gateway
   

   De gateway start en maakt verbinding met Telegram. Stuur na een paar seconden een willekeurig bericht naar je bot vanuit de app: als Hermes antwoordt, is de verbinding klaar.

De handmatige methode zonder wizard ziet er zo uit: open het bestand ~/.hermes/.env en voeg twee regels toe. Vervang daarin de waarden door het token van BotFather en je numerieke ID:

TELEGRAM_BOT_TOKEN=123456789:ABCdefGHIjklMNOpqrSTUvwxYZ
TELEGRAM_ALLOWED_USERS=123456789

De tweede regel geeft die mensen toegang in privéchats en groepen; afzonderlijke groepschatautorisatie kan ook toegang verlenen. Scheid meerdere mensen met komma's. Sla het bestand op en start de gateway met dezelfde opdracht hermes gateway.

Als de bot zelfs in een privéchat stil blijft, controleer dan de gatewaylogs in dezelfde terminal en controleer eerst of het token en je ID in de toegangs lijst kloppen; andere fouten staan in de tabel aan het einde van het artikel.

Wat kan de Telegram-bot op je telefoon doen?#

Er zijn vijf mogelijkheden die je op je telefoon het vaakst nodig hebt.

Tekst- en spraakberichten. Schrijf een taak in woorden of spreek een spraakbericht in — als spraakherkenning is ingesteld, zet Hermes het om in tekst en begrijpt het. Met een lokale provider zijn geen sleutels nodig; alles wordt verwerkt op de machine waarop de agent draait.

Bestanden en afbeeldingen. Je kunt een document, spreadsheet of schermafbeelding doorsturen naar de bot — de agent ontvangt die als bijlage. De agent kan ook gegenereerde bestanden terugsturen: vraag om een rapport en hij stuurt het als bestand in de chat.

Bevestigingen voor gevaarlijke acties. Wanneer de agent iets riskants wil doen, zoals bestanden verwijderen, vraagt hij dat eerst in de chat: antwoord “yes” of “y” en hij voert het uit; antwoord “no” of “n” en hij annuleert.

Knoppen in plaats van terugtypen. Wanneer de agent om verduidelijking vraagt, stuurt hij een vraag met inline knoppen voor opties — tik op een optie en de agent gaat verder. De opdracht /model zonder argumenten toont een modelkeuzemenu met dezelfde soort knoppen.

Stille meldingen. Standaard gaat je telefoon alleen over bij definitieve antwoorden, toestemmingsverzoeken en bevestigingen van opdrachten. Servicemeldingen zoals “een tool aanroepen” en “context comprimeren” komen stil binnen, zodat je telefoon niet bij elke stap overgaat. Als je bij elke stap geluidsmeldingen wilt, wijzig je de modus in de instellingen.

Hoe ontvang je resultaten van achtergrondtaken in de chat?#

Thu chat voor geplande taken. Hermes ondersteunt geplande taken: “maak elke ochtend om 7:43 een samenvatting voor me.” De resultaten worden naar de thu chat gestuurd, die je eenmalig aanwijst door de opdracht /sethome rechtstreeks in het gesprek met de bot te sturen. Zolang de gateway actief is, komen samenvattingen automatisch binnen.

Achtergrondtaken. Je kunt een lange taak op de achtergrond laten uitvoeren en verdergaan met je dag: de bot stuurt je een bericht wanneer het klaar is. Een taak die vanuit een topic wordt gestart, stuurt het antwoord terug naar datzelfde topic, zodat niets verloren gaat.

Belangrijke beperking: de bot antwoordt alleen wanneer de gateway actief is. Als je de computer waarop Hermes draait uitzet of in de slaapstand zet, antwoordt de bot pas weer wanneer de machine actief is. Verplaats de agent naar een server om de bot altijd online te houden: we hebben een aparte gids over Hermes Agent dag en nacht actief houden. Standaard controleert de gateway Telegram op nieuwe berichten; voor cloudplatforms die in slaapstand gaan wanneer er geen verkeer binnenkomt, biedt de documentatie een webhookmodus. Die keert de verbindingsrichting om, zodat Telegram zelf verzoeken naar de bot stuurt.

Hoe houd je vreemden buiten de bot?#

Je bot kan in Telegram worden gevonden op gebruikersnaam. De bescherming berust dus op twee zaken: de toegangs lijst en het geheimhouden van het token.

Stel eerst afzendertoegang in met TELEGRAM_ALLOWED_USERS. Bekijk voor groepen ook TELEGRAM_GROUP_ALLOWED_CHATS: een chat in die lijst geeft elk lid toegang, ook wanneer diens afzender-ID niet op de persoonlijke toelatingslijst staat. Alleen een lege persoonlijke lijst bewijst dus niet dat elke groep gesloten is.

Ten tweede is er het token. Het mag niet terechtkomen in schermafbeeldingen, doorgestuurde berichten of repositories. Als het token uitlekt, trek je het in met de opdracht /revoke in BotFather. Voer daarna het nieuwe token in bij de instellingen en start de gateway opnieuw.

Een aparte opmerking over groepen: afzenderautorisatie en chatautorisatie zijn verschillend. Een lid van een groep die via TELEGRAM_GROUP_ALLOWED_CHATS is toegestaan kan de bot gebruiken, ook zonder ID in TELEGRAM_ALLOWED_USERS. Moet toegang individueel blijven, geef dan niet de hele groep toegang; stel afzenderbeperkingen voor je geïnstalleerde versie in en controleer die. Als je wilt dat de bot in een groep alleen antwoordt wanneer iemand hem aanspreekt, is er de instelling telegram.require_mention. Dan antwoordt de bot op een @-vermelding, een antwoord op zijn bericht, een opdracht zoals /command@yourbot en overeenkomsten met je patronen in telegram.mention_patterns, terwijl gewone groepsberichten worden genegeerd.

Waarom blijft de bot stil in een groep en hoe los je dat op?#

Bij nieuwe Telegram-bots staat de privacymodus standaard aan; de Hermes-documentatie noemt dit de meest voorkomende bron van verwarring met bots in groepen. In deze modus ontvangt de bot alleen berichten die beginnen met een opdracht met /, antwoorden op zijn eigen berichten en servicemeldingen. Gewone groepsberichten ontvangt hij helemaal niet — Telegram stuurt ze niet naar de bot en geen enkele agentinstelling kan dat oplossen.

Zo los je het op:

1. Open @BotFather en stuur /mybots.
2. Selecteer je bot.
3. Open “Bot Settings” → “Group Privacy” → “Turn off.”
4. Verwijder de bot uit de groep en voeg hem opnieuw toe.

De vierde stap wordt makkelijk vergeten; dan “blijft de bot stil”. Telegram onthoudt de privacyinstelling van het moment waarop de bot lid werd van de groep en werkt die niet bij totdat de bot uit de groep is verwijderd en opnieuw is toegevoegd.

Als je de privacy niet overal wilt uitschakelen, is er een tweede optie: maak de bot groepsbeheerder. Beheerder-bots ontvangen alle berichten, ongeacht de privacymodus.

Veelvoorkomende verbindingsfouten en wat je eraan kunt doen#

Wat vragen mensen nog meer over Hermes Agent in Telegram?#

Ben je er klaar voor? Maak kennis met Ailoot.