How to Setup Discord for OpenClaw

Video walkthrough

Step 1: Create a Discord application (bot setup)

1. Go to the Discord Developer Portal and sign in.

2. Click New Application.
• Name it something like “OpenClaw Bot”.
• Accept the terms.

3. In the left sidebar, open Bot.
• Click Add Bot → Yes, do it!
• Under Token, click Copy (or Reset Token if needed). Keep this secret.
• Under Privileged Gateway Intents, enable Message Content Intent (required to read message content).
• Optional: Turn Public Bot off if you want a private bot, and set avatar/description.

4. In the left sidebar, open OAuth2 → URL Generator.
• Scopes: select bot and applications.commands.
• Bot Permissions (pick what you need):
• Core: View Channels, Send Messages, Read Message History
• Optional: Add Reactions, Manage Messages, Embed Links, Manage Roles
• Copy the generated URL (you’ll use it to invite the bot).

Step 2: Invite the bot to your Discord server

1. Paste the OAuth2 URL you generated into a browser.

2. Select the server.

3. Click Authorize.

4. Confirm the bot appears in your server.
• You can verify under Server Settings → Integrations → Bots.

Step 3: Enable Developer Mode and copy your IDs

1. In Discord, go to User Settings (gear) → Advanced → enable Developer Mode.

2. Right-click your server icon → Copy Server ID.

3. Right-click your own user → Copy User ID.

• Bot Token

• Server ID

• User ID

Step 4: Allow DMs from server members

1. Right-click your server icon → Privacy Settings.

2. Turn on Direct Messages.

Step 5: Configure OpenClaw for Discord

1. Go to the Agent37 dashboard.

2. Open an existing instance (or create a new one).

3. Open Terminal.

Option A: Configure via config.json

{
  "channels": {
    "discord": {
      "enabled": true,
      "token": "your-bot-token-here"
    }
  }
}

Option B: Configure via CLI

openclaw config set channels.discord.token "your-bot-token"
openclaw config set channels.discord.enabled true
openclaw gateway

Step 6: Test and pair

A) Send a test message (optional)

openclaw message --action send --channel discord --target "your-channel-id" --message "Hello from OpenClaw!"

• Replace your-channel-id with a real channel ID (e.g., 1234567890123456789).

B) Pair via DM

2. DM your bot: “Hello from OpenClaw”.

2. The bot responds with a pairing code.

3. In your instance terminal, approve it:

openclaw pairing approve discord <CODE>