Summary
After upgrading from 2026.2.25 to 2026.3.2 via npm update -g openclaw, the Matrix channel plugin fails to load on every gateway start with the following error:
[plugins] matrix failed to load from /opt/homebrew/lib/node_modules/openclaw/extensions/matrix/index.ts: Error: Cannot find module '/opt/homebrew/lib/node_modules/openclaw/dist/plugin-sdk/index.js/keyed-async-queue'
Require stack:
- /opt/homebrew/lib/node_modules/openclaw/extensions/matrix/src/matrix/send-queue.ts
Environment
- OpenClaw version: 2026.3.2 (upgraded from 2026.2.25)
- OS: macOS Darwin 23.4.0 (arm64)
- Node: v23.10.0
- Install method:
npm install -g openclaw via Homebrew Node
- Install path:
/opt/homebrew/lib/node_modules/openclaw
Steps to Reproduce
- Upgrade OpenClaw to 2026.3.2:
npm update -g openclaw
- Restart gateway:
openclaw gateway restart
- Observe error in
openclaw channels status or gateway error log
Expected Behaviour
Matrix plugin loads successfully and connects to homeserver.
Actual Behaviour
Plugin fails to load. Matrix channel is completely unavailable. WhatsApp and other channels are unaffected.
Root Cause (suspected)
The file /opt/homebrew/lib/node_modules/openclaw/dist/plugin-sdk/index.js exists, but the module resolver is treating it as a directory and looking for keyed-async-queue inside it (i.e. plugin-sdk/index.js/keyed-async-queue). This suggests the keyed-async-queue export is missing from the plugin-sdk dist bundle in 2026.3.2 — it may have been accidentally omitted during the release build.
# Confirmed: no 'queue' files in plugin-sdk dist
ls /opt/homebrew/lib/node_modules/openclaw/dist/plugin-sdk/ | grep -i queue
# (no output)
Workaround
None available. Downgrading to 2026.2.25 restores Matrix but reintroduces the claude-sonnet-4-5-20250514 unknown model error that prompted the upgrade.
Additional Context
Prior to 2026.3.2, the Matrix plugin was failing with a different error (Cannot find module '@vector-im/matrix-bot-sdk'), so the extension may have had pre-existing issues that were partially addressed in 2026.3.2 but introduced this new one.
Summary
After upgrading from
2026.2.25to2026.3.2vianpm update -g openclaw, the Matrix channel plugin fails to load on every gateway start with the following error:Environment
npm install -g openclawvia Homebrew Node/opt/homebrew/lib/node_modules/openclawSteps to Reproduce
npm update -g openclawopenclaw gateway restartopenclaw channels statusor gateway error logExpected Behaviour
Matrix plugin loads successfully and connects to homeserver.
Actual Behaviour
Plugin fails to load. Matrix channel is completely unavailable. WhatsApp and other channels are unaffected.
Root Cause (suspected)
The file
/opt/homebrew/lib/node_modules/openclaw/dist/plugin-sdk/index.jsexists, but the module resolver is treating it as a directory and looking forkeyed-async-queueinside it (i.e.plugin-sdk/index.js/keyed-async-queue). This suggests thekeyed-async-queueexport is missing from theplugin-sdkdist bundle in 2026.3.2 — it may have been accidentally omitted during the release build.Workaround
None available. Downgrading to 2026.2.25 restores Matrix but reintroduces the
claude-sonnet-4-5-20250514unknown model error that prompted the upgrade.Additional Context
Prior to 2026.3.2, the Matrix plugin was failing with a different error (
Cannot find module '@vector-im/matrix-bot-sdk'), so the extension may have had pre-existing issues that were partially addressed in 2026.3.2 but introduced this new one.