Connecter Discord a Hermes Agent : guide complet

Introduction

Discord est une plateforme de messagerie particulierement adaptee a Hermes Agent grace a son support des commandes slash, des canaux vocaux et des serveurs communautaires. Une fois connecte, votre agent peut repondre dans les DMs, les salons textuels et meme les canaux vocaux.

Cette page couvre l'ensemble du processus de connexion, de la creation de l'application Discord a la mise en service du bot.

Question couverte

q-122: Comment connecter Discord a Hermes Agent ?

La connexion se fait en quatre etapes.

Etape 1 : Creer une application Discord

1. Allez sur le Discord Developer Portal
2. Cliquez sur New Application et donnez-lui un nom
3. Allez dans l'onglet Bot et cliquez sur Add Bot
4. Copiez le token du bot (cliquez sur Reset Token si necessaire)
5. Activez les Privileged Gateway Intents : MESSAGE CONTENT INTENT, SERVER MEMBERS INTENT, PRESENCE INTENT

Etape 2 : Configurer Hermes Agent

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

DISCORD_BOT_TOKEN=votre-token-discord

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

platforms:
  discord:
    enabled: true

Etape 3 : Inviter le bot sur votre serveur

1. Dans le Developer Portal, allez dans OAuth2 > URL Generator
2. Cochez les scopes : bot, applications.commands
3. Cochez les permissions : Send Messages, Read Message History, Use Slash Commands, Connect (pour le vocal), Speak (pour le vocal)
4. Copiez l'URL generee et ouvrez-la dans votre navigateur
5. Selectionnez le serveur ou inviter le bot

Etape 4 : Configurer l'acces et lancer

Ajoutez votre ID utilisateur Discord dans ~/.hermes/.env :

DISCORD_ALLOWED_USERS=111222333444555666

Pour trouver votre ID Discord, activez le mode developpeur (Parametres > Avance > Mode developpeur), puis clic droit sur votre profil > Copier l'ID.

Lancez le gateway :

hermes gateway run

Utilisation dans Discord

Commandes slash

Les commandes slash Hermes sont automatiquement enregistrees aupres de l'API Discord. Tapez / dans un salon ou le bot est present pour voir la liste :

Mode vocal Discord

Hermes Agent supporte le mode vocal dans les canaux Discord :

/voice join

Le bot rejoint votre canal vocal. Vous pouvez alors lui parler directement. Commandes vocales :

DMs et salons

• DMs : envoyez un message prive au bot pour une conversation one-to-one
• Salons : mentionnez le bot avec @MonBot pour lui parler dans un salon
• Fils de discussion : le bot peut repondre dans les threads Discord

Permissions Discord recommandees

Pour un fonctionnement optimal, le bot a besoin des permissions suivantes :

Send Messages
Read Message History
Use Slash Commands
Connect (vocal)
Speak (vocal)
Read Messages (pour les salons)

Securite

• Allowlists : configurez DISCORD_ALLOWED_USERS pour restreindre l'acces
• DM pairing : les utilisateurs inconnus recoivent un code de pairing
• Token : stockez le token uniquement dans .env (permissions 600)
• Intents : n'activez que les intents necessaires dans le Developer Portal

Depannage

Sources

• Documentation officielle Hermes Agent (https://hermes-agent.nousresearch.com/docs/)
• Guide Voice Mode (https://hermes-agent.nousresearch.com/docs/guides/use-voice-mode-with-hermes)
• 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
• Telegram
• Securite
• Automatiser avec Hermes Agent
• FAQ
• Sources