How to connect Hermes Agent to Discord
Create a Discord bot, enable Hermes gateway intents, configure allowed users and chat with Hermes in DMs or channels.
Free guide · Updated
Based on official documentation · Checked
Ask your agent
Copy the prompt and paste it into your assistant.
Quick answer
Hermes connects to Discord through a bot and its messaging gateway. Set up the bot in Discord’s Developer Portal, configure the token and allowed users in Hermes, then start the gateway. Server messages normally require an @mention; direct messages do not.
1. Create the bot and enable intents
Create an application in the Discord Developer Portal and open its Bot settings. Enable Server Members Intent and Message Content Intent, then save. Hermes requests message content; the documented setup will not connect correctly with that intent disabled. Copy the bot token into a secure local store.
2. Invite the bot
Use the application’s Installation settings with Guild Install and the bot and applications.commands scopes. Select permissions for viewing channels, sending messages, embeds, attachments and history. Add thread permissions if you want thread conversations. Invite it to a server where you can manage apps. The official guide provides a manual invite alternative for a private bot.
3. Configure Hermes
Run the setup wizard and choose Discord. Supply the token and add your human Discord user ID to the allowlist. To copy your ID, enable Developer Mode in Discord and use Copy User ID on your profile. Bot IDs and channel IDs are different values.
hermes gateway setup
hermes gatewayPractice
4. Send a message
- Once the bot appears online, send a DM asking it to reply with a short phrase. Next, @mention it in an accessible server channel.
Output: The reply arrives in the intended DM or channel from the Hermes bot.
Troubleshooting
Offline bot: check the gateway process, token and privileged-intent error. Online but silent in a channel: check the mention, channel permissions and sender allowlist. A provider error after message receipt means Hermes reached Discord but could not complete the model request. Start with text before configuring voice or attachments.
Keep it running or disconnect
For ongoing use, follow Hermes deployment guidance for a managed service. To disconnect, stop the gateway instance you configured and remove or revoke that bot’s credentials. Do not run two gateways with the same configuration just to retry a message.
Sources
Read the primary material
- Hermes DiscordNous Research / Hermes Agent