Hermes Agent sur Telegram : le guide de setup complet

Telegram est la maison naturelle d'un agent IA personnel, et Hermes Agent le supporte en première classe : gateway en polling, pairing DM pour la sécurité, messages vocaux gérés d'origine. Hermes couvre plus de 20 plateformes de messagerie, mais Telegram reste la plus rapide à mettre en place : créer une identité de bot prend 30 secondes (docs officielles, 2026).

Ce guide déroule tout : créer le bot, installer le runtime, brancher le gateway, le verrouiller, et le garder en vie 24/7. À la fin, le raccourci pour ceux qui préfèrent ne jamais ouvrir un terminal.

---

Ce qu'il te faut avant de commencer

Quatre choses, dont une seule coûte de l'argent :

• Un token de bot Telegram via BotFather (gratuit, 30 secondes)
• Un serveur Linux pour du 24/7 : 2 vCPU / 4 Go de RAM suffisent largement (dès 5 $/mois), ou ta machine pour tester
• Python 3.11+ et uv : l'installeur s'en occupe sur une machine fraîche
• Un provider IA : une clé API (OpenAI, Anthropic, Google, OpenRouter) ou, plus économique, ton abonnement ChatGPT Plus via l'OAuth Codex natif d'Hermes

Si la partie serveur te semble déjà une corvée, notre guide d'hébergement Hermes Agent compare toutes les façons de le faire tourner, du VPS DIY au managé.

---

Étape 1 : crée ton bot avec BotFather

Ouvre Telegram, cherche @BotFather (le compte vérifié), envoie /newbot. Choisis un nom d'affichage, puis un username qui finit par bot. BotFather te répond avec un token du type 1234567890:ABCdef....

Ce token est un identifiant sensible, pas un détail. Qui le détient contrôle ton bot. Range-le comme un mot de passe, et s'il fuit un jour, /revoke dans BotFather le remplace instantanément.

---

Étape 2 : installe Hermes Agent

Sur ton serveur, une ligne fait le gros du travail :

curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash

L'installeur vérifie Python, installe uv s'il manque, et met le runtime en place. Cette simplicité explique en partie la courbe d'adoption : plus de 100 000 étoiles GitHub en sept semaines après le lancement de février 2026 (Krzysztof Słomka, 2026).

Choisis ensuite ton provider avec l'assistant interactif :

hermes model

Prends un provider à clé API, ou sélectionne OpenAI Codex pour t'authentifier avec ton abonnement ChatGPT Plus par device code. Cette seconde option signifie zéro coût IA marginal, ce qui change l'économie d'un agent qui tourne toute la journée.

---

Étape 3 : configure le gateway Telegram

Donne ton token de bot à Hermes dans ~/.hermes/.env :

TELEGRAM_BOT_TOKEN=1234567890:ABCdef...

Puis lance le gateway :

hermes gateway run

Envoie un message à ton bot sur Telegram. Si tout est branché, tu obtiens une réponse, et surtout un passage obligé s'exécute d'abord : le contrôle de sécurité.

---

Étape 4 : comprends le pairing DM (ne saute pas cette étape)

Par défaut, sans allowlist configurée, Hermes Agent ne répond pas aux inconnus. Un utilisateur inconnu reçoit un code d'appairage à usage unique, et le propriétaire du bot l'approuve depuis le serveur :

hermes pairing approve telegram <CODE>

Les codes expirent au bout d'une heure, et les échecs répétés déclenchent un verrouillage. C'est le bon réglage par défaut pour un agent qui peut détenir ton agenda, tes fichiers et tes clés API. Résiste à la tentation du TELEGRAM_ALLOW_ALL_USERS=true, sauf si tu construis volontairement un bot public.

---

Étape 5 : garde-le en vie 24/7

Un gateway dans un terminal meurt avec ta session SSH. Sur un serveur, encapsule-le dans systemd :

[Unit]
Description=Hermes Agent Gateway
After=network-online.target

[Service]
Environment=HERMES_HOME=/root/.hermes
ExecStart=hermes gateway run
Restart=always
RestartSec=5

[Install]
WantedBy=multi-user.target

Active le service, et l'agent survit aux reboots et aux crashs. C'est là que le travail opérationnel commence : Hermes avance vite (la seule version 0.15 a porté 1 302 commits et 747 PR fusionnées, selon Anthony Maio, 2026), donc mises à jour, correctifs de sécurité et monitoring deviennent une routine hebdomadaire.

Les problèmes classiques à connaître

• « Conflict: terminated by other getUpdates request » : deux gateways pollent avec le même token. Tue l'ancien ; Telegram n'autorise qu'un poller par bot.
• Le bot se connecte mais ne répond jamais : vérifie d'abord le pairing. Un utilisateur non approuvé est ignoré en silence, par design.
• Erreurs d'auth après des semaines d'uptime : les refresh tokens OAuth tournent. Relance hermes model pour te ré-authentifier.

---

Le raccourci : Hermes Agent managé sur Telegram

Tout ce qui précède prend 30 à 60 minutes à un développeur un bon jour, plus la maintenance qui suit. L'alternative managée compresse ça en deux saisies : sur ClawRapid, tu choisis un modèle, tu colles ton token BotFather, et la plateforme provisionne un VPS dédié durci, configure le gateway et le pairing, et surveille l'ensemble. En ligne en 2 minutes environ, 45 €/mois tout compris, avec 15 $ de crédits IA et le support ChatGPT Plus intégré.

Même runtime, même sécurité de pairing, zéro systemd.

---

Questions fréquentes

Hermes Agent peut-il répondre dans les groupes Telegram ?

Oui. Le gateway gère les groupes, avec des allowlists par chat (TELEGRAM_GROUP_ALLOWED_CHATS) pour autoriser un groupe entier sans approuver chaque membre. Le pairing DM continue de gouverner les conversations privées, ce qui garde un modèle de sécurité cohérent.

Le bot a-t-il besoin des identifiants de mon compte Telegram ?

Non. Il fonctionne uniquement avec le token BotFather, limité à l'identité du bot. Ton compte personnel n'est jamais touché, et révoquer le token dans BotFather coupe l'accès instantanément.

Combien coûte un bot Telegram Hermes ?

Le logiciel est gratuit (MIT). En auto-hébergé : 5 à 10 $/mois de serveur plus la consommation IA, qui tombe à zéro coût marginal avec l'auth ChatGPT Plus. En managé sur ClawRapid : 45 €/mois tout compris. Le détail complet est dans notre guide d'hébergement Hermes Agent.

Puis-je basculer le bot sur Discord ou Slack plus tard ?

Oui. Le même gateway Hermes sert plus de 20 plateformes, et en hébergement managé le canal est un choix de configuration. Discord utilise le même modèle de pairing que Telegram ; Slack limite l'accès aux membres de ton workspace.

---

En résumé

Un bot Telegram est le chemin le plus court pour vivre au quotidien avec un agent IA, et le modèle de pairing d'Hermes Agent le rend sûr par défaut. Construis-le toi-même avec les cinq étapes ci-dessus, ou déploie-le en 2 minutes sur ClawRapid et démarre la conversation tout de suite. Dans les deux cas, l'agent devient plus utile chaque semaine passée en vie : c'est toute la promesse du runtime.