Channel Capabilities

Feature Supported Notes
Direct Messages ✓ Full support for 1:1 conversations
Group Chats ✓ Participate in group conversations
Media Messages ✓ Send and receive images, files
Voice Messages — Not available
Reactions ✓ React to messages with emoji
Threads ✓ Threaded conversation support
Native Commands ✓ Platform-specific slash commands

Access Control Policies

DM Policies

Control who can send direct messages to your bot:

allowlist

Only senders in the allowFrom list can interact with the bot.

pairing

Unknown senders receive a pairing code that admin must approve before access is granted.

open

All direct messages are processed (requires allowFrom: ["*"]).

Group Policies

Control which groups your bot participates in:

allowlist

Only groups in groupAllowFrom are processed.

open

Bot responds in all groups it is added to.

Setup Guide

  1. Create a Discord application at discord.com/developers
  2. Create a bot user and copy the token
  3. Set DISCORD_BOT_TOKEN environment variable
  4. Configure OAuth2 and add bot to your server
  5. Add discord configuration to openclaw.json

Configuration Example

{
  "channels": {
    "discord": {
      "token": "${DISCORD_BOT_TOKEN}",
      "applicationId": "your-app-id",
      "dmPolicy": "allowlist",
      "allowFrom": ["user123"]
    }
  }
}

Use Discord with AI Providers

Connect Discord to your preferred AI model provider:

Frequently Asked Questions

How do I set up Discord with OpenClaw?
To set up Discord: Create a Discord application at discord.com/developers. Create a bot user and copy the token. Set DISCORD_BOT_TOKEN environment variable. Full configuration options are available in the openclaw.json file.
How do I control who can message my Discord bot?
Discord supports allowlist, pairing, open for DM access control and allowlist, open for groups. Use allowlists for maximum security or pairing mode for easy onboarding.
Does Discord support media messages?
Discord supports media including images, audio, video, documents. Maximum media size is configurable via mediaMaxMb setting (default: 2MB).
Can I use OpenClaw in Discord groups?
Discord supports group chats with configurable access policies. Groups and DMs are supported.