Connecter Telegram a Hermes Agent : guide complet

Introduction

Telegram est l'une des plateformes de messagerie les plus utilisees avec Hermes Agent. Une fois connecte, vous pouvez parler a votre agent depuis n'importe quel appareil ou Telegram est installe, que ce soit en message prive, dans un groupe ou via un canal.

Cette page couvre l'ensemble du processus : creation du bot, configuration, mise en service et bonnes pratiques.

Question couverte

q-121: Comment connecter Telegram a Hermes Agent ?

La connexion se fait en quatre etapes.

Etape 1 : Creer un bot Telegram

1. Ouvrez Telegram et cherchez @BotFather
2. Envoyez /newbot et suivez les instructions
3. Choisissez un nom (ex: "Mon Assistant Hermes") et un username (ex: MonHermesBot)
4. BotFather vous donne un token (ex: 1234567890:ABCdefGHIjklMNOpqrsTUVwxyz)

Gardez ce token en lieu sur : c'est le mot de passe de votre bot.

Etape 2 : Configurer Hermes Agent

Ajoutez le token dans ~/.hermes/.env :

TELEGRAM_BOT_TOKEN=1234567890:ABCdefGHIjklMNOpqrsTUVwxyz

Activez Telegram dans ~/.hermes/config.yaml :

platforms:
  telegram:
    enabled: true

Etape 3 : Configurer l'acces

Par defaut, si aucune allowlist n'est configuree, tous les utilisateurs sont refuses. Ajoutez votre ID Telegram dans ~/.hermes/.env :

TELEGRAM_ALLOWED_USERS=123456789

Pour trouver votre ID Telegram, envoyez un message a @RawDataBot ou utilisez l'API Telegram.

Etape 4 : Lancer le gateway

hermes gateway run

Votre bot Telegram est maintenant en ligne. Envoyez-lui un message sur Telegram pour verifier.

Pour un fonctionnement permanent, installez le gateway comme service :

hermes gateway install

Utilisation dans Telegram

Commandes slash disponibles

Toutes les commandes slash Hermes sont disponibles dans Telegram :

Groupes Telegram

Pour utiliser Hermes dans un groupe :

1. Ajoutez le bot au groupe
2. Donnez-lui les permissions de lecture des messages
3. Mentionnez le bot avec @MonHermesBot pour lui parler directement
4. Le bot repond en thread ou en mention selon la configuration

Canaux Telegram

Pour recevoir les resultats de crons dans un canal :

hermes cron create "0 9 * * *" "Rapport quotidien" \
  --deliver "telegram:-100123456789"

L'ID d'un canal commence par -100. Pour le trouver, envoyez un message dans le canal et utilisez https://api.telegram.org/bot<VOTRE_TOKEN>/getUpdates.

Topic cron dedie

Vous pouvez configurer un topic Telegram dedie aux livraisons de cron :

export TELEGRAM_CRON_THREAD_ID=12345

Tous les resultats de cron seront livres dans ce topic specifique.

Securite

• Allowlists : configurez TELEGRAM_ALLOWED_USERS pour restreindre l'acces
• Pairing DM : les utilisateurs inconnus recoivent un code de pairing a faire approuver par l'operateur
• PII redaction : activez privacy.redact_pii: true pour hacher les identifiants Telegram avant transmission au LLM
• Token : ne partagez jamais votre token de bot ; stockez-le uniquement dans .env (permissions 600)

Depannage

Sources

• Documentation officielle Hermes Agent (https://hermes-agent.nousresearch.com/docs/)
• Guide Team Telegram Assistant (https://hermes-agent.nousresearch.com/docs/guides/team-telegram-assistant)
• Guide de securite officiel (https://hermes-agent.nousresearch.com/docs/user-guide/security)
• Depot NousResearch/hermes-agent, commit b4f8c491

Liens internes proposes

• Canaux et gateway
• Discord
• Securite
• Automatiser avec Hermes Agent
• FAQ
• Sources