Channel Capabilities

Feature Supported Notes
Direct Messages ✓ Full support for 1:1 conversations
Group Chats ✓ Participate in group conversations
Media Messages ✓ Send and receive images, files
Voice Messages — Not available
Reactions ✓ React to messages with emoji
Threads ✓ Threaded conversation support
Native Commands — Not available

Access Control Policies

DM Policies

Control who can send direct messages to your bot:

allowlist

Only senders in the allowFrom list can interact with the bot.

pairing

Unknown senders receive a pairing code that admin must approve before access is granted.

open

All direct messages are processed (requires allowFrom: ["*"]).

Group Policies

Control which groups your bot participates in:

allowlist

Only groups in groupAllowFrom are processed.

open

Bot responds in all groups it is added to.

Setup Guide

  1. Create a Matrix account on your preferred homeserver
  2. Generate an access token
  3. Configure matrix in openclaw.json
  4. Start the gateway
  5. Invite the bot to rooms

Configuration Example

{
  "channels": {
    "matrix": {
      "homeserver": "https://matrix.org",
      "accessToken": "${MATRIX_ACCESS_TOKEN}",
      "userId": "@mybot:matrix.org"
    }
  }
}

Use Matrix with AI Providers

Connect Matrix to your preferred AI model provider:

Anthropic

Creator of Claude AI models with advanced reasoning capabilities

View Guide →

OpenAI Codex

GPT models with broad capabilities and wide ecosystem support

View Guide →

Google Gemini

Multimodal AI with competitive pricing and speed

View Guide →

OpenRouter

Unified API gateway to multiple AI providers

View Guide →

Ollama

Run open-source LLMs locally with no API costs

View Guide →

AWS Bedrock

Enterprise AI through AWS with compliance and security

View Guide →

OpenAI (Standard)

Standard OpenAI API for GPT models

View Guide →

Frequently Asked Questions

How do I set up Matrix with OpenClaw?
To set up Matrix: Create a Matrix account on your preferred homeserver. Generate an access token. Configure matrix in openclaw.json. Full configuration options are available in the openclaw.json file.
How do I control who can message my Matrix bot?
Matrix supports allowlist, pairing, open for DM access control and allowlist, open for groups. Use allowlists for maximum security or pairing mode for easy onboarding.
Does Matrix support media messages?
Matrix supports media including images, audio, video, documents. Maximum media size is configurable via mediaMaxMb setting (default: 4.096MB).
Can I use OpenClaw in Matrix groups?
Matrix supports group chats with configurable access policies. Groups and DMs are supported.