Matrix Mentions Patch

Other

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.

Install

openclaw skills install matrix-mentions-patch

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

  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.