Matrix

What this surface is for

Chat endpoint

Behavior in the current codebase

• Brings Tater to federated chat networks like Element and Cinny.
• Can operate with end-to-end encryption and persistent Matrix device state.
• Supports mention triggers, room response modes, and Verba Plugin-backed actions.

Direct platform support

25 current Verba Plugins advertise direct support for this surface.

Configuration schema

• Admin User ID string

  Only this Matrix user can run admin-only tools (use full MXID like @user:server).

  Key: admin_user_id
• Access Token (optional) string

  Prefer access token; if blank, password login will be attempted.

  Key: matrix_access_token
• Device Name string

  Device name shown in Matrix sessions

  Key: matrix_device_name Default: TaterBot
• Homeserver URL string

  Matrix homeserver base URL (e.g., https://matrix.example.com)

  Key: matrix_hs Default: https://matrix-client.matrix.org
• Password (fallback) string

  Used only if access token is empty.

  Key: matrix_password
• Pickle Key string

  Secret used to encrypt local store; fallback to MATRIX_PICKLE_KEY env

  Key: matrix_pickle_key
• Store Path string

  Persistent path for nio store (devices, sessions, etc.)

  Key: matrix_store_path Default: /app/matrix-store
• User ID string

  Matrix user id for the bot (e.g., @tater:example.com)

  Key: matrix_user Default: @tater:example.com
• Max Response Chunk Length number

  Max Response Chunk Length

  Key: max_response_length Default: 4000
• Mention Keywords string

  Comma-separated triggers (e.g. 'tater, taterbot') to count as mentions

  Key: mention_keywords
• Response Policy select

  When to respond in rooms

  Key: response_policy Default: mention_only Options: mention_only, all_messages
• Resume Mode select

  from_now = ignore backlog on startup; from_last_sync = process all missed messages

  Key: resume_mode Default: from_now Options: from_now, from_last_sync
• Trust Unverified Devices select

  If true, the bot auto-trusts/ignores unverified devices so it can send E2EE.

  Key: trust_unverified_devices Default: true Options: true, false