Discord Troubleshooting

Quick Diagnosis

openclaw doctor

This command checks your Discord channel configuration and token validity automatically.

Bot Shows as Offline

1. Check daemon is running: openclaw status
2. Verify your bot token in config.yaml is correct and not expired
3. Restart: openclaw restart
4. Check logs: openclaw logs --channel discord --tail 50

Bot Online but Not Responding to Messages

• Ensure Message Content Intent is enabled in the Discord Developer Portal under your app's Bot settings
• Verify the bot has "Read Messages" and "Send Messages" permissions in the channel
• Check if a trigger prefix is required in your config.yaml

Invalid Token Error

Discord bot tokens expire when you reset them in the portal. Generate a new token and update config.yaml:

channels:
  discord:
    token: "NEW_TOKEN_HERE"

Then restart: openclaw restart

Rate Limited by Discord

If your agent is sending too many messages too quickly, Discord will rate-limit it. Add a response delay in your config or reduce the number of active tasks sending to Discord simultaneously.