Setup Guides

Discord Setup

How to set up Hermes Agent on Discord, including bot creation, intents, permissions, and first-run verification.

Discord setup usually takes slightly more care than Telegram because bot permissions, invited servers, and gateway settings all have to line up.

What you need before you start

Most setup problems come from missing one prerequisite, not from the platform itself.

Before you begin, verify you have the following inputs ready:

  • A Discord application and bot token
  • The correct privileged intents enabled for your use case
  • A server where you can safely test bot permissions

Recommended setup flow

Create the Discord application, generate the invite URL with the right scopes, add the bot to the server, connect the provider key, deploy Hermes, then verify the bot can see and answer in the intended channel.

If you are using Hermes Host, the best workflow is to connect the provider, connect the channel, deploy, then verify behavior from a real conversation instead of trying to perfect every setting upfront.

Mistakes that slow teams down

Teams often skip intent configuration, invite the bot with insufficient permissions, or test in a channel where the bot cannot read history or send messages.

Treat the first deploy as an integration check, not the final architecture. Once the agent is live, you can refine prompts, tools, schedules, and provider choices with much better feedback.

Use the shortest path to first deploy

Hermes Host removes most of the infrastructure work so you can focus on provider setup, channel pairing, and verifying that the agent actually behaves the way you want.

FAQ

Why does a Discord bot appear online but not respond?

That usually points to missing channel permissions, disabled intents, or a provider/runtime issue after the gateway handshake succeeds.

Do I need admin permissions for the bot?

Not necessarily. It is usually better to grant only the permissions required for the channels and actions you want.