openclaw - 💡(How to fix) Fix Matrix plugin: room messages received via sync but not routed to agent sessions [2 comments, 2 participants]

Official PRs (…)
ON THIS PAGE

Recommended Tools

×6

Utilities matched from this issue’s tags and category — try them while you read without losing context.

GitHub issue graph ai analysis

Paste a GitHub issue URL. We fetch that issue, discover linked issues from bodies/comments/timeline, collect linked pull requests, and produce a structured English report.

The report is written in English Markdown for sharing and archival.

Helpful · Quick feedback

Loading…
GitHub stats
openclaw/openclaw#60442Fetched 2026-04-08 02:51:11
View on GitHub
Comments
2
Participants
2
Timeline
6
Reactions
0
Author
Participants
Timeline (top)
commented ×2mentioned ×2subscribed ×2

Code Example

{
  "channels": {
    "matrix": {
      "enabled": true,
      "homeserver": "http://100.82.28.25:8008",
      "accessToken": "<token>",
      "userId": "@mulder:matrix.fliite.systems",
      "defaultAccount": "mulder",
      "groupPolicy": "open",
      "autoJoinAllowlist": ["!HEZUWWJZXlBozgwzjI:matrix.fliite.systems"],
      "accounts": {
        "mulder": {
          "enabled": true,
          "groupPolicy": "open",
          "autoJoinAllowlist": ["!HEZUWWJZXlBozgwzjI:matrix.fliite.systems"]
        }
      }
    }
  }
}
RAW_BUFFERClick to expand / collapse

Homebrew install, MacOS, OpenClaw latest

Describe the bug Matrix plugin successfully syncs room messages (verified via API - messages appear in sync response for room !HEZUWWJZXlBozgwzjI:matrix.fliite.systems), but the plugin does not create agent sessions from these inbound room messages. The plugin appears to receive the sync data but does not route room messages to agent sessions.

To Reproduce

  1. Configure Matrix channel with room allowlist and groupPolicy: open
  2. Join a room (X-Files Coordination) with bot account
  3. Send message to room from another user
  4. Verified via curl: message appears in Matrix sync response
  5. No agent session is created - no response from OpenClaw agent

Expected behavior Room messages should trigger an agent session and receive a response, same as Telegram and DM events do.

Sync data confirms message receipt: Room: !HEZUWWJZXlBozgwzjI:matrix.fliite.systems @theagent:matrix.fliite.systems | m.room.message | body: 'Message to group' @scully:matrix.fliite.systems | m.room.message | body: 'Testing group chat'

Messages are in the sync, but no session created.

Config (redacted):

{
  "channels": {
    "matrix": {
      "enabled": true,
      "homeserver": "http://100.82.28.25:8008",
      "accessToken": "<token>",
      "userId": "@mulder:matrix.fliite.systems",
      "defaultAccount": "mulder",
      "groupPolicy": "open",
      "autoJoinAllowlist": ["!HEZUWWJZXlBozgwzjI:matrix.fliite.systems"],
      "accounts": {
        "mulder": {
          "enabled": true,
          "groupPolicy": "open",
          "autoJoinAllowlist": ["!HEZUWWJZXlBozgwzjI:matrix.fliite.systems"]
        }
      }
    }
  }
}

Gateway log shows no session creation for room messages. Only DM events create sessions.

Environment:

  • OpenClaw: 2026.4.1 (latest as of 2026-04-03)
  • Matrix homeserver: Synapse on LXC 137 (Debian, userspace Tailscale)
  • macOS guest agent

extent analysis

TL;DR

The Matrix plugin may not be properly configured or handling room messages, resulting in no agent sessions being created, and verifying the plugin's message handling logic and configuration is necessary.

Guidance

  • Review the Matrix plugin's configuration to ensure it is correctly set up to handle room messages and create agent sessions.
  • Check the plugin's documentation to see if there are any specific settings or options required for room message handling.
  • Verify that the groupPolicy setting is correctly set to open for both the channel and account configurations.
  • Investigate the plugin's message handling logic to determine why room messages are not being routed to agent sessions.

Example

No code snippet is provided as the issue does not contain sufficient information about the plugin's code or implementation.

Notes

The issue may be related to the plugin's configuration or implementation, and further investigation is needed to determine the root cause. The provided configuration appears to be correct, but there may be other settings or options that need to be checked.

Recommendation

Apply workaround: Verify the plugin's configuration and message handling logic to ensure it is correctly set up to handle room messages and create agent sessions. This is recommended as the issue appears to be related to the plugin's configuration or implementation, and upgrading to a fixed version is not implied in the issue.

Vote matrix · Quick signals

Works
Did the solution work? Tap to confirm.
Easy Fix
Was it a quick fix?
Time Saver
Did it save you time?
Blocking
Was it severely blocking?
Common Issue
Are others likely hitting this too?
Flaky / Intermittent
Is it intermittent?
Verified / Reproducible
Can you reproduce it reliably?
Loading…

Still need to ship something?

×6

Another batch ranked right after the header list — different links, same matching logic.

Back to top recommendations

TRENDING