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:

CODEBLOCK0

• - 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

CODEBLOCK1

The script will:

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

Step 2: Restart the gateway

CODEBLOCK2

Step 3: Verify

Send a message with a full Matrix ID mention:

@username:matrix.biochao.cc

Routine Use (After Patched)

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

正确格式：
CODEBLOCK4

错误格式：

• - Markdown link: INLINECODE3
• HTML span: INLINECODE4
• 任何包装格式

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

Re-applying After Updates

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

CODEBLOCK5

Undoing the Patch

Restore from backup:
CODEBLOCK6

Target File

CODEBLOCK7

Requirements

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