Start Connect Matrix

Matrix Integration for OpenClaw

Matrix is a decentralized, open-source messaging protocol. Connecting OpenClaw to Matrix gives you a self-hosted, privacy-respecting communication channel with your AI agent.

Prerequisites

• A Matrix homeserver (self-hosted Synapse, Dendrite, or a hosted account on matrix.org)
• A dedicated Matrix account for your agent
• OpenClaw installed and running

Setup Steps

1. Create a new Matrix account for your agent on your homeserver
2. Add the Matrix channel to OpenClaw: openclaw channel add matrix
3. Configure the connection:

{
  "channels": {
    "matrix": {
      "homeserver": "https://matrix.yourdomain.com",
      "userId": "@openclaw-bot:yourdomain.com",
      "accessToken": "YOUR_ACCESS_TOKEN",
      "autoJoinRooms": false,
      "encryptedRooms": true
    }
  }
}

End-to-End Encryption

Matrix supports end-to-end encryption (E2EE) via the Olm protocol. When encryptedRooms is enabled, all messages between you and the agent are encrypted — even the homeserver operator cannot read them.

Why Matrix?

• Self-hosted: Complete control over your data and infrastructure
• Decentralized: No single point of failure or corporate dependency
• Interoperable: Bridge to other platforms (Slack, Discord, IRC) through Matrix bridges
• Open protocol: Full transparency — you can audit every line of code