Connecter Hermes Agent à Telegram

Réponse courte. Créez un bot avec @BotFather dans Telegram (/newbot) et copiez son token. Donnez à Hermes Agent le token et votre ID utilisateur Telegram numérique : seuls les ID de sa liste d’autorisation, ou les personnes que vous approuvez avec un code d’appairage, peuvent lui parler ; sans liste, un inconnu ne reçoit qu’un code d’appairage que vous devriez approuver. Sur votre propre machine, ce sont TELEGRAM_BOT_TOKEN et TELEGRAM_ALLOWED_USERS dans ~/.hermes/.env, ou hermes gateway setup. Sur PlayNHost, vous collez le token et votre ID sur la page Agent, puis vous redémarrez.

Vérifié le 7 novembre 2026, valable pour Hermes Agent v0.23.0.

Ce guide s’appuie sur la documentation Telegram et sécurité d’Hermes Agent et sur le panel PlayNHost tel qu’il fonctionne aujourd’hui. La prise en charge de Telegram est intégrée à la gateway de messagerie d’Hermes Agent : il n’y a rien de plus à installer.

Étape 1 : créer le bot et copier son token

1. Dans Telegram, ouvrez une conversation avec @BotFather (ou t.me/BotFather). Vérifiez que l’identifiant est exactement @BotFather.
2. Envoyez /newbot, choisissez un nom affiché, puis un nom d’utilisateur qui se termine par bot.
3. BotFather répond avec le token, qui ressemble à 123456789:ABCdefGHIjklMNOpqrSTUvwxYZ. Gardez-le privé : quiconque l’a peut contrôler votre bot. S’il fuite, révoquez-le avec /revoke dans BotFather.

Un seul programme par bot. La FAQ d’Hermes Agent dit que chaque plateforme de chat a besoin d’un usage exclusif du token d’un bot. Si une ancienne copie d’Hermes Agent, ou un autre programme, utilise encore le même token, arrêtez-la d’abord ou créez un nouveau bot.

Étape 2 : trouver votre ID utilisateur Telegram

La liste d’autorisation d’Hermes Agent attend votre ID utilisateur numérique, un nombre comme 123456789, pas votre @nom d’utilisateur. Voici comment l’obtenir :

• Sur PlayNHost, depuis la console. Écrivez à votre bot avant d’avoir défini un ID : la console affiche votre ID. Détails à l’étape 3 ci-dessous.
• Depuis le journal d’Hermes Agent. Quand quelqu’un qui n’est pas sur sa liste envoie un message privé, son journal (~/.hermes/logs/gateway.log) reçoit un avertissement qui commence par « Unauthorized user » avec l’ID numérique de l’expéditeur (entre crochets après son nom quand les inconnus sont ignorés, comme sur PlayNHost).
• Un bot tiers. La documentation d’Hermes Agent suggère @userinfobot ou @get_id_bot, qui répondent avec votre ID.

Étape 3 sur PlayNHost : coller le token et votre ID

Il vous faut une clé de fournisseur d’IA sur la même page. Sans elle, Démarrer s’arrête avec « Your agent is not set up yet: it needs an API key from one AI provider and a Telegram or Discord bot token. »

1. Ouvrez votre serveur sur panel.playnhost.com, puis l’onglet Agent.
2. Sous Fournisseur d’IA, définissez une clé si ce n’est pas déjà fait (voir quelle clé de fournisseur d’IA utiliser avec Hermes Agent).
3. Sous Applis de chat, appuyez sur Définir pour Token du bot Telegram, collez le token de BotFather et appuyez sur Enregistrer. Le panel vérifie sa forme ; un collage erroné donne « That is not a valid telegram bot token. » Une fois enregistré, la ligne n’affiche que les quatre derniers caractères, et le token n’est plus jamais affiché.
4. Vous ne connaissez pas encore votre ID ? Laissez ID utilisateur Telegram vide et appuyez sur Démarrer. Le premier démarrage installe Hermes Agent, ce qui a pris environ 2,5 à 4 minutes dans nos tests. Quand l’agent est en marche, la console affiche :

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

   Envoyez un message à votre bot dans Telegram. Il ne répond pas, pas même avec un code d’appairage : sur PlayNHost, Hermes Agent ignore tous ceux qui ne sont pas sur la liste. En 20 secondes environ (la console consulte le journal d’Hermes Agent toutes les 20 secondes), elle affiche votre 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. Sous Qui peut lui écrire, saisissez le nombre dans ID utilisateur Telegram et appuyez sur Enregistrer. Plusieurs ID vont sur une même ligne, séparés par des virgules ou des espaces.
6. La page affiche « Les changements s’appliquent au prochain démarrage de votre agent. » Appuyez sur Redémarrer maintenant. La console confirme alors :

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

7. Écrivez à votre bot. Votre agent répond. Les messages de tout autre compte Telegram sont ignorés, et chaque nouvel expéditeur qui écrit directement au bot apparaît une fois par démarrage dans la console : vous pouvez donc ajouter un ami de la même façon.

Ce que PlayNHost règle pour vous

• Les ID de la page Agent arrivent chez Hermes Agent sous la forme TELEGRAM_ALLOWED_USERS. Toutes les autres façons de laisser entrer des gens (interrupteurs « autoriser tout le monde », autres listes d’autorisation, accès de groupe, approbations d’appairage) sont désactivées à chaque démarrage, et l’agent est arrêté si l’une d’elles apparaît pendant qu’il tourne.
• Les inconnus sont ignorés (unauthorized_dm_behavior: ignore) au lieu de recevoir le code d’appairage par défaut d’Hermes Agent, parce qu’un serveur PlayNHost n’a pas de ligne de commande pour approuver un code.
• Le token arrive chez Hermes Agent sous la forme TELEGRAM_BOT_TOKEN. Une copie écrite dans .hermes/.env est supprimée au démarrage suivant : le token de la page Agent est donc celui qui sert.
• Seuls Telegram et Discord sont activés. WhatsApp est refusé : la documentation d’Hermes Agent dit elle-même que son pont WhatsApp émule une session WhatsApp Web et comporte un risque de bannissement.

Étape 3 sur votre propre machine

1. Lancez l’assistant de configuration et choisissez Telegram. Il demande le token et les ID utilisateur autorisés, et les écrit pour vous :

   hermes gateway setup

2. Ou ajoutez-les à la main dans ~/.hermes/.env :

   TELEGRAM_BOT_TOKEN=123456789:ABCdefGHIjklMNOpqrSTUvwxYZ
   TELEGRAM_ALLOWED_USERS=123456789

   Plusieurs ID sont séparés par des virgules.
3. Démarrez la gateway avec hermes gateway et envoyez un message à votre bot. Pour qu’elle continue de tourner après votre déconnexion, voir faire tourner Hermes Agent 24/7 : VPS ou hébergé.

Sans aucune liste d’autorisation, Hermes Agent refuse tout le monde. Son comportement par défaut pour les inconnus est un code d’appairage que vous approuvez avec hermes pairing approve telegram <code> ; les codes expirent après une heure. La documentation d’Hermes Agent propose aussi GATEWAY_ALLOW_ALL_USERS=true, et le déconseille pour un bot qui peut exécuter des commandes.

Quand il ne répond pas

Sur PlayNHost, le journal d’Hermes Agent est .hermes/logs/gateway.log dans Files. Vous voulez aussi Discord ? Voir connecter Hermes Agent à Discord. Pas encore configuré ? Créez un serveur Hermes Agent.

PlayNHost n’est pas affilié à Nous Research. Hermes Agent est un logiciel open source sous licence MIT.