Agents
Discord
Connect your OpenClaw Agent to Discord.
What You'll Need
- Discord server admin access.
- A Discord application/bot token.
- Agent in
Runningstate.
Setup Steps
- Create Discord bot application in developer portal.
- Enable required intents and permissions.
- Invite bot to your target server.
- Open your agent
Configurepage. - Enable Discord in Channels and add token.
- Save and test with mention or slash command.
Required Permission Checks
- Send Messages
- View Channels
- Read Message History
- Message Content Intent (when required by your setup)
Common Issues
Bot is offline
- Token is invalid, expired, or incorrect.
- Required intents are disabled.
- Agent failed restart after save.
Bot sees messages but does not respond
- Missing permissions in the specific channel.
- DM policy or channel allowlist blocks sender.
- AI credits exhausted.
Slash commands missing
- Command sync has not completed yet.
- Re-invite bot with
applications.commandsscope.
Troubleshooting Checklist
- Confirm token and intents.
- Confirm bot has channel-level permissions.
- Restart agent and wait 60 seconds.
- Test again in a clean channel.