Discord

​

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

1. 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>