Blog / channel guide

How to Deploy Hermes Agent on Discord

To deploy Hermes Agent on Discord, create an application in the Discord Developer Portal, add a bot, enable Message Content Intent, copy the bot token, invite the bot to a test server, and launch it through the managed Hermes Agent deployment flow.

Updated Aug 10, 20268 min read
Deployment route
  1. 01

    Create a Discord application

    Open the Discord Developer Portal, create an application, and add a bot from the Bot settings page.

  2. 02

    Enable the required intent

    Enable Message Content Intent so the bot can read message text where your Discord workflow requires it.

  3. 03

    Invite the bot

    Generate an OAuth invite with the bot and applications.commands scopes, then add it to a private test server or channel.

  4. 04

    Deploy and send a test message

    Paste the bot token into the Hermes Agent flow, deploy, and send one message in the exact channel you plan to use.

Four-step path

How do you connect Hermes Agent to Discord?

Discord setup has four boundaries: the application, the bot identity, the server permissions, and the Hermes Agent runtime.

  1. Step 01

    Create a Discord application

    Open the Discord Developer Portal, create an application, and add a bot from the Bot settings page.

  2. Step 02

    Enable the required intent

    Enable Message Content Intent so the bot can read message text where your Discord workflow requires it.

  3. Step 03

    Invite the bot

    Generate an OAuth invite with the bot and applications.commands scopes, then add it to a private test server or channel.

  4. Step 04

    Deploy and send a test message

    Paste the bot token into the Hermes Agent flow, deploy, and send one message in the exact channel you plan to use.

What do you need before connecting Discord?

You need a Discord account with permission to create an application, access to a test server, a bot token, and an active Hermes Agent plan. Use a private server while validating the connection.

A dedicated test channel gives you a clean place to check intents, permissions, mentions, and replies. It also avoids exposing an unfinished agent to an active community.

How do you create the Discord application and bot?

Create a new application in the Discord Developer Portal, open its Bot section, and add a bot user. The bot token shown there is the credential used by the Hermes Agent deployment.

  • Give the application a name users will recognize.
  • Copy the token only into the authenticated deployment form.
  • Regenerate the token immediately if it appears in a screenshot, log, or public message.
  • Keep the test bot separate from production community automation.

Which Discord intent does Hermes Agent need?

Enable Message Content Intent when Hermes Agent must read ordinary message text. Without it, a bot can appear online while failing to receive the content needed to answer.

Configure only the permissions and intents required by the workflow. Administrator permission is not a sensible default for a new assistant; begin with a private channel and expand access deliberately.

How do you invite the bot to a Discord server?

Use the OAuth2 URL Generator in the Developer Portal, select the bot and applications.commands scopes, choose the minimum bot permissions, and open the generated URL to add the bot to your server.

After the invitation, confirm the bot can see the test channel and send messages there. Discord channel overrides can block a permission even when the server role appears correct.

Why is the Discord bot online but not replying?

Check Message Content Intent, channel visibility, send-message permission, the current bot token, and the Hermes Agent deployment status. An online indicator proves the bot connected to Discord, not that every message can reach the agent.

  • Test a direct mention in one private text channel.
  • Confirm the bot role is allowed to view the channel and send messages.
  • Save intent changes in the Developer Portal before retesting.
  • Redeploy if the token was regenerated after the original launch.

Which primary sources support this page?

Product behavior is checked against the current deployment flow. These external links provide the upstream project or channel documentation used for setup details.

Direct answers

Frequently asked questions

Does the Discord bot need Administrator permission?

No. Start with the minimum permissions needed to view and reply in the intended channel.

Why is Message Content Intent important?

It allows the bot to receive ordinary message content for workflows that depend on reading and answering text messages.

Can Hermes Agent work in Discord direct messages?

The channel integration can support direct-message workflows, but you should test the exact route and access policy used by your deployment.

Should I use my production Discord server for testing?

No. Start in a private test server or restricted channel, prove the workflow, and then expand access.

Key takeaways

  • To deploy Hermes Agent on Discord, create an application in the Discord Developer Portal, add a bot, enable Message Content Intent, copy the bot token, invite the bot to a test server, and launch it through the managed Hermes Agent deployment flow.
  • Start with one model, one channel, and one controlled test conversation.
  • Use managed hosting when deployment speed matters more than operating the server yourself.

Put Hermes Agent in the channel where the work already happens.