A cryptographic utility for verifying and cross-signing Matrix devices to ensure secure end-to-end encryption.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install verify-matrix-device
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install verify-matrix-device using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is Matrix Device Verification?
The Matrix Device Verification skill is a specialized tool designed to handle cryptographic trust for Matrix accounts within the OpenClaw ecosystem. By leveraging this entry in the library of Openclaw Skills, developers can easily repair broken trust chains or confirm the status of active devices. It ensures that automated agents can participate in encrypted rooms by properly cross-signing the session using a recovery key.
This utility is essential for maintaining the security integrity of your communication agents. It integrates directly with existing account configurations while maintaining high security standards by handling recovery keys through secure terminal prompts rather than command-line arguments.
Matrix Device Verification Use Cases
- Establishing trust for a newly deployed Matrix agent.
- Repairing verification status for accounts with revoked or expired sessions.
- Recovering cross-signing identity using a recovery key when client access is lost.
- Automating the setup of secure communications in multi-agent environments using Openclaw Skills.
How Matrix Device Verification Works
- The skill identifies the target Matrix user and homeserver from the provided inputs.
- It checks for the presence of the matrix-js-sdk and installs it if missing.
- The script initializes a connection using the existing access token found in the configuration file.
- It initiates a cross-signing verification flow, requesting the recovery key through a hidden terminal prompt.
- Upon receiving the key, it signs the active device and confirms the new trust status with the homeserver.
- The process concludes by reporting the final verification state of the device.
Matrix Device Verification Setup
Before using this skill, ensure you have Node.js and npm available on your system. To install dependencies, navigate to the skill directory and run:
npm install --prefix .
To execute the verification process manually within the context of Openclaw Skills:
node scripts/verify_matrix_device.mjs --homeserver "https://matrix.org" --username "your_username"
Matrix Device Verification Data Schema & Taxonomy
The skill manages identity and verification states through the following data structures:
| Attribute | Description |
|---|---|
| homeserver | The base URL of the Matrix homeserver (e.g., https://matrix.org). |
| username | The account identifier or full Matrix ID. |
| openclaw.json | The primary configuration file containing existing access tokens. |
| recovery key | A user-provided secret used during the session for cross-signing (not stored). |
Matrix Device Verification Advanced Features
- Bypass local configuration using the --access-token flag for direct authentication during testing.
- Manual device ID targeting for cross-signing specific helper sessions.
- Support for password-based login flows to authorize temporary verification sessions.
- Compatibility with non-standard config locations via the --openclaw-json argument for complex Openclaw Skills deployments.
SKILL.md
Loading
Related Openclaw Skills
Google Finance Stock Tracker
An automated stock monitoring tool that fetches data from Google Finance to provide price alerts, news updates, and heuristic buy/sell signals.
Spotify Connect
A sophisticated integration for controlling Spotify playback on remote Connect devices across multiple authenticated accounts.
Homelab Cluster Management
A comprehensive system for managing distributed AI inference clusters across heterogeneous hardware using Ollama, llama.cpp, and LiteLLM.
proxymock
proxymock is a transparent proxy-based tool designed to capture, inspect, and replay real API and database traffic to create instant mocks and automated tests without code changes.
Agent Earner
An autonomous income generation skill that enables AI agents to discover, evaluate, and complete bounties across decentralized work platforms.
ClawPay
ClawPay provides a privacy-preserving payment layer for AI agents, allowing them to send funds without leaving a direct on-chain link between sender and recipient.
METADATA
Featured*
