🔗

Matrix Integration

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

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

  1. Register a new user on your Matrix homeserver (e.g., @openclaw:your-server.com)
  2. Note the username, password, and homeserver URL
  3. 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.