Matrix Mentions Patch
Fix OpenClaw Matrix plugin mention detection bug. Use when OpenClaw doesn't respond to @mentions in Matrix group rooms despite correct configuration. The bug is that buildMentionRegexes() is called without agentId, causing mention patterns to not be built correctly.
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:
// 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:
const mentionRegexes = core.channel.mentions.buildMentionRegexes(cfg);
Change to:
const mentionRegexes = core.channel.mentions.buildMentionRegexes(cfg, "main");
Replace "main" with your actual agent ID if different.
Apply
- Make the edit above
- Restart OpenClaw gateway:
openclaw gateway restart
The fix loads immediately - no rebuild needed since the extension is loaded dynamically.
- Downloads
- 964All time
- Security audit
- Pass
- Last updated
- 6mo ago
- Current version
- v1.1.1
- License
- MIT-0
