So richten Sie die Matrix-Raummoderation mit dem Mjolnir-Bot ein

Mjolnir ist ein Matrix-Moderationsbot, der gemeinsame Bannrichtlinien anwenden, Nachrichten redigieren, geschützte Räume überwachen und Moderatoren unterstützen kann, ohne dass diese ihre persönlichen Accounts nutzen müssen. Für eine sichere Konfiguration sind drei Entscheidungen entscheidend: Wo der Bot ausgeführt wird, wer ihm Befehle erteilen kann und welche Berechtigungen er in den einzelnen geschützten Räumen erhält. Halten Sie den Kontrollraum privat, schützen Sie nur die von Ihnen gewünschten Räume und überprüfen Sie die Berechtigungen, bevor Sie sich im Notfall auf den Bot verlassen.

Diese Anleitung orientiert sich an der Mjolnir-Einrichtungs- und Moderatorendokumentation sowie den Moderationsrichtlinien der Matrix-Community (Stand: 6. Oktober 2026). Auf der Projektseite ist Version 1.12.1 als aktuellste Version zum Zeitpunkt der Überprüfung angegeben. Bitte prüfen Sie vor der Installation erneut die Projektseite und das Konfigurationsbeispiel, da sich Container-Tags und unterstützte Optionen ändern können.

Ist Mjölnir das Richtige für Ihre Matrix-Community?

Nutzen Sie Mjolnir, wenn Moderatoren Moderationsregeln für mehrere Räume teilen, gemeinsame Richtlinienlisten abonnieren oder wiederkehrende Aktionen einheitlich anwenden müssen. Die Berechtigungen des Matrix-Raums bestimmen weiterhin die Aktionen des Bots; Mjolnir erhält keine Berechtigungen allein durch den Beitritt zu einem Raum. Für die Moderation kleiner Räume reichen die integrierten Raumfunktionen möglicherweise aus. Mjolnir ist besonders nützlich, wenn dieselbe Community mehrere Räume betreibt oder einen kontrollierten, gemeinsamen Workflow benötigt.

Raummoderation und Homeserver-Administration sind separate Aufgabenbereiche. Mjolnir kann mit den entsprechenden Berechtigungen Sperren und Schwärzungen auf Raumebene verwalten. Für weitreichendere serverweite Befehle – wie das Deaktivieren von Benutzern, das Verschieben von Aliasen oder das Schließen von Räumen – benötigt Mjolnir Administratorrechte auf dem Synapse-Server. Gewähren Sie Homeserver-Administratorrechte nur dann, wenn Moderatoren diese Operationen unbedingt benötigen.

Was sollten Sie vor der Installation vorbereiten?

• Ein Matrix-Homeserver-Konto, das dem Bot gewidmet ist, wie zum Beispiel @mjolnir:example.org.
• Ein privater Verwaltungsraum, in dem autorisierte Moderatoren Befehle erteilen und Statusmeldungen empfangen können.
• Ein persistentes Verzeichnis oder Volume für die Konfiguration und den Status von Mjolnir.
• Ein Plan für verschlüsselte Räume. Die aktuelle Mjolnir-Konfiguration unterstützt native Verschlüsselung; Pantalaimon wird in der Konfiguration auch als separate, veraltete Option aufgeführt. Aktivieren Sie nicht beide Pfade gleichzeitig.
• Ein Testraum, in dem Sie Einladungen, Berechtigungen und das Verhalten von Listen überprüfen können, bevor Sie stark frequentierte Produktionsräume schützen.

Wie installiert man Mjolnir?

Das Upstream-Projekt dokumentiert die Installation von Docker und die Selbstkompilierung. Für die meisten Administratoren, die bereits Container betreiben, ist Docker Compose praktisch, da es den Bot neu starten und Protokolle anzeigen kann, ohne dass ein interaktives Terminal geöffnet bleiben muss. Befolgen Sie die Docker-Einrichtungsanweisungen des Projekts und verwenden Sie in der Produktion eine geprüfte Version, anstatt sich dauerhaft auf ein dynamisches latestTag zu verlassen. Das offizielle Image ist [Image-Name] matrixdotorg/mjolnir.

Bereiten Sie die Konfiguration vor, bevor Sie den Container starten. Gemäß der Docker-Dokumentation wird die Konfiguration in einem persistenten Datenverzeichnis erwartet config/production.yaml. Stellen Sie sicher, dass dieses Verzeichnis nur für die Administratoren und Dienste lesbar ist, die es benötigen. Die Datei kann ein Zugriffstoken oder andere Anmeldeinformationen enthalten; laden Sie sie nicht in ein öffentliches Repository hoch, fügen Sie sie nicht in einen Support-Chat ein und fügen Sie sie nicht in Protokolle ein.

Verwenden Sie die aktuelle Standardkonfiguration des Projekts mit Kommentaren als maßgebliche Quelle für Optionsnamen. Legen Sie mindestens die URL des Homeservers und den Verwaltungsraum fest und konfigurieren Sie anschließend Authentifizierung und Verschlüsselung für Ihre gewählte Bereitstellung. Bei einer tokenbasierten Einrichtung behandeln Sie das Token wie ein Passwort. Die Anleitung zur Einrichtung beschreibt, wie Sie es erhalten, indem Sie sich in Element mit einem separaten Browserprofil als Bot anmelden und unter „Einstellungen“, „Hilfe & Info“ den Abschnitt „Zugriffstoken“ öffnen. Melden Sie sich anschließend nicht ab, da dies das Token ungültig machen kann; schließen Sie stattdessen dieses Browserprofil. Aktivieren und testen Sie für einen verschlüsselten Verwaltungsraum die Verschlüsselungsunterstützung von Mjolnir, bevor Sie Befehle daraus verwenden.

# Illustrative values only; use the exact keys and authentication method
# from the current upstream configuration sample. Never share real secrets.
homeserverUrl: https://matrix.example.org
managementRoom: '!privateRoomId:example.org'
accessToken: '[STORE A SECRET HERE, NOT IN PUBLIC]'

Dieser kurze Auszug stellt keine vollständige Konfiguration dar. Insbesondere die Verschlüsselungs- und Anmeldeeinstellungen hängen davon ab, ob Sie die native Verschlüsselung oder den optionalen Pantalaimon-Pfad verwenden. Orientieren Sie sich am aktuellen Beispiel, anstatt einen alten Blog- oder Compose-Code zu kopieren. Die Mjolnir-Einrichtungsanleitung empfiehlt außerdem, den Bot netzwerktechnisch nahe am Homeserver zu platzieren, um die Antwortlatenz zu reduzieren.

Wie sollte man den Managementraum sichern?

Erstelle einen Raum für vertrauenswürdige Moderatoren, lade den Bot-Account ein und stelle den Raum auf privat für das Moderationsteam ein. Die Raum-ID oder der Alias ​​wird dort eingetragen managementRoom. Die aktuelle Konfiguration beschreibt diesen Raum als Befehlsquelle und warnt davor, dass jeder, der dort Befehle senden kann, Mjolnir kontrollieren kann; sie bietet keine detailliertere Zugriffskontrolle pro Befehl. Daher ist eine Überprüfung der Mitgliedschaft unerlässlich. Entferne ehemalige Moderatoren umgehend und nutze den Kontrollraum des Bots nicht als allgemeinen Community-Chat.

Für den Managementraum wird Verschlüsselung empfohlen. Falls Sie ihn verschlüsseln, überprüfen Sie, ob Mjolnir Nachrichten mit der konfigurierten Verschlüsselungsmethode lesen und beantworten kann. Ein Bot, der einem verschlüsselten Raum beigetreten ist, dessen Ereignisse aber nicht entschlüsseln kann, erscheint möglicherweise online, ignoriert aber Befehle. Verwenden Sie zur Diagnose die Upstream-Verschlüsselungskonfiguration und die Protokolle, anstatt die Raumverschlüsselung als ersten Schritt zu deaktivieren.

Welche Berechtigungen sollte Mjolnir erhalten?

Laden Sie den Bot in jeden Raum ein, den er schützen soll, und weisen Sie ihm ausreichend Berechtigungsstufe zu, um die gewünschten Moderationsaktionen durchzuführen. Matrix verwendet die Berechtigungsstufe für Aktionen wie Sperren, Kicken, das Ausblenden von Beiträgen anderer Nutzer und das Ändern des Raumstatus. Der erforderliche Wert wird durch die Berechtigungsstufe des Raums definiert; die Standardwerte von Matrix für Sperren, Kicken und Ausblenden sind üblicherweise 50, sofern nicht anders angegeben, können aber von einzelnen Räumen angepasst werden.

Die Community-Richtlinien von Matrix beschreiben Powerlevel 100 als gängige Mjolnir-Konfiguration, um Moderationsentscheidungen durchzusetzen. Dieses Level ist jedoch sehr hoch: Jeder, der den Mjolnir-Account kontrollieren kann, hat diese Autorität in geschützten Räumen, und der Bot kann faktisch zum Eigentümer werden. Überprüfen Sie die Powerlevel jedes Raums und wählen Sie ein Level, das die erforderlichen Aktionen des Bots ermöglicht, aber unnötige Berechtigungen einschränkt. Gewähren Sie ihm keine Administratorrechte für den Homeserver zur normalen Raummoderation.

In Element können Sie den Bot über das Mitgliederpanel des Raums einladen oder einen Einladungsbefehl wie z /invite @mjolnir:example.org. B. `mjolnir` eingeben. Nachdem er beigetreten ist, passen Sie seine Rolle in der Mitgliederliste des Raums an. Wiederholen Sie dies für jeden zu schützenden Raum. Mjolnir kann keine Räume schützen, denen er nicht beigetreten ist. Dies ergibt sich aus dem dezentralen, raumbezogenen Berechtigungsmodell von Matrix.

Wie erstellt man eine Sperrliste und fügt geschützte Räume hinzu?

Sobald der Bot gestartet ist und seinen Status im Verwaltungsraum veröffentlicht hat, erstellen Sie dort eine Richtlinienliste. Die Schnellstartanleitung von Mjolnir verwendet folgendes Beispiel:

!mjolnir list create COC code-of-conduct-ban-list
!mjolnir default COC
!mjolnir rooms add #community:example.org
!mjolnir verify
!mjolnir status

Der erste Befehl erstellt einen Sperrlistenraum mit dem Shortcode `<Sperrlistenraum>` COC. Der Ersteller wird eingeladen, um die Sichtbarkeit des Raums zu verwalten. Der zweite Befehl legt diese Liste als Standard für spätere Moderationsbefehle fest. Der dritte Befehl fügt einen Raum zu den geschützten Räumen von Mjolnir hinzu. Der Verifizierungsbefehl prüft, ob der Bot die erforderlichen Berechtigungen in allen geschützten Räumen besitzt, während der Statusbefehl die korrekte Funktion bestätigt. Verwenden Sie `<Befehl>`, !mjolnir helpum die in Ihrer installierten Version verfügbare Befehlssyntax anzuzeigen.

Halten Sie Richtlinienlisten privat, wenn sie interne Notizen enthalten oder nur für Ihr Team bestimmt sind. Veröffentlichen Sie sie nur dann, wenn andere Communities die Regeln entdecken und abonnieren sollen. Die Regeln von Mjolnir sind listenübergreifend und additiv. Überprüfen Sie daher überwachte Listen, bevor Sie sich darauf verlassen; eine Liste kann weiterhin auf einen Benutzer oder Server zutreffen, selbst wenn Sie eine doppelte Regel aus einer anderen Liste entfernen.

Was sollten Sie testen, bevor Sie es in einem realen Einsatzfall verwenden?

• Bestätigen Sie, dass der Bot Start- und Statusmeldungen im konfigurierten Verwaltungsraum veröffentlicht.
• Führe den Test durch !mjolnir verify, nachdem du es in den Testraum eingeladen und die gewählte Rolle zugewiesen hast.
• Führen Sie den Vorgang aus !mjolnir roomsund überprüfen Sie, ob der gewünschte Raum angezeigt wird und kein anderer Raum miteinbezogen ist.
• Prüfen !mjolnir protectionsund aktivieren Sie nur Schutzmaßnahmen, die Sie verstehen; automatische Schutzmaßnahmen können legitime Nutzer beeinträchtigen.
• Verwenden Sie einen Testaccount und einen temporären Raum, um das Sperr-, Entsperr- und Schwärzungsverfahren des Teams zu validieren, bevor Sie es auf echte Mitglieder anwenden.
• Überprüfen Sie die Containerprotokolle und die Meldungen im Management-Raum von Mjolnir, falls der Bot Befehle verpasst oder fehlende Berechtigungen meldet.

Testen Sie nicht, indem Sie ein echtes Community-Mitglied sperren oder einen Wildcard-Bann auf einem Live-Server verwenden. Wildcard-Banns können viele Nutzer betreffen; die aktuelle Standardkonfiguration erfordert eine zusätzliche Bestätigung für Wildcard-Banns. Lesen Sie die Moderatorenrichtlinien, bevor Sie automatisierte Schutzmaßnahmen aktivieren, und dokumentieren Sie, wer weitreichende Maßnahmen genehmigen darf.

Welche häufigen Fehler treten bei der Einrichtung auf?

• Der Bot-Server erhält aus praktischen Gründen Administratorrechte: Für die Moderation auf Raumebene benötigt man in der Regel Raumrechte, nicht Synapse-Administratorrechte.
• Der Managementraum ist für alle zugänglich: Jedes Mitglied, das Befehle erteilen kann, ist mit den Moderationsfunktionen des Bots betraut.
• Vergessen der Berechtigungen für geschützte Räume: Ein Bot kann online sein und trotzdem nicht sperren oder Inhalte redigieren, wenn seine Berechtigung zu gering ist.
• Nutzung verschlüsselter Räume ohne Konfiguration der Verschlüsselung: Die Mitgliedschaft allein ermöglicht es dem Bot nicht, verschlüsselte Befehle zu lesen.
• Kopieren eines alten Setup-Rezepts: Die Konfigurations- und Verschlüsselungsunterstützung von Mjolnir entwickelt sich ständig weiter; verwenden Sie das aktuelle Standardbeispiel und die Setup-Dokumentation.
• Angenommen, die Entfernung einer Liste hebt alle Sperren auf: Eine andere überwachte Liste kann weiterhin dieselbe Regel anwenden.

Wo kann man die aktuellen Angaben überprüfen?

Beginnen Sie mit der offiziellen Mjolnir-Einrichtungsanleitung , dem Moderatorenleitfaden und der Versionshistorie . Informationen zu Raumberechtigungen finden Sie im Matrix-Community-Moderationsleitfaden und in der Matrix-Spezifikation zu Raumleistungsstufen . Die genauen Installationsbefehle und Verschlüsselungseinstellungen hängen von Ihrem Homeserver, Ihrer Containerkonfiguration und der Mjolnir-Version ab; bei Änderungen der Anweisungen haben die offiziellen Referenzen Vorrang.