🎮 Discord Bot Setup

Create a Discord Application

1. Go to the Discord Developer Portal
2. Click "New Application"
3. Name it (e.g., "My OpenClaw") and click Create
4. You're now in your application's settings

Create a Bot User

1. In the left sidebar, click "Bot"
2. Click "Add Bot" → "Yes, do it!"
3. Under the bot's username, click "Reset Token"
4. Copy the token — you'll need this for OpenClaw

Configure Bot Settings

On the Bot page, configure these settings:

• Public Bot: Disable if you only want to add it to your own servers
• Message Content Intent: ENABLE THIS — required to read messages
• Server Members Intent: Enable if you need member info
• Presence Intent: Optional, for user status

Generate an Invite Link

1. Go to "OAuth2" → "URL Generator"
2. Under Scopes, select: bot and applications.commands
3. Under Bot Permissions, select the permissions below
4. Copy the generated URL at the bottom

Recommended Permissions

Invite the Bot to Your Server

1. Open the invite URL you generated
2. Select the server you want to add it to
3. Authorize the requested permissions
4. Complete any CAPTCHA if prompted

Your bot should now appear offline in your server's member list.

Get Your Discord User ID

To restrict who can use the bot:

1. Enable Developer Mode: User Settings → App Settings → Advanced → Developer Mode
2. Right-click your username anywhere in Discord
3. Click "Copy User ID"

# Your ID will look like:
123456789012345678

Configure OpenClaw

# Add to ~/.openclaw/config.yaml:

channels:
  discord:
    token: "YOUR_BOT_TOKEN"
    allowedUsers:
      - "123456789012345678"  # Your Discord user ID

Or via CLI:

openclaw channels add discord \
  --token "YOUR_BOT_TOKEN" \
  --allowed-users "123456789012345678"

Start OpenClaw

openclaw gateway

# Your bot should come online in Discord!

DM Mode (Default)

By default, the bot responds to direct messages from allowed users. Just DM it like you would a friend.

Channel Mode (Mentions)

In server channels, the bot responds when @mentioned:

@MyOpenClaw what's the weather like today?

Prefix Mode

Configure a command prefix so the bot responds to messages starting with it:

channels:
  discord:
    token: "..."
    prefix: "!"  # Bot responds to !command
    
# Usage:
!what's the weather today?

Bot doesn't respond?

• Check Message Content Intent is enabled in Developer Portal
• Verify your user ID is in the allowedUsers list
• Check OpenClaw logs: openclaw logs -f
• Make sure the bot has permissions in the channel

Bot is offline?

• Check OpenClaw is running: openclaw status
• Verify token is correct (reset in Developer Portal if unsure)
• Check for errors: openclaw logs

"Privileged Intents" error?

You need to enable the Message Content Intent in the Discord Developer Portal under Bot settings. This is required for bots in 100+ servers, but good practice to enable for all bots.