Skip to content
Get packs

Add Matrix Channel

Connects a NanoClaw agent to Matrix chat rooms through a separate bot account.

Source Download skill
Repository
nanocoai/nanoclaw
Stars
31,072
Licence
MIT
Files
3 files

What it does

This skill adds Matrix chat as a way to talk to a NanoClaw assistant. It copies a Matrix adapter file into the project, registers it, installs a pinned adapter package, builds and tests the project, and then walks you through creating a separate Matrix bot account and saving its login details to the configuration. Once running, people can message the bot in Matrix rooms or direct messages.

Great for

  • Developers running NanoClaw who want their assistant reachable from Matrix or Element
  • People who already use a Matrix homeserver such as matrix.org and want a dedicated bot account

Skip it if

  • Users who do not want to create a separate bot account and store its password or access token locally, since the setup depends on both
  • Teams needing guaranteed threaded conversations, because the skill notes thread support is partial and treats it as unsupported

Try asking

  • “Add Matrix as a channel to my NanoClaw assistant”
  • “Set up a Matrix bot on matrix.org for my team room”
  • “Connect NanoClaw to my self-hosted Matrix homeserver”
Step-by-step guide: how to use Add Matrix ChannelInstall, first run, examples, tips and FAQs

Install in 3 steps

  1. 1

    Download the skill

    The ZIP contains the 3 original files, the MIT licence and an attribution note.

    add-matrix.zip
  2. 2

    Add it to your agent

    Claude Code (all projects)

    mkdir -p ~/.claude/skills && unzip add-matrix.zip -d ~/.claude/skills/

    Claude Code / Agent SDK (this project only)

    mkdir -p .claude/skills && unzip add-matrix.zip -d .claude/skills/

    Claude apps (web/desktop): Settings → Capabilities → Skills → Upload skill, and choose the ZIP.

  3. 3

    Ask for the task

    No special command needed — the agent reads the skill's description and loads it when your request matches. Try one of the prompts above.

Get better results

  • Use a dedicated bot account rather than your personal one, since Matrix cannot DM yourself and the setup expects a separate login.
  • Prefer the access token option over a stored password where possible, and keep the .env file out of version control.
  • After applying, run /manage-channels to connect the Matrix channel to an agent group, and test with a message in a room you control first.

What's inside

  • apply-fixtures.json
  • REMOVE.md
  • SKILL.md

Redistributed unmodified from nanocoai/nanoclaw under the MIT licence. The assessment was drafted with AI from the skill's files on 2026-10-29. Skills can instruct your agent to run code — read SKILL.md and any scripts before installing.