Discord Setup Guide
Production-ready for DMs + guild channels. Start with DM pairing, then enable guild workflow.
1) Prerequisites
- Access to Discord Developer Portal
- Create a bot and copy the Bot Token
- Enable Message Content Intent (required)
- Server Members Intent recommended for stable user matching
2) Quick Setup
openclaw config set channels.discord.token '"YOUR_BOT_TOKEN"' --json
openclaw config set channels.discord.enabled true --json
openclaw gateway
If gateway is already running as a service, use openclaw gateway restart.
3) First Pairing
openclaw pairing list discord
openclaw pairing approve discord <CODE>
Pairing codes expire after 1 hour by default.
4) Common Issues (Official High-Signal)
- Bot online but no guild replies: verify groupPolicy, guild allowlist, and Message Content Intent.
- No DM replies: check dmPolicy not disabled and pairing approval status.
- For full diagnostics, use Channel Troubleshooting playbook.