Connect OpenClaw to Matrix for decentralized AI messaging. This guide covers OpenClaw v2026.2+, homeserver configuration, bot user registration, end-to-end encryption, and room management for self-hosted AI assistants.

🔗

Matrix Integration

Connect OpenClaw to Matrix and have your AI assistant on a decentralized network.

Decentralized 10 min setup E2E Encryption

TL;DR

✓ Register a bot user on your Matrix homeserver
✓ Configure homeserver and credentials in openclaw.json
✓ Optional: Enable end-to-end encryption
✓ Time: ~10 minutes

Setup Steps

Step 1: Register Bot User

Register a new user on your Matrix homeserver (e.g., @openclaw:your-server.com)
Note the username, password, and homeserver URL
Ensure the bot user is allowed to join rooms

Tip: Many homeservers like matrix.org, element.io, or self-hosted Synapse allow bot registration.

Step 2: Configure openclaw.json

{
  "channels": {
    "matrix": {
      "enabled": true,
      "homeserver": "https://matrix.org",
      "userId": "@openclaw:matrix.org",
      "password": "your-bot-password",
      "deviceId": "OPENCLAW",
      "storePath": "./data/matrix-store"
    }
  }
}

Step 3: Enable End-to-End Encryption (Optional)

{
  "channels": {
    "matrix": {
      "enabled": true,
      "homeserver": "https://matrix.org",
      "userId": "@openclaw:matrix.org",
      "password": "your-bot-password",
      "deviceId": "OPENCLAW",
      "encryption": {
        "enabled": true,
        "verifyDevices": false
      }
    }
  }
}

Step 4: Start OpenClaw

openclaw start

Your Matrix bot is now active! Invite the bot to rooms to start chatting.

Features

Decentralized

Works with any Matrix homeserver worldwide.

E2E Encryption

Optional end-to-end encryption support.

Room Management

Join multiple rooms and manage conversations.

Voice Messages

Support for voice message processing.

Frequently Asked Questions

What Matrix homeservers can I use?

OpenClaw works with any Matrix homeserver including matrix.org, element.io, or self-hosted homeservers like Synapse.

Is end-to-end encryption supported?

Yes, enable encryption in openclaw.json. The bot will store encryption keys locally for decrypting messages.

Can the bot join multiple rooms?

Yes, invite the bot to any room and it will respond to messages based on your configuration.

Do I need admin access to the homeserver?

No, you just need permission to register a bot user. Most homeservers allow regular users to create bot accounts.