Matrix Mentions Patch#

Problem#

OpenClaw Matrix plugin doesn't respond to @mentions in group rooms even when:

• The room is configured with requireMention: true
• The user correctly @mentions the bot (e.g., @runwheezy:matrix.biochao.cc)

Root Cause#

In /home/bot/.openclaw/extensions/matrix/src/matrix/monitor/index.ts, the buildMentionRegexes function is called WITHOUT passing agentId:

typescript

// BUG: Missing agentId parameter
const mentionRegexes = core.channel.mentions.buildMentionRegexes(cfg);

Without agentId, the function can't resolve agent-specific mention patterns from config, causing mentions to never be detected.

Fix#

Edit /home/bot/.openclaw/extensions/matrix/src/matrix/monitor/index.ts:

Find line ~298:

typescript

const mentionRegexes = core.channel.mentions.buildMentionRegexes(cfg);

Change to:

typescript

const mentionRegexes = core.channel.mentions.buildMentionRegexes(cfg, "main");

Replace "main" with your actual agent ID if different.

Apply#

1. Make the edit above
2. Restart OpenClaw gateway: openclaw gateway restart

The fix loads immediately - no rebuild needed since the extension is loaded dynamically.