Add your agent to Discord

Create the application

Open the Discord Developer Portal and select New Application. Give it the same name as your agent, such as my-trainer, then select Create.

If you already made an application for this agent, open that one instead.

Open the Bot page

Select Bot in the left sidebar. New applications usually include a bot already. If you see Add Bot or Create Bot, select it.

Turn on both settings under "Privileged Gateway Intents"

On the Bot page, scroll to "Privileged Gateway Intents". Turn on Server Members Intent and Message Content Intent, then select Save Changes.

Server Members Intent lets Agent Control show the people in your server. Message Content Intent lets your agent read a regular message without an @mention.

Keep a personal bot private

Do these settings in order. Select Installation in the sidebar. Under Install Link, choose None and save. Go back to Bot, turn off Public Bot, and save again.

Now only the application owner can add the bot to a server. You will choose who can read and talk to the agent later.

Reset and copy the bot token

Still on the Bot page, find Token and select Reset Token. Complete Discord's password or two-factor check, then select Copy.

Copy the bot token, not the Application ID, Public Key, or Client Secret. Discord will not show this token again. If you lose it, reset it and use the new one.

Paste the token into Agent Control

In the Agent Control tab you just opened, paste the token under Discord bot token, then select Connect bot.

Agent Control checks the token and restarts your agent. This usually takes about 30 seconds. When it works, you will see Discord connected and the bot's name.

The token box clears after the check so your secret is not left on screen. You do not need to paste it again.

Add the bot to your server

Select Add my-trainer to a server. If the bot is private, make sure you are signed in to the Discord account that created it.

Choose the server in Discord

On Discord's approval screen:

• Choose Add to server, not Add to my apps.
• Select your server.
• Select Continue.
• Review the permissions, select Authorize, and complete the CAPTCHA.

If your server is missing, check that you are signed in to the right Discord account and have Manage Server permission for that server.

Create a private home channel

In your Discord server, select Create Channel. Choose Text, name it my-trainer, turn on Private Channel, and create it. When Discord asks who can use the channel, add yourself and the bot.

If you already created the channel, open it and choose Edit Channel > Permissions. For @everyone, deny View Channel. Add yourself and the bot as members. For the bot, allow View Channel, Send Messages, and Read Message History, then save.

Return to Agent Control and choose the channel

Go back to Agent Control and reload the page. Under Server, select the server you just added. Then choose #my-trainer as the Home channel.

Check the channel name before you continue. Agent Control may preselect a different text channel.

Choose yourself

Under Your Discord account, choose yourself. Keep Just me selected. You can leave Optional: more channels and behavior closed. Home only is already selected.

Save settings

Select Save settings. The page confirms when your choices have been saved.

Send one message without tagging it

When Agent Control says Your bot is ready for a real message, select Open the home channel and send:

hi

Do not tag the bot. If your agent replies, the setup is complete.

Copy your Discord user ID

In Discord, open Settings, then Advanced, and turn on Developer Mode. Right-click your own name and choose Copy User ID. Hermes only answers the user IDs you give it.

Paste the token in the terminal

Open your agent's terminal. On Agent37, it is the >_ icon on the agent's page. Run hermes gateway setup, choose Discord, and paste the bot token and your user ID when it asks.

The terminal is the only place the token goes. Never paste it into a chat with your agent.

Add the bot to your server

A private bot needs an invite link you make yourself. In the Developer Portal, open General Information and copy the Application ID. Put it in this link in place of YOUR_APP_ID, open the link, choose your server, and select Authorize.

https://discord.com/oauth2/authorize?client_id=YOUR_APP_ID&scope=bot+applications.commands&permissions=274878286912

Make a private home channel

Create a private text channel and add yourself and the bot, as in Step 9 above. Then type /sethome in that channel. Scheduled messages from your agent go to the home channel.

Send one message

Type @ and your bot's name, then hi. In a server channel, Hermes answers when you mention it.

If the bot still shows as offline after a minute, restart the agent. On Agent37, restart it from the agent's page. Anywhere else, run hermes gateway restart in the terminal.