← Back to Skills Marketplace
Verify Matrix device
by
Maxime Lumeau
· GitHub ↗
· v0.1.0
380
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install verify-matrix-device
Description
Verify and cross-sign the active Matrix device for one OpenClaw-managed account. Use when a user needs to repair trust for an OpenClaw Matrix device, confirm...
Usage Guidance
This skill appears to do what it claims, but review and run it with these precautions: 1) Inspect the included scripts locally (they are provided) and confirm the homeserver you supply is correct. 2) Be aware the script will read your openclaw.json (default ~/.openclaw/openclaw.json or path from OPENCLAW_JSON) to obtain access tokens — only use this skill if you trust the repository/run context. 3) npm install will fetch dependencies from the public npm registry into the skill folder; consider running installs in an isolated environment (container or VM) and run npm audit if desired. 4) Provide recovery keys, access tokens, or passwords only interactively in a secure terminal as instructed. 5) If you need greater assurance, run the scripts in a sandbox and verify network requests (they target only the homeserver you provide and Matrix endpoints).
Capability Analysis
Type: OpenClaw Skill
Name: verify-matrix-device
Version: 0.1.0
The skill's core functionality involves securely handling sensitive Matrix credentials (access tokens, passwords, recovery keys) and performing cryptographic operations to verify and cross-sign a Matrix device, which aligns with its stated purpose. However, the `SKILL.md` instructions for the OpenClaw agent to execute `node {baseDir}/scripts/verify_matrix_device.mjs` with user-provided `--homeserver` and `--username` arguments create a shell injection vulnerability. If the OpenClaw agent does not properly sanitize these user inputs before constructing and executing the shell command, an attacker could achieve Remote Code Execution (RCE) on the host system. This is a critical vulnerability in the agent's execution model, not an intentional malicious act by the skill itself, thus classifying it as suspicious.
Capability Assessment
Purpose & Capability
Name/description, prompts, and code all align: the scripts read an OpenClaw config (openclaw.json) or accept direct credentials, restore the self-signing key from a recovery key, sign the active device, and confirm the signature server-side. Required binaries (node, npm) and the listed dependency matrix-js-sdk are reasonable for this purpose.
Instruction Scope
SKILL.md instructions are specific: ask for homeserver/username/recovery key, optionally read openclaw.json, ensure node_modules exists (npm install if missing), and run the included script which performs Matrix client calls to the provided homeserver only. The instructions do require an interactive TTY for hidden secret prompts, and they explicitly avoid passing the recovery key on the command line.
Install Mechanism
No remote download/install spec is embedded — the skill instructs to run npm install --prefix {baseDir} to fetch matrix-js-sdk from the public npm registry. This is a standard approach but does write node_modules into the skill folder and will pull dependencies from npm; no custom or remote URLs, shorteners, or archives are used.
Credentials
The skill requests no environment variables or credentials up-front. It reads openclaw.json (defaulting to ~/.openclaw/openclaw.json or OPENCLAW_JSON if set) to obtain an OpenClaw access token, or accepts direct interactive credentials (access token or password). These data needs are expected for signing a Matrix device and are proportionate to the stated task.
Persistence & Privilege
The skill is not always-enabled, does not demand persistent platform privileges, and does not modify other skills or global agent config. It does write node_modules when npm install is run (local to the skill folder) but otherwise does not request elevated or persistent system privileges.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install verify-matrix-device - After installation, invoke the skill by name or use
/verify-matrix-device - Provide required inputs per the skill's parameter spec and get structured output
Version History
v0.1.0
Initial release of verify-matrix-device:
- Verifies and cross-signs the active Matrix device for a specified OpenClaw-managed account.
- Prompts user for missing inputs, manages dependencies, and uses secure recovery key entry.
- Utilizes existing `openclaw.json` access token; does not generate or use temporary devices for OpenClaw.
- Reports on device verification status, confirming if already cross-signed or newly signed.
- Supports advanced options for local testing, including direct access token and password-based flows.
Metadata
Frequently Asked Questions
What is Verify Matrix device?
Verify and cross-sign the active Matrix device for one OpenClaw-managed account. Use when a user needs to repair trust for an OpenClaw Matrix device, confirm... It is an AI Agent Skill for Claude Code / OpenClaw, with 380 downloads so far.
How do I install Verify Matrix device?
Run "/install verify-matrix-device" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Verify Matrix device free?
Yes, Verify Matrix device is completely free (open-source). You can download, install and use it at no cost.
Which platforms does Verify Matrix device support?
Verify Matrix device is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Verify Matrix device?
It is built and maintained by Maxime Lumeau (@mlumeau); the current version is v0.1.0.
More Skills