Connecter Hermes Agent à Discord

Réponse courte. Créez une application et un bot dans le Discord Developer Portal, activez Message Content Intent et Server Members Intent, copiez le token du bot avec Reset Token, invitez le bot sur votre serveur, puis donnez à Hermes Agent le token et votre ID utilisateur Discord. Seuls les ID de sa liste d’autorisation peuvent lui parler. Sur votre propre machine, ce sont DISCORD_BOT_TOKEN et DISCORD_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 Discord et sécurité d’Hermes Agent et sur le panel PlayNHost tel qu’il fonctionne aujourd’hui. La prise en charge de Discord est intégrée à la gateway de messagerie d’Hermes Agent.

Étape 1 : créer l’application et le bot

1. Ouvrez le Discord Developer Portal, appuyez sur New Application, donnez-lui un nom et appuyez sur Create. Notez l’Application ID sur la page General Information.
2. Ouvrez Bot dans le menu de gauche. Sous Authorization Flow, activez Public Bot si vous voulez utiliser le lien d’invitation de Discord (étape 2), et laissez Require OAuth2 Code Grant désactivé.
3. Sous Privileged Gateway Intents, activez Message Content Intent et Server Members Intent, puis appuyez sur Save Changes. La documentation d’Hermes Agent indique que les deux sont obligatoires : sans Message Content Intent, Discord refuse la connexion du bot et il n’est jamais en ligne. Presence Intent est facultatif.
4. Sous Token, appuyez sur Reset Token et copiez le token. Discord ne l’affiche qu’une fois. Gardez-le privé : quiconque l’a contrôle votre bot.

Étape 2 : inviter le bot sur votre serveur

Utilisez Installation (Guild Install, Discord Provided Link, les scopes bot et applications.commands, et les permissions listées ci-dessous), ou construisez vous-même le lien avec l’Application ID de l’étape 1 :

https://discord.com/oauth2/authorize?client_id=YOUR_APP_ID&scope=bot+applications.commands&permissions=309237763136

309237763136 est l’ensemble de permissions que recommande la documentation d’Hermes Agent : View Channels, Send Messages, Embed Links, Attach Files, Read Message History, Create Public Threads, Send Messages in Threads et Add Reactions. Ouvrez le lien, choisissez votre serveur et appuyez sur Authorize. Vous avez besoin de la permission Manage Server sur ce serveur.

Étape 3 : trouver votre ID utilisateur Discord

1. Dans Discord, ouvrez Settings, Advanced, et activez Developer Mode.
2. Faites un clic droit sur votre propre nom et choisissez Copy User ID. C’est un long nombre, comme 284102345871466496.

C’est votre ID utilisateur, pas l’Application ID du bot ni un ID de serveur ou de salon.

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

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 Discord, collez le token et appuyez sur Enregistrer. La ligne n’affiche alors que les quatre derniers caractères ; le token n’est plus jamais affiché.
4. Sous Qui peut lui écrire, collez votre ID dans ID utilisateur Discord et appuyez sur Enregistrer. Plusieurs ID vont sur une même ligne, séparés par des virgules ou des espaces.
5. Appuyez sur Démarrer, ou sur Redémarrer maintenant si l’agent tourne déjà (« Les changements s’appliquent au prochain démarrage de votre agent. »). Quand il est en marche, la console confirme :

   [PlayNHost] Your agent is running
   [PlayNHost] Discord: only user 284102345871466496 can message your agent.

6. Envoyez un message privé au bot, ou mentionnez-le avec @ dans un salon qu’il peut voir. Votre agent répond : dans un message privé, directement là ; dans un salon, dans un nouveau fil sous votre message.

Si vous démarrez avec un champ ID utilisateur Discord vide, la console affiche « Discord: nobody can message your agent yet » et vous demande d’envoyer un message au bot : un message privé de quelqu’un qui n’est pas sur la liste est ignoré, et la console affiche alors une ligne avec l’ID de cet expéditeur à ajouter. Le Developer Mode est le moyen le plus rapide.

Telegram et Discord peuvent tourner en même temps sur le même agent : définissez les deux tokens et les deux listes d’ID.

Comment Hermes Agent se comporte dans Discord

• Messages privés : il répond à chaque message, sans mention, avec une conversation par message privé.
• Salons de serveur : il ne répond que si vous le mentionnez avec @, et par défaut il ouvre un nouveau fil pour chaque mention et y répond. Des personnes différentes dans un même salon ont des conversations séparées.
• Les autres personnes : sur PlayNHost, seuls les ID utilisateur de la page Agent reçoivent une réponse. Les accès par rôle, les interrupteurs « autoriser tout le monde » et l’accès de bot à bot sont désactivés à chaque démarrage.

Étape 4 sur votre propre machine

1. Lancez l’assistant de configuration et choisissez Discord. D’après la documentation d’Hermes Agent, il vérifie le token auprès de Discord, vérifie les intents, affiche le lien d’invitation et propose de vous autoriser :

   hermes gateway setup

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

   DISCORD_BOT_TOKEN=your-bot-token
   DISCORD_ALLOWED_USERS=284102345871466496

3. Démarrez-le avec hermes gateway. Pour une gateway qui continue de tourner après votre déconnexion, voir faire tourner Hermes Agent 24/7 : VPS ou hébergé.

Quand il ne répond pas

Sur PlayNHost, le journal d’Hermes Agent est .hermes/logs/gateway.log dans Files. Vous voulez aussi Telegram ? Voir connecter Hermes Agent à Telegram. 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.