add-matrix

Installs and configures a Matrix channel adapter for NanoClaw via the Chat SDK bridge.

2|Updated Jan 14, 2026
One-click install
npx skills add https://github.com/RADHA0-max/selfhealbackend --skill add-matrix-radha0-max
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: add-matrix
Source: https://github.com/RADHA0-max/selfhealbackend/tree/main/nanoclaw/.claude/skills/add-matrix
Command: npx skills add https://github.com/RADHA0-max/selfhealbackend --skill add-matrix-radha0-max

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires @beeper/chat-adapter-matrix.

What problem does it solve? NanoClaw does not ship channel integrations in its trunk, so connecting an agent to a Matrix homeserver requires manually copying the adapter, registering it, patching dependencies, and configuring bot credentials. This Skill walks through that entire setup with idempotent, re-runnable steps. ## Core Features & Use Cases - Adapter Installation: Copies the Matrix adapter and its registration test from the channels branch, appends the self-registration import, and installs the pinned @beeper/chat-adapter-matrix package. - ESM Compatibility Patching: Fixes matrix-js-sdk import paths in the adapter's published dist so it works under Node 22 strict ESM resolution. - Credential Configuration: Guides creation of a dedicated Matrix bot account with either password or access-token authentication, plus optional auto-join, allowlist, E2EE recovery key, and device ID settings. - Use Case: You want your NanoClaw agent to send and receive messages in Matrix rooms or DMs. Run this Skill to wire up the channel, then use /manage-channels to bind it to an agent group. ## Quick Start Ask the assistant to add Matrix channel support to NanoClaw and configure it with your bot account credentials.

Frequently Asked Questions about add-matrix

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I add a Matrix channel to NanoClaw?

Run this Skill to copy the Matrix adapter from the channels branch, register it in src/channels/index.ts, install @beeper/chat-adapter-matrix, and configure bot credentials in .env. Every step is idempotent and safe to re-run.

How do I create a Matrix bot account for a chat agent?

Register a new account at app.element.io in a private window, since Matrix cannot send DMs to yourself. Then authenticate with either the bot's username and password or an access token from Settings > Help & About.

Does the Matrix adapter work with Node 22 strict ESM?

Not out of the box. The adapter's published dist references matrix-js-sdk/lib paths without .js extensions, so the Skill includes a patch script that appends the missing extensions after each install.

Matrix access token vs password authentication, which should I use?

Password login is simpler since the adapter logs in automatically. Access tokens are recommended for production and can be obtained from Element's settings or via the /_matrix/client/r0/login API endpoint.

Why does the Matrix adapter fail after running pnpm install?

Reinstalling the package overwrites the ESM patch applied to the adapter's dist file. Re-run the patch script from step 5 after every pnpm install that touches @beeper/chat-adapter-matrix.