Matrix Chat Bridge

Docs reviewedWe read the code and docs, but haven’t run it ourselves.

Bind a Matrix bot account to each Paperclip agent with its own room allowlist and wake policy. Inbound messages become agent-session prompts, and the agent’s final reply is posted back to the room. A built-in Matrix sync client runs inside the plugin worker, with per-room sessions and !status and !new commands.

namhtpyn/paperclip-plugin-matrix-chatv0.5.1GitHub stars: 0Updated npm 201/mo downloads

InstallView source (opens in a new tab)

No screenshots yet. The repo doesn’t include any.

Our take

You’ll need a Matrix homeserver and one Matrix account per agent. Anyone in a bridged room can prompt the agent, and an empty allowlist bridges every room the bot joins, so set the allowlist first.

Based on the repo as of . Read the README (opens in a new tab)

What it does

  • One Matrix bot account per agent
  • Mention or all-message wake modes with room allowlists
  • Per-room sessions with !status and !new commands

Install

There’s a matching npm package, but the README documents a local-path install.

Requires Paperclip plugin API v1 · Node.js 22.14+.

git clone https://github.com/namhtpyn/paperclip-plugin-matrix-chat.git
cd paperclip-plugin-matrix-chat
npm install
npm run build
  1. Build the checkout with npm install and npm run build.
  2. Install its absolute path in Settings → Plugins, from a persistent location on the Paperclip volume.
  3. Store each bot’s Matrix access token as a secret, then configure the homeserver URL, agent endpoints and room allowlists.

Reviews

No reviews yet. Tried it? Tell others how it went.

Write a review

At least 20 characters. We read every review before it goes live.