Files
wehub-resource-sync 426e9eeabd
Benchmark Bridge Tests / benchmark (bunx @biomejs/biome check packages/lifeops-bench/src, benchmark-lint) (push) Waiting to run
Benchmark Bridge Tests / benchmark (bunx vitest run --config packages/lifeops-bench/vitest.config.ts --root packages/lifeops-bench --passWithNoTests, benchmark-tests) (push) Waiting to run
Build Agent Image / build-and-push (push) Waiting to run
Chat shell gestures / Chat shell gesture + parity e2e (push) Waiting to run
Cloud Gateway Discord / Test (push) Waiting to run
Cloud Gateway Webhook / Test (push) Waiting to run
Cloud Tests / lint-and-types (push) Waiting to run
Cloud Tests / unit-tests (push) Waiting to run
Cloud Tests / integration-tests (push) Waiting to run
Cloud Tests / e2e-tests (push) Blocked by required conditions
CodeQL Advanced / Analyze (javascript-typescript) (push) Waiting to run
Deploy Apps Worker (Product 2) / Determine environment (push) Waiting to run
Deploy Apps Worker (Product 2) / Deploy apps worker to apps-control host (${{ needs.determine-env.outputs.environment }}) (push) Blocked by required conditions
Deploy Eliza Provisioning Worker / Determine environment (push) Waiting to run
Deploy Eliza Provisioning Worker / Deploy worker to Hetzner host (${{ needs.determine-env.outputs.environment }} @ ${{ needs.determine-env.outputs.deployment_sha }}) (push) Blocked by required conditions
Dev Smoke / Classify changed paths (push) Waiting to run
Dev Smoke / bun run dev onboarding chat (push) Blocked by required conditions
Dev Smoke / Vite HMR dependency-level smoke (push) Blocked by required conditions
Electrobun Submodule Guard / electrobun gitlink is fetchable (push) Waiting to run
Publish @elizaos/example-code / check_npm (push) Waiting to run
Publish @elizaos/example-code / publish_npm (push) Blocked by required conditions
Publish @elizaos/plugin-elizacloud / verify_version (push) Waiting to run
Publish @elizaos/plugin-elizacloud / publish_npm (push) Blocked by required conditions
Sandbox Live Smoke / Sandbox live smoke (push) Waiting to run
Snap Build & Test / Build Snap (amd64) (push) Waiting to run
Snap Build & Test / Build Snap (arm64) (push) Waiting to run
supply-chain / sbom (push) Waiting to run
supply-chain / vulnerability-scan (push) Waiting to run
Build, Push & Deploy to Phala Cloud / build-and-push (push) Waiting to run
Test Packaging / Validate Packaging Configs (push) Waiting to run
Test Packaging / PyPI on Python ${{ matrix.python }} (push) Waiting to run
Test Packaging / Pack & Test JS Tarballs (push) Waiting to run
Test Packaging / elizaos CLI global-install smoke (node + bun) (push) Waiting to run
UI Fixture E2E / ui-fixture-e2e (push) Waiting to run
UI Fixture E2E / fixture-e2e (push) Waiting to run
UI Story Gate / story-gate (push) Waiting to run
vault-ci / test (macos-latest) (push) Waiting to run
vault-ci / test (ubuntu-latest) (push) Waiting to run
vault-ci / test (windows-latest) (push) Waiting to run
vault-ci / app-core wiring tests (push) Waiting to run
verify-patches / verify patches/CHECKSUMS.sha256 (push) Waiting to run
Voice Benchmark Smoke / voice-emotion fixture smoke (push) Waiting to run
Voice Benchmark Smoke / voiceagentbench fixture smoke (push) Waiting to run
Voice Benchmark Smoke / voicebench-quality unit smoke (push) Waiting to run
Voice Benchmark Smoke / voicebench TypeScript unit (no audio) (push) Waiting to run
Voice Benchmark Smoke / voice bench smoke summary (push) Blocked by required conditions
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
Test Packaging / Build & Test PyPI Package (push) Waiting to run
Voice Workbench / headless workbench (mocked backends) (push) Has been cancelled
Voice Workbench / real acoustic lane (nightly, provisioned only) (push) Has been cancelled
ci / test (push) Has been cancelled
ci / lint-and-format (push) Has been cancelled
ci / build (push) Has been cancelled
ci / dev-startup (push) Has been cancelled
gitleaks / gitleaks (push) Has been cancelled
Markdown Links / Relative Markdown Links (push) Has been cancelled
Quality (Extended) / Homepage Build (PR smoke) (push) Has been cancelled
Quality (Extended) / Comment-only diff guard (push) Has been cancelled
Quality (Extended) / Format + Type Safety Ratchet (push) Has been cancelled
Quality (Extended) / Develop Gate (secret scan + UI determinism) (push) Has been cancelled
Quality (Extended) / Develop Gate (lint) (push) Has been cancelled
chore: import upstream snapshot with attribution
2026-07-13 12:43:05 +08:00
..

@elizaos/plugin-matrix

Matrix messaging integration plugin for elizaOS agents.

Features

  • Connect to any Matrix homeserver via matrix-js-sdk
  • Receive and send messages in Matrix rooms
  • Room membership: join, leave, auto-join on invite
  • Reactions, threading, typing indicators, read receipts
  • Optional E2EE support
  • Multi-account configuration

Configuration

Set the following environment variables:

Required

Variable Description
MATRIX_HOMESERVER Homeserver URL (e.g., https://matrix.org)
MATRIX_USER_ID Full Matrix user ID (@user:homeserver.org)
MATRIX_ACCESS_TOKEN Access token for authentication

Optional

Variable Default Description
MATRIX_DEVICE_ID Auto-generated Device ID for this session
MATRIX_ROOMS Comma-separated room IDs/aliases to auto-join
MATRIX_AUTO_JOIN false Auto-accept room invites
MATRIX_ENCRYPTION false Enable E2EE support
MATRIX_REQUIRE_MENTION false Only respond when mentioned in rooms
MATRIX_ACCOUNTS 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

import matrixPlugin from "@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.

Matrix ID formats

  • User ID: @localpart:homeserver.org
  • Room ID: !opaque_id:homeserver.org
  • Room Alias: #human_readable:homeserver.org