Skip to main content

Discord

Connect your OpenClaw agent to Discord so it can respond to messages in your server. You will need to create a Discord application, set up a bot, and invite it to your server.

Prerequisites​

  • A Discord account
  • A Discord server where you have permission to add bots
  • Access to your OpenClaw Dashboard

Step-by-Step Setup​

1. Create a Discord Application​

  1. Go to the Discord Developer Portal.
  2. Click New Application in the top right.
  3. Give it a name (e.g., "My AI Agent") and click Create.

2. Get the Bot Token​

  1. In the left sidebar, click Bot.
  2. Click Reset Token.
  3. Confirm the reset when prompted.
  4. Copy the token immediately -- it will only be shown once.
warning

The bot token is displayed only once after you reset it. If you lose it, you will need to reset the token again, which invalidates the old one.

3. Enable Privileged Intents​

Still on the Bot page, scroll down to Privileged Gateway Intents and enable:

  • Message Content Intent -- allows the bot to read message content
  • Server Members Intent -- allows the bot to see server member information

Click Save Changes.

Why are intents needed?

Discord requires bots to explicitly request access to message content and member data. Without these intents enabled, your bot will receive empty messages and cannot function properly.

  1. In the left sidebar, click OAuth2.
  2. Click URL Generator.
  3. Under Scopes, check bot.
  4. Under Bot Permissions, check:
    • Send Messages
    • Read Message History
  5. Copy the Generated URL at the bottom of the page.

5. Add the Bot to Your Server​

  1. Open the generated URL in your browser.
  2. Select the server you want to add the bot to.
  3. Click Authorize.
  4. Complete the CAPTCHA if prompted.

The bot should now appear in your server's member list (it will show as offline until OpenClaw connects).

6. Connect in OpenClaw​

  1. Go to your OpenClaw Dashboard.
  2. Navigate to Instance > Channels.
  3. Click Discord.
  4. Click Connect.
  5. Paste the bot token you copied in step 2.
  6. Click Save.

OpenClaw will connect to Discord using your token. The bot should appear as online in your server within a few seconds.

7. Test It​

Send a message in a channel where the bot has access, or send the bot a direct message. Your OpenClaw agent should respond.

Troubleshooting​

  • Bot is offline in the server: Check that the channel shows as "Connected" in your OpenClaw dashboard. Verify you pasted the correct, most recent token.
  • Bot does not respond to messages: Make sure you enabled the Message Content Intent in step 3. Without it, the bot receives empty messages.
  • "Invalid token" error: You may have copied the token incorrectly, or it may have been reset since you copied it. Go to the Developer Portal, reset the token, and try again.
  • Bot cannot see certain channels: Check the channel permissions in Discord. The bot needs "View Channel" and "Send Messages" permissions for each channel it should access.