Problem
The Matrix plugin fails to load after OpenClaw updates with:
[plugins] matrix failed to load from extensions/matrix/index.ts: Error: Cannot find module '@vector-im/matrix-bot-sdk'
Root Cause
@vector-im/matrix-bot-sdk is declared in both the main package.json and extensions/matrix/package.json, but pnpm silently fails to install it during updates. Likely due to the native module dependency @matrix-org/matrix-sdk-crypto-nodejs failing compilation.
The module exists in the dependency tree but doesn't end up in node_modules/ after pnpm install.
Reproduction
- Install OpenClaw via pnpm
- Run
openclaw doctor — Matrix shows as error, missing module
- Manual fix:
cd /opt/homebrew/lib/node_modules/openclaw && pnpm add @vector-im/matrix-bot-sdk
openclaw gateway restart — Matrix loads
Frequency
This has occurred on at least two separate occasions (2026-02-01 and 2026-02-13) after updates.
Environment
- macOS 26.2 (arm64 / Apple Silicon)
- Node 25.4.0
- pnpm 10.29.3
- OpenClaw 2026.2.12
Suggested Fix
Either bundle the pre-built binary or add a post-install hook that verifies the matrix extension dependencies are present.
Problem
The Matrix plugin fails to load after OpenClaw updates with:
Root Cause
@vector-im/matrix-bot-sdkis declared in both the mainpackage.jsonandextensions/matrix/package.json, but pnpm silently fails to install it during updates. Likely due to the native module dependency@matrix-org/matrix-sdk-crypto-nodejsfailing compilation.The module exists in the dependency tree but doesn't end up in
node_modules/afterpnpm install.Reproduction
openclaw doctor— Matrix shows as error, missing modulecd /opt/homebrew/lib/node_modules/openclaw && pnpm add @vector-im/matrix-bot-sdkopenclaw gateway restart— Matrix loadsFrequency
This has occurred on at least two separate occasions (2026-02-01 and 2026-02-13) after updates.
Environment
Suggested Fix
Either bundle the pre-built binary or add a post-install hook that verifies the matrix extension dependencies are present.