hermes - 💡(How to fix) Fix Discord: @mention from mobile client not recognized (bot does not respond)

Official PRs (…)
ON THIS PAGE

Recommended Tools

×6

Utilities matched from this issue’s tags and category — try them while you read without losing context.

GitHub issue graph ai analysis

Paste a GitHub issue URL. We fetch that issue, discover linked issues from bodies/comments/timeline, collect linked pull requests, and produce a structured English report.

The report is written in English Markdown for sharing and archival.

Helpful · Quick feedback

Loading…

Root Cause

Root Cause (suspected)

Fix Action

Workaround

Adding a plain-text fallback check for @BotName / @display_name at the start of message.content in _handle_message() resolves the issue.

RAW_BUFFERClick to expand / collapse

Bug Description

When using the Discord mobile app and tagging the bot with @BotName, the bot does not respond. The same @BotName mention works correctly on the Discord web client. DMs to the bot work on both platforms.

Steps to Reproduce

  1. Have discord.require_mention: true set in config (default)
  2. Open Discord on a mobile device (iOS or Android)
  3. In a server channel, type @BotName hello — selecting the bot from the autocomplete dropdown
  4. Bot does not respond
  5. Repeat same message from Discord web — bot responds correctly

Expected Behavior

Bot should respond to @mention on both web and mobile clients.

Actual Behavior

Bot ignores messages from mobile. Only DMs work on mobile.

Root Cause (suspected)

The on_message handler in gateway/platforms/discord.py checks self._client.user in message.mentions to detect a mention. On some mobile clients, the resolved message.mentions list may be empty even when the user types a proper @mention from the autocomplete, possibly due to a timing or payload difference in how the Discord mobile app sends the message.

Workaround

Adding a plain-text fallback check for @BotName / @display_name at the start of message.content in _handle_message() resolves the issue.

Environment

  • Platform: Discord (mobile — iOS/Android)
  • Hermes Gateway: latest
  • discord.require_mention: true
  • discord.auto_thread: true
<img width="689" height="114" alt="Image" src="https://github.com/user-attachments/assets/0909d384-bf28-47d1-be42-89b51799f224" />

Vote matrix · Quick signals

Works
Did the solution work? Tap to confirm.
Easy Fix
Was it a quick fix?
Time Saver
Did it save you time?
Blocking
Was it severely blocking?
Common Issue
Are others likely hitting this too?
Flaky / Intermittent
Is it intermittent?
Verified / Reproducible
Can you reproduce it reliably?
Loading…

Still need to ship something?

×6

Another batch ranked right after the header list — different links, same matching logic.

Back to top recommendations

TRENDING

hermes - 💡(How to fix) Fix Discord: @mention from mobile client not recognized (bot does not respond)