OpenSkillIndex← back to search
claude-codeopenclawautomation

Skills matrix-mentions-patch

Use when a user reports Matrix @mentions not working, notifications not triggering, asks to fix/update the mentions patch, or asks to install/apply the patch. This skill should only be used when explicitly requested.

install
source · Clone the upstream repo
git clone https://github.com/openclaw/skills
Claude Code · Install into ~/.claude/skills/
T=$(mktemp -d) && git clone --depth=1 https://github.com/openclaw/skills "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/biociao/matrix-mentions-patch" ~/.claude/skills/openclaw-skills-matrix-mentions-patch && rm -rf "$T"
OpenClaw · Install into ~/.openclaw/skills/
T=$(mktemp -d) && git clone --depth=1 https://github.com/openclaw/skills "$T" && mkdir -p ~/.openclaw/skills && cp -r "$T/skills/biociao/matrix-mentions-patch" ~/.openclaw/skills/openclaw-skills-matrix-mentions-patch && rm -rf "$T"
manifest: skills/biociao/matrix-mentions-patch/SKILL.md
tags
#matrix#patching#notifications#plugin-management#openclaw#debugging
source content

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