Bug type

Regression (worked before, now fails)

Summary

After upgrading OpenClaw to v2026.3.22 using openclaw update, following the official Matrix migration tutorial and running openclaw doctor --fix, Matrix-related errors occur. Attempting to reinstall or repair the Matrix plugin (openclaw plugins install @openclaw/matrix) results in the same API version mismatch error.

Steps to Reproduce

1. Run openclaw update to upgrade to v2026.3.22.
2. Follow the official Matrix migration tutorial.
3. Run openclaw doctor --fix.
4. Observe the Matrix-related errors in the output.
5. Attempt to reinstall the Matrix plugin: openclaw plugins install @openclaw/matrix.
6. Observe the API version mismatch error.

Additional Information

• Matrix plugin worked normally before the upgrade.
• After doctor --fix, stale plugin entries were removed from the config, but issues persist.
• Possible root cause: Plugin API version reporting is incorrect in the runtime after upgrade.
• Suggested fix: Ensure upgrade scripts correctly update the plugin API version reporting.

Please provide more debugging info or a temporary workaround.

Expected behavior

• openclaw doctor --fix should successfully fix Matrix configuration without errors.
• openclaw plugins install @openclaw/matrix should install the plugin successfully, as the runtime version is already 2026.3.22.

Actual behavior

1. From openclaw doctor --fix:

Config warnings: 
  - plugins.entries.matrix: plugin not found: matrix (stale config entry ignored; remove it from plugins config)   

Doctor warnings:
 - Matrix migration warnings are present, but no on-disk Matrix mutation is actionable yet. No pre-migration snapshot was needed. 
 - Legacy Matrix encrypted state was detected, but the Matrix plugin helper is unavailable. Install or repair @openclaw/matrix so OpenClaw can inspect the old rust crypto store before upgrading.   

Task script: C:\Users\xxx\.openclaw\gateway.cmd
matrix: migration remains in a warning-only state; no pre-migration snapshot was needed yet

Plugin diagnostics:
 - ERROR: plugin path not found: C:\Users\xxx\AppData\Roaming\npm\node_modules\openclaw\extensions\matrix (C:\Users\xxx\AppData\Roaming\npm\node_modules\openclaw\extensions\matrix)

2. From openclaw plugins install @openclaw/matrix:

◇  Config warnings 
 - plugins.entries.matrix: plugin not found: matrix (stale config entry ignored; remove  it from plugins config)

Config invalid
File: ~\.openclaw\openclaw.json
Problem:
  - plugins.load.paths: plugin: plugin path not found: C:\Users\xxx\AppData\Roaming\npm\node_modules\openclaw\extensions\matrix
  - channels.matrix: unknown channel id: matrix
  - plugins.allow: plugin not found: matrix

3. Delete the configuration related to matrix in openclaw.json, and then re-execute openclaw plugins install @openclaw/matrix:

Resolving clawhub:@openclaw/matrix…
Plugin "@openclaw/matrix" requires plugin API >=2026.3.22, but this OpenClaw runtime exposes 1.2.0.

OpenClaw version

2026.3.22

Operating system

Windows 10

Install method

npm global

Model

Provider / routing chain

Additional provider/model setup details

No response

Logs, screenshots, and evidence

Impact and severity

Affected: Matrix channel
Severity: High
Frequency: Always
Consequence: The channel is unavailable and the data migration has failed.

Additional information

Last known good version 2026.3.13, first known bad version 2026.3.22.