Matrix mit OpenClaw verbinden: Räume, Push-Regeln und sichere Replies

Matrix bringt OpenClaw in offene Chat-Räume: mit DMs, Gruppenräumen, Medien, Umfragen und optionaler Ende-zu-Ende-Verschlüsselung. Das offizielle @openclaw/matrix-Plugin ist damit vor allem für Projekte interessant, die nicht komplett von Discord, Telegram oder Slack abhängen möchten.

Der praktische Weg ist überschaubar: Plugin installieren, Matrix-Konto konfigurieren, Räume begrenzen und Benachrichtigungen sauber einstellen. Wer Matrix selbst hostet oder bewusst einen öffentlichen Homeserver nutzt, gewinnt mehr Kontrolle über Daten, Räume und Push-Verhalten – bezahlt das aber mit etwas mehr Setup-Aufwand.

Installation: Das Matrix-Plugin aktivieren

Der Einstieg beginnt laut OpenClaw-Dokumentation mit einem Installationsbefehl:

openclaw plugins install @openclaw/matrix

Das Kommando installiert das Plugin aus der OpenClaw-Plugin-Registry und aktiviert es direkt. Ein separater enable-Schritt ist dafür nicht nötig. Wenn du die Quelle ausdrücklich festlegen möchtest, kannst du laut OpenClaw-Dokumentation Varianten wie clawhub:@openclaw/matrix oder npm:@openclaw/matrix verwenden. Für lokale Entwicklungsversionen akzeptiert das Install-Kommando auch einen Pfad.

Nach der Installation steht der Channel-Typ matrix zur Verfügung. Das Plugin nutzt die Matrix-JavaScript-SDK und greift damit auf die Funktionen der Matrix-API zurück, die für Nachrichten, Räume und Verschlüsselung relevant sind.

Konto einrichten: Homeserver und Anmeldung

Damit OpenClaw Nachrichten empfangen und senden kann, braucht das Plugin Zugang zu einem Matrix-Homeserver. Die Konfiguration liegt im Abschnitt channels.matrix der OpenClaw-Konfiguration.

Du hast zwei typische Wege:

1. Access Token: Du hinterlegst homeserver, etwa https://matrix.example.org, und ein bereits erzeugtes accessToken.
2. Benutzerkonto: Du konfigurierst homeserver, userId, etwa @bot:example.org, und password; OpenClaw kann daraus beim Setup ein Token beziehen.

Für einen interaktiven Durchlauf nennt die OpenClaw-Dokumentation die Befehle openclaw channels add und openclaw configure --section channels. Der Assistent fragt dabei unter anderem Homeserver-URL, Authentifizierungsmethode, Benutzer-ID bei Passwort-Auth, optional einen Gerätenamen, die E2EE-Option und Auto-Join-Verhalten ab.

Sobald die Konfiguration steht, muss der Gateway neu gestartet werden. Danach kannst du dem Bot-Konto eine Direktnachricht senden oder es in einen Matrix-Raum einladen.

Räume verwalten: Auto-Join oder Allowlist

Matrix organisiert Unterhaltungen in Räumen. OpenClaw kann Einladungen automatisch annehmen oder nur in ausdrücklich erlaubten Räumen aktiv werden. Die zentrale Einstellung dafür ist autoJoin.

Für kontrollierte Setups ist eine Allowlist sinnvoll. Erlaubte Räume trägst du unter allowedRooms ein. Vorher solltest du die interne Raum-ID kennen, nicht nur den Anzeigenamen. Laut OpenClaw-Dokumentation löst der Befehl openclaw channels resolve --channel matrix "Projekt Raum" einen Namen in die passende Raum-ID auf.

Ein pragmatisches Muster für Hobby-Projekte: Der Bot darf nur einem Hauptraum beitreten und reagiert dort auf Anfragen. Direkte Nachrichten bleiben davon getrennt, laufen aber weiterhin über dieselbe OpenClaw-Routinglogik.

Push-Regeln: Ruhiger streamen

Eine Besonderheit des Matrix-Plugins ist der Quiet-Streaming-Modus. Wenn channels.matrix.streaming auf "quiet" steht, bearbeitet OpenClaw laut Plugin-Dokumentation einen einzelnen Vorschau-Event im Chat, statt viele sichtbare Teil-Events zu erzeugen. Die finale Antwort erhält dabei ein spezielles Content-Flag.

Damit Nutzer nur bei der fertigen Antwort benachrichtigt werden, müssen passende Push-Regeln auf Empfängerseite greifen. Das ist vor allem bei selbstverwalteten Matrix-Setups relevant, in denen du Push-Regeln und Pusher gezielt kontrollieren kannst.

Die Regel sollte drei Dinge abdecken:

• Der sender ist die vollständige MXID des OpenClaw-Bot-Accounts.
• Das Event enthält das Custom-Flag, das der Plugin-Code für die finale Antwort setzt.
• Der Empfänger-Account hat funktionierende Pusher; normale Matrix-Push-Zustellung muss also grundsätzlich funktionieren.

Ohne diese Abstimmung können Nutzer bei mehreren Bearbeitungsschritten Benachrichtigungen erhalten. Wenn du keine Push-Regeln anfassen möchtest, ist streaming: "partial" oder deaktiviertes Streaming die robustere Wahl.

Routing: Warum Replies im richtigen Raum landen

OpenClaw leitet Antworten an den Channel zurück, aus dem die ursprüngliche Nachricht kam. Diese Logik hängt an der Host- und Channel-Konfiguration, nicht an einer freien Entscheidung des Sprachmodells.

Für Matrix heißt das: Eine Nachricht aus Raum !abc123:example.org führt zu einer Antwort in genau diesem Raum. Eine Direktnachricht von @user:example.org wird als DM an denselben Nutzer beantwortet.

Auch Multi-Account-Setups sind vorgesehen. Wenn mehrere Matrix-Accounts konfiguriert sind, bestimmt channels.matrix.defaultAccount, welcher Account verwendet wird, falls der ausgehende Pfad keine explizite accountId enthält. Ohne gesetzten Default nutzt OpenClaw laut Routing-Dokumentation den ersten normalisierten Account.

Für explizite Targets können Prefixe wie matrix:!room123:example.org oder mx:@user:example.org helfen, solange der Channel noch nicht feststeht. Sobald der Channel ausgewählt ist, müssen Prefix und Channel zusammenpassen.

E2EE aktivieren: Verschlüsselung mit Setup-Aufwand

Matrix unterstützt Ende-zu-Ende-Verschlüsselung für Räume und Direktnachrichten. Im interaktiven Setup fragt OpenClaw, ob E2EE aktiviert werden soll. Wenn du Verschlüsselung später einrichten möchtest, führt laut OpenClaw-Dokumentation openclaw matrix encryption setup durch die nötigen Bootstrap-Schritte.

Wichtig ist der Raumkontext: In verschlüsselten Räumen muss der Bot-Account die passenden Raum-Schlüssel besitzen. Praktisch bedeutet das, dass der Bot dem Raum beitreten und das E2EE-Setup abgeschlossen sein muss, bevor verschlüsselte Nachrichten zuverlässig verarbeitet werden können.

Für produktive Räume ist ein kleiner Test sinnvoll: erst einen separaten verschlüsselten Testraum anlegen, Bot einladen, Setup ausführen, Nachrichtenfluss prüfen – und erst danach echte Räume anbinden.

Grenzen und typische Fallstricke

Das Matrix-Plugin ist mächtig, aber nicht wartungsfrei:

• Große Gruppenräume: In sehr aktiven Räumen kann viel irrelevanter Kontext entstehen. Eine enge allowedRooms-Konfiguration schützt vor Rauschen.
• Benachrichtigungen: Quiet-Streaming braucht passende Push-Regeln, sonst bleibt der Chat zwar aufgeräumter, aber die Push-Seite kann trotzdem nerven.
• Verschlüsselung: E2EE erhöht den Setup-Aufwand und kann bei Raumwechseln oder neuen Geräten zusätzliche Schritte erfordern.
• Selbsthosting: Ein eigener Homeserver bringt Kontrolle, aber auch Verantwortung für Updates, Wartung und Verfügbarkeit.

Wenn du keinen eigenen Homeserver betreiben willst, kann ein öffentlicher Homeserver wie matrix.org für Tests und kleinere Projekte reichen. Für dauerhaft sensible Setups solltest du trotzdem genau prüfen, wem du Infrastruktur und Metadaten anvertraust.

Fazit: Matrix lohnt sich für kontrollierte OpenClaw-Setups

Die OpenClaw-Matrix-Integration ergänzt deinen Agenten-Stack um einen offenen, dezentralen Kommunikationskanal. Ein zentraler Vorteil liegt nicht darin, „noch einen Chat“ zu haben, sondern in der Kombination aus Raumkontrolle, nachvollziehbarem Routing, optionaler Verschlüsselung und steuerbaren Benachrichtigungen.

Ein sinnvoller Einstieg ist klein: ein Bot-Account, ein Testraum, eine klare Allowlist und ein bewusst gewählter Streaming-Modus. Wenn Routing, Replies und Push-Verhalten sauber funktionieren, kannst du weitere Räume, E2EE und Multi-Account-Konfigurationen schrittweise ergänzen. Die OpenClaw-Dokumentation bleibt dafür die maßgebliche Referenz.