Matrix — Dezentrales Chat-Netzwerk

Matrix — Dezentrales Chat-Netzwerk

Wenn du dir jemals ein Chat-Netzwerk gewünscht hast, bei dem du nicht an den Server von jemand anderem gebunden bist, ist Matrix die Antwort. Es ist ein offenes, föderiertes Messaging-Protokoll — denk an E-Mail, aber für Instant Messaging. Du kannst deinen eigenen Homeserver betreiben oder einen öffentlichen wie matrix.org nutzen. In jedem Fall behältst du die Kontrolle über deine Unterhaltungen.

Hermes Agent integriert sich direkt in Matrix über das mautrix Python-SDK. Das bedeutet, dein Bot kann über Matrix mit dir chatten und dabei alle Hermes-Fähigkeiten nutzen, die du kennst und liebst — Tool-Nutzung, Gedächtnis, Reasoning und Echtzeit-Antworten. Es verarbeitet Text, Dateien, Bilder, Audio, Video und sogar optionale Ende-zu-Ende-Verschlüsselung (E2EE).

Und das Beste daran: Hermes funktioniert mit jedem Matrix-Homeserver. Synapse, Conduit, Dendrite oder der große öffentliche auf matrix.org — wähl deinen Favoriten.

Wie sich Hermes verhält

Sobald die Verbindung steht, hat Hermes einige intelligente Standardeinstellungen. Hier die Kurzübersicht:

Kontext	Verhalten
DMs	Hermes antwortet auf jede Nachricht. Kein @Mention nötig. Jede DM bekommt ihre eigene Session.
Räume	Standardmäßig wartet Hermes auf ein @Mention, bevor es antwortet. Du kannst das mit MATRIX_REQUIRE_MENTION=false ändern oder bestimmte Räume zu MATRIX_FREE_RESPONSE_ROOMS hinzufügen. Raumeinladungen werden automatisch akzeptiert.
Threads	Hermes unterstützt Matrix-Threads vollständig. Antworte in einem Thread, und Hermes hält diesen Kontext getrennt von der Haupt-Timeline des Raums. Threads, an denen der Bot bereits teilgenommen hat, benötigen kein Mention.
Auto-Threading	Standardmäßig erstellt Hermes automatisch einen Thread für jede Antwort in einem Raum. Das hält Unterhaltungen übersichtlich und isoliert. Abschaltbar mit MATRIX_AUTO_THREAD=false.
Befehle	Normale /commands funktionieren wie erwartet. Wenn dein Client / für lokale Befehle reserviert, nutze einfach !commands — Hermes normalisiert diese Aliase automatisch.
Interaktive Steuerung	Genehmigungen für gefährliche Befehle und die /model-Auswahl können Matrix-Reaktionen nutzen. Du kannst Genehmigungs-Reaktionen sogar auf den Benutzer beschränken, der die Aktion angefordert hat.
Denk- und Tool-Aktivität	Hermes verwendet Thread-basierte, editierbare Panels für Denk- und Tool-Aktivität, wenn Gateway-Fortschritt aktiviert ist. Kein Überfluten der Haupt-Timeline mehr mit Updates.
Gemeinsame Räume	Standardmäßig isoliert Hermes den Session-Verlauf pro Benutzer innerhalb eines Raums. Zwei Personen im selben Raum teilen sich nicht ein Transkript, es sei denn, du deaktivierst das explizit.

Profi-Tipp: Lade einfach den Matrix-User des Bots in einen beliebigen Raum ein, und er tritt bei und beginnt automatisch zu antworten.

Was Hermes auf Matrix kann

Hier die vollständige Fähigkeitenliste, direkt aus der Adapter-Deklaration:

• Text — ja
• Threads — ja
• Reaktionen — ja
• Genehmigungen — ja
• Modell-Auswahl — ja
• Denk-Panels — ja
• Bilder — ja (auch mehrere Bilder)
• Dateien — ja
• Sprache/Audio — ja
• Video — ja
• E2EE — aus / optional / erforderlich (modusbasiert)
• Diagnose — ja

Session-Modell in Matrix

Standardmäßig hält Hermes alles sauber getrennt:

• Jede DM bekommt ihre eigene Session
• Jeder Thread bekommt seinen eigenen Session-Namespace
• Jeder Benutzer in einem gemeinsamen Raum bekommt seine eigene Session innerhalb dieses Raums

Das wird über config.yaml gesteuert:

group_sessions_per_user: true

Setze es nur auf false, wenn du explizit eine gemeinsame Unterhaltung für den gesamten Raum möchtest:

group_sessions_per_user: false

Gemeinsame Sessions können für einen kollaborativen Raum nützlich sein, aber Vorsicht: Benutzer teilen sich Kontextwachstum und Token-Kosten, eine lange Tool-lastige Aufgabe einer Person kann den Kontext aller anderen aufblähen, und eine laufende Ausführung einer Person kann die Folgeantwort einer anderen unterbrechen.

Mention- und Thread-Konfiguration

Du kannst alles über Umgebungsvariablen oder config.yaml anpassen. Hier die YAML-Version:

matrix:
  require_mention: true           # @Mention in Räumen erforderlich (Standard: true)
  allowed_users:                  # Matrix-Benutzer, die Agent-Turns auslösen dürfen
    - "@alice:matrix.org"
  allowed_rooms:                  # Matrix-Räume, die Agent-Turns auslösen dürfen
    - "!abc123:matrix.org"
  free_response_rooms:            # Räume ohne Mention-Pflicht
    - "!abc123:matrix.org"
  ignore_user_patterns:           # Bridge-/Appservice-Geisterbenutzer ignorieren
    - "^@telegram_"
    - "^@whatsapp_"
  process_notices: false          # m.notice standardmäßig ignorieren
  session_scope: room             # auto|room|thread; room wird für Projekt-Räume empfohlen
  auto_thread: true               # Threads für Antworten automatisch erstellen (Standard: true)
  dm_mention_threads: false       # Thread bei @Mention in DM erstellen (Standard: false)
  max_message_length: 16000       # Ausgehende Chunk-Größe in Zeichen (Standard: 16000, max: 65535)

Oder über Umgebungsvariablen:

MATRIX_REQUIRE_MENTION=true
MATRIX_ALLOWED_USERS=@alice:matrix.org
MATRIX_ALLOWED_ROOMS=!abc123:matrix.org
MATRIX_FREE_RESPONSE_ROOMS=!abc123:matrix.org,!def456:matrix.org
MATRIX_IGNORE_USER_PATTERNS='^@telegram_,^@whatsapp_'
MATRIX_PROCESS_NOTICES=false
MATRIX_SESSION_SCOPE=room       # empfohlen für stabilen Projekt-Raum-Kontext
MATRIX_AUTO_THREAD=true
MATRIX_DM_MENTION_THREADS=false
MATRIX_REACTIONS=true          # Standard: true — Emoji-Reaktionen während der Verarbeitung
MATRIX_ALLOW_ROOM_MENTIONS=false

Tipp: MATRIX_REACTIONS=false deaktiviert die Emoji-Reaktionen des Verarbeitungs-Lebenszyklus (👀/✅/❌), die der Bot auf eingehende Nachrichten postet. Praktisch für Räume, in denen Reaktions-Events störend oder nicht unterstützt sind.

Noch ein Tipp: Hermes sendet strukturierte Matrix-Benutzer-Mentions für explizite IDs wie @alice:example.org. Raumweite @room-Mentions werden separat gesteuert.

Das ist das vollständige Matrix-Bild. Ob du nun deinen eigenen Homeserver betreibst oder einfach einen dezentralen Chat möchtest, der deine Privatsphäre respektiert — Hermes hat dich abgedeckt. Lade deinen Bot in einen Raum ein und sieh ihn in Aktion!