Windows CI / windows ([bun run --cwd packages/app-core test bun run --cwd packages/elizaos test bun run --cwd packages/cloud/shared test], app-and-cli) (push) Waiting to run
Windows CI / windows ([bun run --cwd packages/scenario-runner test bun run --cwd packages/vault test bun run --cwd packages/security test bun run --cwd plugins/plugin-coding-tools test], framework-packages) (push) Waiting to run
Windows CI / windows ([bun run --cwd plugins/plugin-elizacloud test bun run --cwd plugins/plugin-discord test bun run --cwd plugins/plugin-anthropic test bun run --cwd plugins/plugin-openai test bun run --cwd plugins/plugin-app-control test bun run --cwd plugins/pl… (push) Waiting to run
Windows CI / windows ([node packages/scripts/run-turbo.mjs run build --filter=@elizaos/core --filter=@elizaos/shared --filter=@elizaos/agent --concurrency=4 node packages/scripts/run-bash-linux-only.mjs scripts/verify-riscv64-buildpaths.sh node packages/scripts/run… (push) Waiting to run
Windows CI / windows ([node packages/scripts/run-turbo.mjs run typecheck --filter=@elizaos/core --filter=@elizaos/shared --filter=@elizaos/cloud-shared --concurrency=4 bun run --cwd packages/core test bun run --cwd packages/shared test], core-runtime, 75) (push) Waiting to run
JSON array/object of per-account configs for multi-account setups
MATRIX_DEFAULT_ACCOUNT_ID
—
Which account is the default when multiple are configured
MATRIX_ACCOUNT_ID
—
Alias for MATRIX_DEFAULT_ACCOUNT_ID
Usage
importmatrixPluginfrom"@elizaos/plugin-matrix";// Pass to the plugin list when constructing an AgentRuntime or character config.
Connector actions
Matrix messaging is exposed through the canonical message connector. Use source: "matrix" when a request needs to target Matrix explicitly.
Operation
Description
send
Send a message to a Matrix room, channel, thread, or DM
react
React to a Matrix message with an emoji
list_channels
List joined Matrix rooms
join
Join a Matrix room by ID or alias
leave
Leave a Matrix room
There are no registered Provider objects. Room context is surfaced through the connector's getChatContext and listRooms hooks.
Events
The service emits these events via runtime.emitEvent:
Event
Trigger
MATRIX_MESSAGE_RECEIVED
Incoming m.room.message (text only; filtered by requireMention if set)
MATRIX_MESSAGE_SENT
Message sent via sendMessage
MATRIX_ROOM_JOINED
joinRoom succeeds
MATRIX_ROOM_LEFT
leaveRoom succeeds
MATRIX_SYNC_COMPLETE
Matrix PREPARED sync state
Additional constants (MATRIX_INVITE_RECEIVED, MATRIX_REACTION_RECEIVED, MATRIX_TYPING_RECEIVED, MATRIX_CONNECTION_READY, MATRIX_CONNECTION_LOST) are defined in MatrixEventTypes but not currently emitted by the service.
Message limits
Maximum message length: MAX_MATRIX_MESSAGE_LENGTH = 4000 characters (exported from src/types.ts). The service does not auto-split; callers must chunk before calling sendMessage.