hermes-bsd/plugins/platforms/matrix/plugin.yaml

42 lines
1.5 KiB
YAML
Raw Normal View History

name: matrix-platform
label: Matrix
kind: platform
version: 1.0.0
description: >
Matrix gateway adapter for Hermes Agent.
Connects to a Matrix homeserver via mautrix (with optional E2EE) and relays
messages between Matrix rooms/DMs and the Hermes agent. Supports threads,
HTML/markdown rendering, native media uploads, mention gating, free-response
rooms, and per-room allowlists.
author: NousResearch
requires_env:
- name: MATRIX_HOMESERVER
description: "Matrix homeserver URL (e.g. https://matrix.org)"
prompt: "Matrix homeserver URL"
password: false
- name: MATRIX_ACCESS_TOKEN
description: "Matrix access token (or use MATRIX_PASSWORD for password login)"
prompt: "Matrix access token"
password: true
optional_env:
- name: MATRIX_PASSWORD
description: "Matrix account password (alternative to MATRIX_ACCESS_TOKEN)"
prompt: "Matrix password"
password: true
- name: MATRIX_ALLOWED_USERS
description: "Comma-separated Matrix user IDs allowed to talk to the bot"
prompt: "Allowed users (comma-separated)"
password: false
- name: MATRIX_ALLOW_ALL_USERS
description: "Allow any Matrix user to trigger the bot (dev only)"
prompt: "Allow all users? (true/false)"
password: false
- name: MATRIX_HOME_CHANNEL
description: "Default room ID for cron / notification delivery"
prompt: "Home room ID"
password: false
- name: MATRIX_HOME_CHANNEL_NAME
description: "Display name for the Matrix home room"
prompt: "Home room display name"
password: false