Connect Discord to Hermes Agent — Full Guide
Add Hermes to your Discord server for AI-powered community management and support.
Adding Hermes to your Discord server gives your community an always-on AI assistant for support, moderation, research, and automation — all from a bot you fully control.
Before you start:
- ☑Hermes Agent installed and running
- ☑A Discord account with server admin permissions
- ☑Access to discord.com/developers
Steps
- 1
Create Discord bot
Go to discord.com/developers and create a new application
- 2
Enable bot permissions
Under Bot settings, enable Message Content Intent and set required permissions
- 3
Add bot to server
Generate an OAuth2 invite link with bot and applications.commands scopes
- 4
Configure Hermes
Add bot token to config.yaml under discord: token:
- 5
Start Hermes
hermes restart and verify the bot comes online in your server
Pro Tips
- 💡Enable the Message Content Intent in the Discord Developer Portal under Bot settings — without it, Hermes cannot read messages
- 💡Use slash commands rather than @mentions for cleaner UX in larger servers
- 💡Set 'discord: allowedChannelIds' to restrict Hermes to specific channels so it doesn't respond everywhere
Troubleshooting
❌ Bot joins server but never responds
✅ Check that Message Content Intent is enabled in the Discord Developer Portal under Bot > Privileged Gateway Intents. This is required for Hermes to read message content.
❌ Bot token invalid error on startup
✅ Regenerate the bot token in the Discord Developer Portal (Bot > Reset Token) and update config.yaml. Tokens can only be viewed once after generation.
❌ Hermes responds to all messages, not just mentions
✅ Set 'discord: respondToMentionsOnly: true' in config.yaml to limit responses to @mention triggers only.