Errors / Mention Required

Fix: Mention Required

Error: "mention required" or "drop guild message (mention required)"

What It Means

Your group or channel is set up to require a mention (@botname) before the bot will respond. Messages that don't mention the bot are silently ignored. This prevents the bot from flooding busy groups with responses to every message.

Common Causes

  • Group policy set to require mention
  • Privacy mode enabled in Telegram
  • Channel or group has requireMention: true
  • mentionPatterns not matched in the message

Ask Your Agent to Fix This

Copy this prompt and send it to your OpenClaw agent:

Check my group/channel settings and tell me which ones require mentions. Then disable requireMention for [telegram/discord] groups so the bot responds to all messages.

How to Fix It

1. Allow All Messages in Groups

# Discord
openclaw config set channels.discord.groups."*".requireMention false
# Telegram
openclaw config set channels.telegram.groups."*".requireMention false

2. Change DM Policy to Open

openclaw config set channels.discord.dmPolicy open
openclaw config set channels.telegram.dmPolicy open

How to Prevent This

  • Set up groups with the policy you want from the start
  • Use "open" policy if you want the bot to see all messages
  • Remember to mention @botname in groups with mention requirements

Related Errors

Related Guides

Still having trouble?

Ask on Discord