skills.rest
roseDwayane
roseDwayaneCOMMUNITY
Explore all skills by this author →
GitHub

add-matrix

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

1|Updated May 22, 2026
Search Tags:#messaging#channel integration#matrix#nanoclaw#homeserver#chat sdk#bot account
One-click install
npx skills add https://github.com/roseDwayane/LocalizeAgenticSys --skill add-matrix-rosedwayane
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: add-matrix
Source: https://github.com/roseDwayane/LocalizeAgenticSys/tree/main/nanoclaw/.claude/skills/add-matrix
Command: npx skills add https://github.com/roseDwayane/LocalizeAgenticSys --skill add-matrix-rosedwayane

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 automates that entire idempotent setup flow. ## Core Features & Use Cases - Adapter Installation: Fetches the Matrix adapter and its registration test from the channels branch, wires self-registration into the channel barrel, and installs the pinned @beeper/chat-adapter-matrix package. - ESM Compatibility Patching: Fixes matrix-js-sdk import paths so the adapter runs 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 invite auto-join allowlists and E2EE recovery keys. - Use Case: You want your NanoClaw agent to answer messages in a Matrix room. Run this Skill to install the adapter, configure the bot account, validate the build, and then wire the channel to an agent group. ## Quick Start Ask the assistant to add the Matrix channel 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 the add-matrix skill, which copies the Matrix adapter from the channels branch, registers it in src/channels/index.ts, installs @beeper/chat-adapter-matrix, and validates the build with a registration test. Then add your bot credentials to .env and sync them to data/env.

How do I create a Matrix bot account for an AI agent?▼

Register a separate account at app.element.io in a private window, since Matrix bots cannot DM from the user's own account. Then authenticate with either the bot's username and password or an access token retrieved from Element's Settings under Help & About.

Does the Matrix adapter work with any homeserver?▼

Yes, the adapter works with any Matrix homeserver by setting MATRIX_BASE_URL to the server address, such as https://matrix.org. It connects through the Chat SDK bridge rather than a homeserver-specific API.

Why does the Matrix adapter fail under Node 22?▼

The published adapter dist references matrix-js-sdk/lib paths without .js extensions, which Node 22 strict ESM resolution rejects. The skill includes an idempotent patch script that appends the missing extensions, and it must be re-run after any pnpm install touching the adapter.

How do I find a Matrix room ID for channel configuration?▼

For group rooms, open the room in Element, click the room name, then Settings and Advanced to find the internal room ID starting with !. Room aliases like #general:matrix.org also work, and DMs are resolved automatically via the bot's openDM.

Related Skills

Explore More Software Engineering Skills→
RADHA0-maxRADHA0-max
2

add-matrix

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

Community
Intermediate
chiptoe-svgchiptoe-svg

manage-channels

Automate messaging channel wiring to agent groups with isolation levels.

Community
Intermediate
1mancompany1mancompany
380

Multi-Channel Communications

Route and manage messages across twenty-plus platforms via an OpenClaw gateway.

Official
Advanced
alexradunetalexradunet
10

matrix

Manage a self-hosted Matrix homeserver as a native systemd service.

Community
Intermediate