[Bug]: Matrix plugin non-functional #5292
Description
Summary
What went wrong?
The Matrix plugin does not work.
Steps to reproduce
- Install the Matrix plugin as described as the docs
- Run
MATRIX_ACCESS_TOKEN=[...] MATRIX_HOMESERVER=https://[...] openclaw gateway - Observe the logs being spammed with a warning and more importantly this:
08:41:52 [gateway] [plugins] failed to load plugin: Error: Cannot find module '@vector-im/matrix-bot-sdk'
Require stack:
- /home/nyx/.openclaw/extensions/matrix/src/matrix/client/config.ts (plugin=matrix, source=/home/nyx/.openclaw/extensions/matrix/index.ts)
Expected behavior
What did you expect to happen?
Matrix plugin to work properly
Actual behavior
What actually happened?
Does not connect to matrix (the admin api says it has no devices)
Environment
- Clawdbot version:
2026.1.29 - OS: Arch Linux
- Install method (pnpm/npx/docker/etc):
npm
Logs or screenshots
Paste relevant logs or add screenshots (redact secrets).
Config warnings:\n- plugins.entries.matrix: plugin matrix: duplicate plugin id detected; later plugin may be overridden (/usr/lib/node_modules/openclaw/extensions/matrix/index.ts)
Config warnings:\n- plugins.entries.matrix: plugin matrix: duplicate plugin id detected; later plugin may be overridden (/usr/lib/node_modules/openclaw/extensions/matrix/index.ts)
Config warnings:\n- plugins.entries.matrix: plugin matrix: duplicate plugin id detected; later plugin may be overridden (/usr/lib/node_modules/openclaw/extensions/matrix/index.ts)
Config warnings:\n- plugins.entries.matrix: plugin matrix: duplicate plugin id detected; later plugin may be overridden (/usr/lib/node_modules/openclaw/extensions/matrix/index.ts)
Config warnings:\n- plugins.entries.matrix: plugin matrix: duplicate plugin id detected; later plugin may be overridden (/usr/lib/node_modules/openclaw/extensions/matrix/index.ts)
Config warnings:\n- plugins.entries.matrix: plugin matrix: duplicate plugin id detected; later plugin may be overridden (/usr/lib/node_modules/openclaw/extensions/matrix/index.ts)
Config warnings:\n- plugins.entries.matrix: plugin matrix: duplicate plugin id detected; later plugin may be overridden (/usr/lib/node_modules/openclaw/extensions/matrix/index.ts)
Config warnings:\n- plugins.entries.matrix: plugin matrix: duplicate plugin id detected; later plugin may be overridden (/usr/lib/node_modules/openclaw/extensions/matrix/index.ts)
08:46:50 [plugins] matrix failed to load from /home/nyx/.openclaw/extensions/matrix/index.ts: Error: Cannot find module '@vector-im/matrix-bot-sdk'
Require stack:
- /home/nyx/.openclaw/extensions/matrix/src/matrix/client/config.ts
🦞 OpenClaw 2026.1.29 (a5b4d22) — The only crab in your contacts you actually want to hear from. 🦞
(node:98783) [DEP0040] DeprecationWarning: The `punycode` module is deprecated. Please use a userland alternative instead.
(Use `node --trace-deprecation ...` to show where the warning was created)
│
◇ Config warnings ─────────────────────────────────────────────────────────────────────────╮
│ │
│ - plugins.entries.matrix: plugin matrix: duplicate plugin id detected; later plugin may │
│ be overridden (/usr/lib/node_modules/openclaw/extensions/matrix/index.ts) │
│ │
├───────────────────────────────────────────────────────────────────────────────────────────╯
08:46:50 [gateway] [plugins] duplicate plugin id detected; later plugin may be overridden (/usr/lib/node_modules/openclaw/extensions/matrix/index.ts) (plugin=matrix, source=/usr/lib/node_modules/openclaw/extensions/matrix/index.ts)
08:46:50 [gateway] [plugins] failed to load plugin: Error: Cannot find module '@vector-im/matrix-bot-sdk'
Require stack:
- /home/nyx/.openclaw/extensions/matrix/src/matrix/client/config.ts (plugin=matrix, source=/home/nyx/.openclaw/extensions/matrix/index.ts)