← Back to Skills Marketplace
Matrix Mentions Patch
by
Fang, Chao
· GitHub ↗
· v1.1.0
· MIT-0
121
Downloads
0
Stars
0
Active Installs
4
Versions
Install in OpenClaw
/install matrix-mentions-patch
Description
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...
Usage Guidance
What to consider before installing/applying:
- The code does what it claims (adds mention extraction and attaches m.mentions) and does not phone home or require secrets, but it modifies core OpenClaw files in your global node_modules — you need write permissions and this change is persistent.
- The patch is brittle and implementation has issues: the injected formatting function references escapeRegex (used in the replacement) but the script does not insert an escapeRegex definition into the patched file, which will likely cause runtime errors in the patched code. Also the script matches specific compiled strings; if your OpenClaw build differs the patch may fail or do nothing.
- Recommended steps: (1) Inspect the script yourself; (2) Back up the target file (the script already creates a .bak, but keep an external copy); (3) Test on a staging instance first; (4) If you proceed, confirm Node global path and permissions (the script assumes certain paths and uses npm root -g fallback); (5) Consider patching the script to also insert a safe escapeRegex implementation into the target file or adjust the patching logic to match your build.
- If you are unsure, ask the maintainer for an upstream fix or a proper plugin update instead of in-place patching.
Capability Assessment
Purpose & Capability
Name/description align with the included script: it locates OpenClaw's distributed JS and injects mention-handling logic. There are no unrelated credentials, network calls, or external endpoints requested. Minor inconsistency: SKILL.md's 'Patch Status Check' greps a TypeScript source file under extensions/src (formatting.ts), while the script actually modifies compiled auth-profiles-*.js in OpenClaw's dist/ — this is plausible (source vs compiled) but could confuse users if their installation layout differs.
Instruction Scope
Instructions are narrow and explicit: run the included node script, restart the gateway, and verify. They correctly tell the user to only apply when requested. The script does modify files under global node_modules (OpenClaw's dist), which is within the stated purpose but is a system-level change that requires write privileges. The SKILL.md check path and the script target differ (source vs dist), which may cause users to believe the patch is present when it is not.
Install Mechanism
No external downloads or installers — the skill is instruction-only plus a local Node script. The script uses fs and child_process but only for local filesystem operations (ls, npm root -g, file copy/write). This is low-risk compared with remote downloads.
Credentials
The skill requests no environment variables, credentials, or external tokens. It does assume a Node runtime and access to global node_modules (may require elevated privileges), which is reasonable for a file-patching script.
Persistence & Privilege
The script makes persistent, system-wide edits to OpenClaw's distributed JS files and requires write permissions to node_modules (potentially root). This is expected for a patch, but it is privileged — a faulty patch could break the gateway; updates may overwrite it and re-applying is required. The skill does not run autonomously by default, but the persistent modification is significant and should be applied with caution.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install matrix-mentions-patch - After installation, invoke the skill by name or use
/matrix-mentions-patch - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.1.0
Add patch status check, clarify first-time setup vs routine use
v1.0.2
matrix-mentions-patch v1.0.2
- Added important warnings and clarification about patching node_modules and backup creation to SKILL.md.
- Improved and expanded usage instructions, detailing how to apply, verify, reapply, and undo the patch.
- Listed technical requirements and precise file modification targets.
- No code logic changes; documentation and safety steps were updated for clarity and robustness.
v1.0.1
- Updated documentation (SKILL.md) with clearer English instructions.
- Improved explanations of patch behavior, usage steps, and caveats.
- Expanded troubleshooting and undo guidance.
- No changes to code or patch logic in this release.
v1.0.0
matrix-mentions-patch v1.0.0
- Adds m.mentions support to OpenClaw Matrix plugin, fixing @mention notifications not triggering.
- Automatically attaches the m.mentions field and data-mention HTML tag when sending @mention messages.
- Extracts mentions in both full Matrix ID (`@user:homeserver.org`) and username (`@username`) formats.
- Provides a patch script to apply updates after upgrading OpenClaw.
- Includes usage instructions, prerequisites, and automation tips for persistent patching.
Metadata
Frequently Asked Questions
What is 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... It is an AI Agent Skill for Claude Code / OpenClaw, with 121 downloads so far.
How do I install Matrix Mentions Patch?
Run "/install matrix-mentions-patch" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Matrix Mentions Patch free?
Yes, Matrix Mentions Patch is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Matrix Mentions Patch support?
Matrix Mentions Patch is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Matrix Mentions Patch?
It is built and maintained by Fang, Chao (@biociao); the current version is v1.1.0.
More Skills