Skip to content

Discord Setup

Connecting your AI agent to Discord lets it participate in any text channel on your server. You create a bot application in Discord's Developer Portal, set the right permissions, invite the bot to your server, and enter its token in your agent's Discord setup.

Note

Channels are connected inside your agent. On OpenClaw, open your agent and go to Settings > Channels, where each channel has a guided setup. On Hermes Agent, press Open my Hermes dashboard on your server page and connect your channels there. On OpenClaw servers, your OneClickClaw dashboard shows each channel's status.

Step-by-step setup

1

Go to discord.com/developers/applications

Open discord.com/developers/applications and sign in with your Discord account.

2

Create a new application

Click New Application in the top right. Give it a name (for example, "OneClickClaw Agent") and accept the terms of service. Click Create.

3

Go to Bot section and create a bot

In the left sidebar, click Bot. If the bot has not been created automatically, click Add Bot and confirm. Scroll down to Privileged Gateway Intents and enable Message Content Intent. This allows your bot to read the contents of messages.

4

Copy the bot token

Under the bot's username, click Reset Token (or Copy if visible). Save this token somewhere safe. Discord only shows the token once, so copy it before navigating away.

5

Generate the invite URL with permissions

In the left sidebar, go to OAuth2 > URL Generator. Under scopes, check bot. In the permissions section below, check Send Messages and Read Message History. Copy the generated URL at the bottom of the page.

6

Invite the bot to your server

Open the generated URL in your browser. Select the server you want to add the bot to from the dropdown, then click Authorize. The bot appears in your server's member list.

7

Open your agent's channel settings

On OpenClaw: on your server page, click Add a channel in OpenClaw (or Manage channels in OpenClaw), or open your agent and go to Settings > Channels. Choose Discord. On Hermes Agent: press Open my Hermes dashboard and open its channel settings.

8

Enter the bot token in the guided setup

Follow the guided setup and enter your bot token when it asks for it. Your agent saves it on your server and starts the Discord connection. On an OpenClaw server, your OneClickClaw dashboard shows the channel as Connected once it is live.

Where to connect Discord

1. Discord Developer Portal

Create the bot, copy its token, invite it to your server

2. Inside your agent

OpenClaw: Settings > Channels > Discord. Hermes Agent: your Hermes dashboard.

3. OneClickClaw dashboard

Shows the channel status (OpenClaw servers)

Test the connection

Go to a text channel in your Discord server where the bot has permission and send a message like "Hello, are you there?". If your agent answers, the integration is working.

Note

Discord bots respond in channels where they have permission. Add the bot to specific channels you want it to monitor through Discord's channel permission settings.

Tip

If your bot appears offline in the member list but still responds to messages, that is normal. What matters is that it reads and replies to messages.

For information on viewing channel status and connecting additional platforms, see Managing Channels.