Hermes Agent Discord turns your agent into a Discord bot that uses its full set of tools, memory and slash commands, and it can even join a voice channel and talk. Most setups fail on one toggle, so here’s the whole path from the official docs.
Key takeaways
- Create the application and bot in the Discord Developer Portal.
- Turn ON Message Content and Server Members intents, or it won’t connect.
- Mention it in channels, or set mention-free help channels.
- Each person gets their own session in shared channels by default.
- Want this set up for your community? Claim a free strategy session.
Why the gateway matters in v0.23
Hermes’ messaging gateway is one background process that connects to every platform you set up, keeps the sessions, runs cron jobs and delivers voice messages. Since v0.23.0 (5 November 2026), one gateway on each machine owns every conversation, and the CLI, TUI, Desktop, editors, bots and cron all attach to it. A chat you start in one place is the same chat everywhere, with one queue and one history.
The latest patch, v0.23.1 (9 November), fixes plugin installs so hermes plugins install sees the live catalog again. Update with hermes update.
1. Create the application and bot
- In the Discord Developer Portal choose New Application, name it and create it.
- Open Bot, leave Public Bot on if you want to use the Installation tab invite link, and copy the bot token.
- Generate the invite link from the Installation tab (or build one by hand) and add the bot to your server.
Find your user ID by turning on Developer Mode in Discord’s Advanced settings, then right-click your name and choose Copy User ID (Discord docs).
Want Hermes running your Discord server? Inside the AI Profit Boardroom you get the Agent OS — Hermes, OpenClaw, OpenCode, Claude and Codex in one place — plus step-by-step Hermes training and four live coaching calls a week.
Want a plan for your business first? Claim your free strategy session.
Join the AI Profit Boardroom →Claim Your Free SEO Strategy Session →
2. The step everyone misses: intents
On the Bot page, turn on Message Content Intent and Server Members Intent. Hermes always asks for message content, so without that intent Discord refuses the connection and the bot never comes online. The docs call this the number one reason Discord bots don’t work.
hermes gateway setup # pick Discord, paste token + your user ID
hermes gatewayA bot in 100 or more servers needs Discord’s verification to use these intents. For your own server that doesn’t apply.
3. Channels, threads and sessions
- DMs: it answers everything, with a separate session per DM.
- Server channels: it only answers when @mentioned. Use
DISCORD_FREE_RESPONSE_CHANNELSfor a help channel where nobody needs to tag it. - Threads: it replies in the thread, and each thread keeps its own history.
- Messages to other people: it stays out of messages that @mention someone else.
By default each person in a shared channel gets their own session, so two people in #research don’t mix contexts or interrupt each other. You can switch to one shared room session, but then everyone shares context and token costs.
4. Voice: messages and voice channels
Voice messages are transcribed automatically, and /voice tts adds spoken replies. Hermes can also join a Discord voice channel, listen to people speaking and talk back. That’s the feature that makes Discord stand out from the other chat apps.
Want this set up for you instead of doing it yourself? Claim your free strategy session →
5. Slash commands, files and forums
Skills show up as native Discord slash commands, there’s an interactive model picker, and you can limit who may use which commands. The bot can send and receive files, and in forum channels it creates a new thread post for each message it sends.
Keep it locked down
The gateway’s default is safe: it denies everyone who isn’t on an allowlist or paired. You can list user IDs per platform, or let unknown people DM the bot for a one-time pairing code that you approve with hermes pairing approve. Codes expire after an hour.
The docs call allowing all users “NOT recommended for bots with terminal access”, and that’s the right call for any business. Keep the allowlist short and use /approve and /deny for risky commands.
My verdict
Switch on both intents before anything else, start with mention-only channels plus one free help channel, then try voice. Set up that way, Hermes Agent Discord works well for a community or a team server.
About Julian Goldie
I’m Julian Goldie — founder of Goldie Agency and the AI Profit Boardroom. I test new AI agents almost every day for 432K+ YouTube subscribers and run Hermes, OpenClaw, OpenCode, Claude and Codex side by side in my own Agent OS. Claim your free strategy session or join the AI Profit Boardroom.
Want another angle? Read the AI Profit Boardroom guide to Hermes Agent Discord.
FAQ: hermes agent discord
How do I connect Hermes Agent to Discord?
Create an application and bot in the Discord Developer Portal, turn on Message Content and Server Members intents, invite the bot, then run hermes gateway setup.
Why is my Hermes Discord bot offline?
Usually Message Content Intent is off, so Discord rejects the connection. Turn it on under Privileged Gateway Intents and save.
Does Hermes reply to every message in a Discord server?
No. In server channels it replies when @mentioned, unless you add the channel to DISCORD_FREE_RESPONSE_CHANNELS.
Can Hermes join Discord voice channels?
Yes. It can join a voice channel, listen to people speaking and talk back, and it transcribes voice messages.
Do people share one conversation in a Discord channel?
Not by default. Each person gets their own session in a shared channel unless you turn that off.
Do Hermes skills work as Discord slash commands?
Yes. Skills register as native Discord slash commands, and you can control who may use them.
Ready to put Hermes to work in your business? Join the AI Profit Boardroom for the Agent OS, setup training and daily updates.
Or claim your free strategy session and we’ll map out your setup.
Starting from zero? Get the free AI course and community.
Join the AI Profit Boardroom →Claim Your Free SEO Strategy Session →Get the FREE AI Course + Community →
Related reading
Last updated November 2026. This page is a living guide to hermes agent discord — the facts here move fast and it is updated as they do.
