← 返回 Skills 市场
Matrix Mentions Patch
作者
Fang, Chao
· GitHub ↗
· v1.1.0
· MIT-0
121
总下载
0
收藏
0
当前安装
4
版本数
在 OpenClaw 中安装
/install 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...
安全使用建议
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.
能力评估
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.
如何使用
- 确保已安装 OpenClaw(本地或 Docker 部署)
- 在对话框中输入安装命令:
/install matrix-mentions-patch - 安装完成后,直接呼叫该 Skill 的名称或使用
/matrix-mentions-patch触发 - 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
版本历史
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.
元数据
常见问题
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... 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 121 次。
如何安装 Matrix Mentions Patch?
在 OpenClaw 或 Claude Code 对话框中运行命令「/install matrix-mentions-patch」即可一键安装,无需额外配置。
Matrix Mentions Patch 是免费的吗?
是的,Matrix Mentions Patch 完全免费,采用 MIT-0 许可证,可自由下载、安装和使用。
Matrix Mentions Patch 支持哪些平台?
Matrix Mentions Patch 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(cross-platform)。
谁开发了 Matrix Mentions Patch?
由 Fang, Chao(@biociao)开发并维护,当前版本 v1.1.0。
推荐 Skills