Connecter Hermes Agent à Telegram

Étape 1 : Créer un robot Telegram

Ouvrez Telegram et recherchez @BotFather — l'outil officiel de gestion de robots de Telegram. Démarrez une conversation et envoyez :

/newbot

BotFather vous demandera un nom et un nom d'utilisateur (doit se terminer par bot, par ex. HermesAssistantBot). Une fois créé, BotFather vous donne un jeton API — une longue chaîne comme :

1234567890:***

Conservez ce jeton en lieu sûr. Toute personne qui le possède peut contrôler votre robot. Traitez-le comme un mot de passe.

Étape 2 : Configurer la passerelle Telegram

Ouvrez votre fichier de configuration Hermes à ~/.hermes/config.yaml et ajoutez ou mettez à jour la section passerelle :

gateway:
  telegram:
    enabled: true
    token: "1234567890:***"
    # Optionnel : restreindre à des utilisateurs spécifiques par ID Telegram
    # allowed_users:
    #   - 123456789

Pour une utilisation en production, stockez le jeton dans ~/.hermes/.env et référencez-le via une variable d'environnement au lieu de le coder en dur :

gateway:
  telegram:
    enabled: true
    token: ${TELEGRAM_BOT_TOKEN}

Puis ajoutez à ~/.hermes/.env :

TELEGRAM_BOT_TOKEN=1234567890:***

Étape 3 : Démarrer la passerelle

Avec votre configuration en place, démarrez le service de passerelle Hermes :

hermes gateway start

Vous devriez voir une sortie confirmant que la passerelle Telegram est connectée et à l'écoute. La passerelle s'exécute comme un processus d'arrière-plan qui fait le pont entre les messages Telegram et votre agent Hermes.

Pour la faire fonctionner de façon persistante, envisagez de l'exécuter sous launchd (macOS) ou systemd (Linux).

Étape 4 : Tester votre robot

Ouvrez Telegram et trouvez votre robot par son nom d'utilisateur (celui que vous avez enregistré auprès de BotFather). Envoyez un message pour démarrer une conversation :

/help

Votre agent Hermes devrait répondre avec un message d'aide listant les commandes et capacités disponibles. Essayez une vraie requête :

Qu'est-ce qu'il y a dans mon calendrier aujourd'hui?

Si le robot ne répond pas, vérifiez :

• La passerelle est en cours d'exécution — hermes gateway status
• Le jeton est correct dans votre configuration
• Votre pare-feu autorise les connexions HTTPS sortantes vers api.telegram.org
• Consultez les journaux de la passerelle : hermes gateway logs

Sécurité et contrôle d'accès

Par défaut, toute personne qui trouve le nom d'utilisateur de votre robot peut lui envoyer des messages. Pour restreindre l'accès :

• Utilisateurs autorisés : Ajoutez allowed_users avec votre ID utilisateur Telegram dans config.yaml. Votre ID utilisateur peut être trouvé en envoyant un message à @userinfobot sur Telegram.
• Liste blanche de commandes : Restreignez les capacités Hermes disponibles via Telegram (par ex., outils en lecture seule vs. accès en écriture).
• Limitation de débit : La passerelle inclut une limitation de débit de base pour prévenir les abus.

Considérations sur la confidentialité

Telegram est une plateforme de messagerie infonuagique. Gardez ces points à l'esprit :

• Les messages transitent par les serveurs de Telegram : Vos requêtes et les réponses de Hermes passent par l'infrastructure de Telegram. Telegram utilise un transport chiffré (MTProto), mais les messages sont stockés sur leurs serveurs pour la synchronisation entre vos appareils.
• Les messages des robots ne sont pas chiffrés de bout en bout : Contrairement aux « discussions secrètes » de Telegram, les conversations avec les robots utilisent un chiffrement standard côté serveur. Le jeton du robot donne accès à tous les messages envoyés au robot.
• Résidence des données : Les serveurs de Telegram sont répartis mondialement. Pour les organisations canadiennes qui traitent des renseignements personnels en vertu de la LPRPDE, évaluez si la messagerie infonuagique correspond à vos exigences de traitement des données.
• Recommandation : Évitez d'envoyer des renseignements personnels sensibles, des identifiants ou des données réglementées via la passerelle Telegram. Utilisez l'ILC local pour les flux de travail sensibles.