Hermes Agent et Telegram : piloter les tâches sur téléphone

Vous pouvez envoyer des messages à Hermes Agent ou lui dicter des tâches dans Telegram depuis votre téléphone lorsque vous êtes loin de votre ordinateur, puis recevoir le résultat dans la même conversation. Les résultats des tâches planifiées arrivent une seule fois dans la conversation que vous désignez comme votre conversation d’accueil.

Si vous n’avez pas encore Hermes, commencez par le guide sur ce qu’est cet agent et comment l’installer, puis revenez pour connecter Telegram.

Des instructions supplémentaires sont disponibles dans la documentation d’Ailoot.

De quoi avez-vous besoin pour connecter Hermes Agent à Telegram ?#

La commande hermes doctor vérifie votre installation d’Hermes et la connexion au modèle. Nous allons créer le bot dans l’application Telegram, et vous aurez besoin d’un ordinateur pour exécuter des commandes dans le terminal.

Comment créer le bot Telegram pour Hermes Agent ?#

Chaque bot Telegram possède un jeton — une clé secrète qui permet de le contrôler. Il est délivré par le bot officiel de Telegram, @BotFather.

1. Ouvrir @BotFather

   Recherchez @BotFather dans Telegram ou ouvrez t.me/BotFather. Le vrai BotFather porte une coche bleue de vérification. Appuyez sur « Start » pour commencer la conversation.

2. Envoyer la commande /newbot

   BotFather vous demandera deux noms. Le premier est le nom d’affichage ; il peut être quelconque, par exemple « Mon agent ». Le second est le nom d’utilisateur : il doit être unique et se terminer par bot, par exemple moy_agent_bot.

3. Obtenir le jeton

   BotFather vous enverra un message de félicitations et une longue chaîne au format 123456789:ABCdefGHIjklMNOpqrSTUvwxYZ. C’est le jeton du bot. Copiez la chaîne entière.

Il existe aussi une méthode rapide qui ne nécessite pas de conversation manuelle avec BotFather. Dans le tableau de bord Web d’Hermes (hermes dashboard) et dans l’application de bureau, la page « Messaging → Telegram » comporte un bouton « Create with QR » : scannez le code avec votre téléphone, et Hermes crée un bot, détecte votre ID, enregistre le jeton dans les paramètres et redémarre la passerelle. Les étapes ci-dessous décrivent la méthode manuelle ; si vous avez choisi le QR code, passez directement à la vérification de la connexion.

Comment trouver votre ID Telegram, et pourquoi en avez-vous besoin ?#

Un compte Telegram possède deux identifiants : un nom d’utilisateur public précédé de @ et un ID numérique interne. Hermes utilise le numéro.

La méthode rapide « Create with QR » décrite plus haut détecte automatiquement votre ID. Notez-le à côté de votre jeton.

Comment fournir le jeton à Hermes Agent et démarrer la passerelle ?#

1. Lancer l’assistant de configuration

   hermes gateway setup
   

   Exécutez la commande sur la machine où Hermes est installé. L’assistant vous proposera une liste d’applications de messagerie.

2. Sélectionner Telegram et saisir vos informations

   L’assistant vous demandera le jeton du bot et les ID autorisés (vous pouvez en saisir plusieurs, séparés par des virgules) et enregistrera le tout directement dans les paramètres.

3. Démarrer la passerelle

   hermes gateway
   

   La passerelle démarre et se connecte à Telegram. Après quelques secondes, envoyez n’importe quel message à votre bot depuis l’application : si Hermes répond, la connexion est prête.

Avec la méthode manuelle, au lieu d’utiliser l’assistant, ouvrez le fichier ~/.hermes/.env et ajoutez deux lignes, en remplaçant les valeurs par le jeton de BotFather et votre ID numérique :

TELEGRAM_BOT_TOKEN=123456789:ABCdefGHIjklMNOpqrSTUvwxYZ
TELEGRAM_ALLOWED_USERS=123456789

La deuxième ligne autorise ces personnes dans les chats privés et groupes ; une autorisation séparée du groupe peut aussi ouvrir l’accès. Séparez les personnes par des virgules. Après avoir enregistré le fichier, démarrez la passerelle avec la même commande hermes gateway.

Si le bot reste silencieux même dans une conversation privée, consultez les journaux de la passerelle dans le même terminal et vérifiez d’abord le jeton et votre ID dans la liste d’accès ; les autres erreurs sont présentées dans le tableau à la fin de l’article.

Que peut faire le bot Telegram sur votre téléphone ?#

Voici les cinq fonctionnalités dont vous aurez le plus souvent besoin sur votre téléphone.

Messages texte et vocaux. Rédigez une tâche ou dictez un message vocal — si la reconnaissance vocale est configurée, Hermes le transcrira et le comprendra. Avec un fournisseur local, aucune clé n’est nécessaire ; tout est traité sur la machine où l’agent s’exécute.

Fichiers et images. Vous pouvez transférer un document, une feuille de calcul ou une capture d’écran au bot — l’agent le recevra en pièce jointe. Il peut aussi vous renvoyer des fichiers générés : demandez un rapport, et il vous l’enverra sous forme de fichier dans la conversation.

Confirmations pour les actions dangereuses. Lorsque l’agent s’apprête à faire quelque chose de risqué, comme supprimer des fichiers, il vous demande d’abord dans la conversation : répondez « yes » ou « y » pour qu’il le fasse ; répondez « no » ou « n » pour qu’il annule.

Des boutons plutôt que de taper une réponse. Lorsque l’agent a besoin d’une précision, il envoie une question avec des boutons de choix intégrés — appuyez sur une option, et l’agent reprend son travail. La commande /model sans arguments affiche un menu de sélection du modèle avec le même type de boutons.

Notifications discrètes. Par défaut, votre téléphone ne sonne que pour les réponses finales, les demandes de confirmation et les confirmations de commande. Les notifications de service telles que « calling a tool » et « compressing context » arrivent en silence, pour éviter que votre téléphone sonne à chaque étape. Si vous souhaitez des notifications sonores à chaque étape, changez le mode dans les paramètres.

Comment recevoir dans la conversation les résultats des tâches en arrière-plan ?#

Conversation d’accueil pour les tâches planifiées. Hermes prend en charge les tâches planifiées : « chaque matin à 7:43, prépare-moi un résumé ». Il envoie les résultats dans la conversation d’accueil, que vous désignez une seule fois en envoyant la commande /sethome directement dans la conversation avec le bot. Tant que la passerelle fonctionne, les résumés arrivent automatiquement.

Tâches en arrière-plan. Vous pouvez envoyer une longue tâche à exécuter en arrière-plan et poursuivre votre journée : le bot vous enverra un message lorsqu’elle sera terminée. Une tâche lancée depuis un sujet renverra sa réponse dans ce même sujet, pour que rien ne se perde.

Limitation importante : le bot ne répond que lorsque la passerelle fonctionne. Si vous éteignez l’ordinateur où Hermes s’exécute ou le mettez en veille, le bot ne répondra plus jusqu’à ce que la machine soit de nouveau en marche. Pour que le bot reste en ligne en permanence, déplacez l’agent sur un serveur : nous avons un guide distinct sur comment faire fonctionner Hermes Agent en continu. Par défaut, la passerelle interroge Telegram pour récupérer les nouveaux messages ; pour les plateformes cloud qui se mettent en veille en l’absence de trafic entrant, la documentation propose un mode webhook, qui inverse le sens de la connexion afin que Telegram envoie lui-même des requêtes au bot.

Comment empêcher les inconnus d’utiliser le bot ?#

Votre bot peut être trouvé dans la recherche Telegram à l’aide de son nom d’utilisateur ; sa protection repose donc sur deux éléments : la liste d’accès et la confidentialité du jeton.

Configurez d’abord les expéditeurs avec TELEGRAM_ALLOWED_USERS. Dans les groupes, inspectez aussi TELEGRAM_GROUP_ALLOWED_CHATS : un chat listé autorise tous ses membres, même absents de la liste personnelle. Une liste personnelle vide ne prouve donc pas que tous les groupes sont fermés.

Ensuite, il y a le jeton. Il ne doit pas apparaître dans des captures d’écran, des messages transférés ou des dépôts. Si le jeton est divulgué, révoquez-le avec la commande /revoke auprès de BotFather. Saisissez ensuite le nouveau jeton dans les paramètres et redémarrez la passerelle.

Dans les groupes, autorisation de l’expéditeur et autorisation du chat sont distinctes. Un membre d’un groupe permis par TELEGRAM_GROUP_ALLOWED_CHATS peut utiliser le bot sans figurer dans TELEGRAM_ALLOWED_USERS. Pour un accès individuel, n’autorisez pas le groupe entier ; configurez et vérifiez les restrictions d’expéditeur de la version installée. Si vous voulez que le bot ne réponde dans un groupe que lorsqu’on l’interpelle, utilisez le paramètre telegram.require_mention — il répondra alors à une mention @, à une réponse à son message, à une commande telle que /command@yourbot et aux correspondances avec vos motifs dans telegram.mention_patterns, tout en ignorant les messages ordinaires du groupe.

Pourquoi le bot reste-t-il silencieux dans un groupe, et comment y remédier ?#

Le mode de confidentialité est activé par défaut pour les nouveaux bots Telegram ; la documentation d’Hermes le décrit comme la source de confusion la plus courante concernant les bots dans les groupes. Dans ce mode, le bot ne reçoit que les messages commençant par une commande /, les réponses à ses propres messages et les notifications de service. Il ne reçoit tout simplement pas les messages ordinaires du groupe — Telegram ne les lui envoie pas, et aucun réglage de l’agent ne peut y remédier.

Comment résoudre le problème :

1. Ouvrez @BotFather et envoyez /mybots.
2. Sélectionnez votre bot.
3. Ouvrez « Bot Settings » → « Group Privacy » → « Turn off ».
4. Retirez le bot du groupe et ajoutez-le de nouveau.

La quatrième étape est facile à oublier ; le bot « reste alors silencieux ». Telegram mémorise le réglage de confidentialité en vigueur lorsque le bot a rejoint le groupe et ne le met pas à jour tant que le bot n’est pas retiré du groupe puis ajouté de nouveau.

Si vous ne voulez pas désactiver la confidentialité globalement, une deuxième option consiste à nommer le bot administrateur du groupe. Les bots administrateurs reçoivent tous les messages, quel que soit le mode de confidentialité.

Erreurs de connexion courantes et solutions#

Quelles autres questions les gens posent-ils sur Hermes Agent dans Telegram ?#

Quand vous serez prêt, découvrez Ailoot.