← Back to Channels and integrationsOpenClaw channels
Matrix setup step by step
Matrix setup is usually about transport shape plus room membership discipline. Room assumptions cause more trouble than people expect.
Matrix ruleDo not assume DM success proves room success. Membership and room identity are separate checks.
Setup ladder
The order that keeps Matrix debuggable
- Confirm homeserver and credential health. The runtime must actually connect with the intended Matrix account.
- Test a DM path. Confirm the simplest route first.
- Test the target room. Room membership and identity should be verified separately.
- Check room policy assumptions. Shared-space behavior should be tested in the real room, not inferred.
Common blockers
What usually goes wrong first on Matrix
Credential or homeserver mismatchThe configured transport shape does not match the account or homeserver the runtime is actually using.
Room membership problemThe connection is healthy, but the bot is not really present in the room you expected.
DM and room behavior got mixed togetherA working DM path does not automatically mean room behavior is healthy.
Open deeper reference links for this page