Matrx Channel Plugin for OpenClaw

This plugin connects OpenClaw to the Matrx chat platform via a FastAPI service.

Installation

1. Install dependencies:

cd openclaw-matrx-plugin
npm install

2. Build the plugin:

npm run build

3. Install in OpenClaw:

openclaw plugins install /path/to/openclaw-matrx-plugin

Configuration

Add to your OpenClaw config:

channels:
  matrx:
    enabled: true
    apiUrl: "http://localhost:8000"
    botToken: "your-bot-token-here"
    dmSecurity: "allowlist"  # or "all"
    allowFrom: []  # List of allowed user IDs (for allowlist mode)

Or use environment variables:

export MATRX_API_URL="http://localhost:8000"
export MATRX_BOT_TOKEN="your-bot-token-here"

Features

• ✅ Send and receive text messages
• ✅ Send and receive images/files
• ✅ DM security with allowlist
• ✅ User pairing for new contacts
• ✅ Reply threading support
• ✅ Approval integration

FastAPI Service

This plugin requires the companion FastAPI service to be running.

See the ../fastapi-service/ directory for setup instructions.

Development

npm run dev  # Watch mode
npm run test # Run tests