matrix-mentions-patch（矩阵提及补丁）

Matrix Mentions Patch

Patches OpenClaw's Matrix plugin to attach m.mentions to outbound messages so clients like Element properly notify mentioned users.

When to Use

• User reports @mentions not triggering notifications
• User asks to "fix Matrix mentions" or "update the mentions patch"
• User asks to "install" or "apply" the mentions patch

Only apply when requested. Do not auto-apply.

Patch Status Check

Before applying, check if already patched:

grep -l "extractMentionsFromText" ~/.nvm/versions/node/v22.22.0/lib/node_modules/openclaw/extensions/matrix/src/matrix/send/formatting.ts

• Already patched: Output will show the file. No action needed — just use correct @mention format.
• Not patched: No output. Proceed to apply the patch.

How to Apply (First-time Setup)

Step 1: Run the patch script

node ~/.openclaw/workspace/skills/matrix-mentions-patch/patch-matrix-mentions.mjs

The script will:

1. Locate auth-profiles-*.js in OpenClaw's dist/
2. Create a .bak backup automatically
3. Patch in-place

Step 2: Restart the gateway

openclaw gateway restart

Step 3: Verify

Send a message with a full Matrix ID mention:

@username:matrix.biochao.cc

The mentioned user should see a notification.

Routine Use (After Patched)

Once patched, no further action needed. Just ensure correct @mention format:

正确格式：

@username:matrix.biochao.cc

错误格式：

• Markdown link: [](https://matrix.to/#/@user)
• HTML span: <span>@user</span>
• 任何包装格式

直接发送纯文本 Matrix ID，客户端即可正确识别并通知。

Re-applying After Updates

Every openclaw update may overwrite the patch. Re-apply by running:

node ~/.openclaw/workspace/skills/matrix-mentions-patch/patch-matrix-mentions.mjs
openclaw gateway restart

Undoing the Patch

Restore from backup:

cp ~/.nvm/versions/node/v22.22.0/lib/node_modules/openclaw/dist/auth-profiles-*.js.bak \
 ~/.nvm/versions/node/v22.22.0/lib/node_modules/openclaw/dist/auth-profiles-*.js
openclaw gateway restart

Target File

~/.nvm/versions/node/v22.22.0/lib/node_modules/openclaw/dist/auth-profiles-*.js

Requirements

• OpenClaw core
• Matrix plugin configured and working
• Node.js runtime