OpenClaw Matrix

Matrix setup step by step

Use this page when you want OpenClaw connected to Matrix and need the right expectations for homeserver credentials, room identity, and room-level reply behavior.

Core ideaA healthy Matrix connection still does not prove the bot can answer in the room you care about.

Setup order

Build transport first, then verify room behavior separately

collect the homeserver and credential shape the runtime will really use
validate the config before applying it
test a direct-message path first
test room behavior separately
only then widen access intentionally

Common failures

Most Matrix confusion comes from room identity and membership assumptions

Transport

Credential or homeserver mismatch

The configured connection shape does not match what the running service can actually use.

Rooms

Bot is not in the right room

The connection is healthy, but room membership still blocks the expected reply path.

Policy

DM and room behavior were mixed together

A working DM path does not automatically mean room behavior is ready.