Token
Runtime cannot read the token
The token exists somewhere, but the running service cannot actually resolve it.
Pairing never completed
DMs from server members are blocked or the pairing code was never approved.
OpenClaw Discord
Discord setup step by step
Use this page when you want a real Discord bot setup that is secure, debuggable, and clear about DM pairing versus guild reply behavior.
Core ideaDM pairing success does not automatically mean guild behavior is ready.
Setup order
Build the Discord path in the right order
- create the Discord application and bot
- enable the privileged intents you actually need
- store the bot token through a runtime-readable secret path
- invite the bot to the target server
- patch config and validate it
- DM the bot and approve pairing
- only then tune guild reply behavior and mention requirements
Common failures
Most Discord breakage is one of a few patterns
DMs
Guilds
Mention gating still rules
The bot is healthy, but `requireMention` still explains the silence.