OpenClaw Mattermost Kanal
Unternehmen
Mittel
Verbinden Sie OpenClaw mit Mattermost, der Open-Source-Messaging-Plattform fuer Unternehmen, und ermoeglichen Sie Ihrem KI-Assistenten die Teilnahme an Direktnachrichten, Gruppenkanaelen und Teamunterhaltungen. Die Integration nutzt Bot Token-Authentifizierung und WebSocket-Events fuer bidirektionale Echtzeitkommunikation mit flexiblen Chat-Modi und granularen Zugriffsrichtlinien.
Kurzinfo
SchwierigkeitsgradMittel
KategorieUnternehmen
Unterstützte Funktionen5 / 6
Mattermost Unterstützte Funktionen
Textnachrichten
Unterstützt
Medien & Dateien
Unterstützt
Reaktionen
Unterstützt
Threads
Unterstützt
Sprachnachrichten
Nicht unterstützt
Gruppenchat
Unterstützt
Mattermost Voraussetzungen
- Ein Mattermost-Server (selbst gehostet oder Cloud) mit Administratorzugriff zum Erstellen von Bot-Konten
- Ein Bot-Konto mit einem Bot Token, erstellt in der Mattermost-Systemkonsole
- Die Mattermost-Server-Basis-URL muss vom OpenClaw Gateway erreichbar sein
- OpenClaw Gateway installiert und gestartet
- Das Mattermost-Plugin installiert ueber 'openclaw plugins install @openclaw/mattermost'
Mattermost Schnelleinrichtung
1
Mattermost-Plugin installieren
Fuehren Sie 'openclaw plugins install @openclaw/mattermost' aus, um Mattermost-Unterstuetzung zu Ihrem Gateway hinzuzufuegen.
2
Bot-Konto in Mattermost erstellen
Navigieren Sie zu Mattermost-Systemkonsole > Integrations > Bot Accounts. Klicken Sie auf 'Add Bot Account', legen Sie einen Anzeigenamen und eine Beschreibung fest und kopieren Sie den generierten Bot Token. Stellen Sie sicher, dass 'Enable Bot Account Creation' in der Systemkonsole > Integrations > Integration Management auf 'true' gesetzt ist.
3
Konfigurieren und starten
Fuegen Sie die Mattermost-Kanalkonfiguration zu ~/.openclaw/openclaw.json mit Ihrem botToken, Ihrer baseUrl und den gewuenschten Richtlinien hinzu. Starten Sie das Gateway mit 'openclaw start'. Senden Sie eine Direktnachricht an den Bot oder erwaehnen Sie ihn mit @mention in einem Kanal, um die Verbindung zu ueberpruefen.
Mattermost Konfigurationsbeispiel
config.json
{
"channels": {
"mattermost": {
"enabled": true,
"botToken": "your-bot-token",
"baseUrl": "https://mattermost.example.com",
"dmPolicy": "pairing",
"chatmode": "oncall"
}
}
}Mattermost Detaillierte Dokumentation
Architekturuebersicht
OpenClaw verbindet sich mit Mattermost ueber dessen REST API und den WebSocket-Event-Stream. Beim Start authentifiziert sich das Gateway mit Ihrem Bot Token, stellt eine persistente WebSocket-Verbindung her und beginnt, auf Nachrichtenereignisse zu lauschen.
Wenn eine Nachricht dem aktiven Chat-Modus-Trigger entspricht (Erwaehnung, Praefix oder alle Nachrichten), leitet das Gateway sie an Ihren KI-Agenten weiter. Die Antwort des Agenten wird ueber die Mattermost REST API im selben Kanal oder DM-Thread gepostet.
Die Integration unterstuetzt umfangreiche Funktionen wie Medienanhaenge, Nachrichtenreaktionen, Thread-Antworten und Gruppenkanal-Verwaltung — und ist damit eine der umfassendsten Enterprise-Kanalintegrationen.
Die WebSocket-Verbindung stellt sich automatisch wieder her, wenn die Verbindung unterbrochen wird.
Jedes Konto generiert einen eindeutigen Sitzungsschluessel (agent:<agentId>:mattermost:<accountName>) zur unabhaengigen Konversationsverfolgung.
Bot-Konto erstellen
Mattermost Bot-Konten sind dedizierte Dienstkonten, die keine Benutzerlizenz verbrauchen.
1. Navigieren Sie zu System Console > Integrations > Bot Accounts.
2. Stellen Sie sicher, dass 'Enable Bot Account Creation' unter Integration Management aktiviert ist.
3. Klicken Sie auf 'Add Bot Account' und geben Sie den Anzeigenamen, die Beschreibung und das Symbol ein.
4. Waehlen Sie die entsprechende Rolle (System Admin wird NICHT empfohlen — verwenden Sie die Standardrolle Member).
5. Kopieren Sie den generierten Bot Token sofort — er wird nicht erneut angezeigt.
Der Bot muss allen Kanaelen hinzugefuegt werden, in denen er operieren soll. Team-Administratoren oder Systemadministratoren koennen den Bot manuell zu Kanaelen hinzufuegen, oder Benutzer koennen ihn per @mention einladen.
openclaw.json
{
"channels": {
"mattermost": {
"botToken": "your-bot-token",
"baseUrl": "https://mattermost.example.com"
}
}
}Bewahren Sie den Bot Token sicher auf. Bei Verlust muessen Sie ihn ueber die Systemkonsole neu generieren.
Bot-Konten werden nicht auf Ihr Mattermost-Lizenz-Sitzplatzlimit angerechnet.
Chat-Modi
OpenClaw unterstuetzt drei Chat-Modi, die steuern, wann der Bot auf Nachrichten in Kanaelen reagiert:
**oncall (Standard)** — Der Bot antwortet nur, wenn er namentlich mit @mention erwaehnt wird. Dies ist der sicherste Modus fuer stark frequentierte Kanaele, da der Bot schweigt, sofern er nicht explizit aufgerufen wird.
**onmessage** — Der Bot antwortet auf jede Nachricht von berechtigten Benutzern. Am besten geeignet fuer dedizierte Bot-Kanaele oder Umgebungen mit geringem Nachrichtenaufkommen, in denen jede Nachricht eine Antwort erhalten soll.
**onchar** — Der Bot antwortet, wenn eine Nachricht mit einem bestimmten Praefix-Zeichen beginnt (z. B. '!' oder '/'). Konfigurieren Sie die Trigger-Praefixe mit oncharPrefixes. Dieser Modus ist nuetzlich, wenn Sie eine explizite, aber kompakte Aktivierung wuenschen, ohne den vollstaendigen Bot-Namen eingeben zu muessen.
openclaw.json
{
"channels": {
"mattermost": {
"chatmode": "onchar",
"oncharPrefixes": ["!", "/ai"]
}
}
}In DMs antwortet der Bot unabhaengig vom Chat-Modus immer auf alle Nachrichten.
Der oncall-Modus wird fuer Team-Kanaele empfohlen, um Stoerungen zu vermeiden.
DM-Richtlinien
DM-Richtlinien (Direct Message) steuern, wer ueber private Nachrichten mit dem Bot interagieren kann.
**pairing (Standard)** — Nur Benutzer, die explizit im allowFrom-Array aufgefuehrt sind, koennen dem Bot eine DM senden. Dies ist der restriktivste Modus, ideal zur genauen Kontrolle, welche Benutzer Zugriff haben.
**open** — Jeder Mattermost-Benutzer, der dem Bot eine DM sendet, erhaelt eine Antwort. Verwenden Sie diesen Modus, wenn der Bot organisationsweit breit zugaenglich sein soll.
Das allowFrom-Feld akzeptiert Mattermost-Benutzer-IDs. Die ID eines Benutzers finden Sie in der Systemkonsole > Users oder ueber die Mattermost API.
openclaw.json
{
"channels": {
"mattermost": {
"dmPolicy": "pairing",
"allowFrom": ["user-id-1", "user-id-2"]
}
}
}Das Setzen von dmPolicy auf 'open' erlaubt jedem Benutzer auf Ihrem Mattermost-Server, KI-Kontingent ueber DMs zu verbrauchen. Verwenden Sie diese Einstellung mit Vorsicht auf grossen Servern.
Gruppen- und Kanalrichtlinien
Gruppenrichtlinien steuern, in welchen Kanaelen der Bot beim Empfang von Gruppennachrichten teilnimmt.
**allowlist (Standard)** — Der Bot antwortet nur in Kanaelen, die explizit in groupAllowFrom aufgefuehrt sind. Nachrichten in anderen Kanaelen werden stillschweigend ignoriert.
**open** — Der Bot antwortet in jedem Kanal, dem er hinzugefuegt wurde. Dies ist bequem, kann aber zu unbeabsichtigten Interaktionen fuehren, wenn der Bot vielen Kanaelen hinzugefuegt wurde.
Das groupAllowFrom-Feld akzeptiert Mattermost-Kanal-IDs. Die ID eines Kanals finden Sie in der Kanal-URL oder ueber die Mattermost API.
openclaw.json
{
"channels": {
"mattermost": {
"groupPolicy": "allowlist",
"groupAllowFrom": ["channel-id-1", "channel-id-2"]
}
}
}Verwenden Sie den allowlist-Modus in Produktionsumgebungen, um zu verhindern, dass der Bot in unbeabsichtigten Kanaelen antwortet.
Der Bot muss Mitglied des Kanals sein, um Nachrichten zu empfangen, unabhaengig von der Gruppenrichtlinie.
Multi-Account-Einrichtung
OpenClaw unterstuetzt den gleichzeitigen Betrieb mehrerer Mattermost-Bot-Konten, die jeweils auf unterschiedliche Mattermost-Server abzielen oder mit verschiedenen Konfigurationen arbeiten koennen.
Verwenden Sie das Muster accounts.<name>, um mehrere Konten zu konfigurieren. Jedes Konto verfuegt ueber einen eigenen Bot Token, eine eigene Basis-URL, einen eigenen Chat-Modus und eigene Zugriffsrichtlinien.
Dies ist nuetzlich fuer Organisationen, die mehrere Mattermost-Instanzen betreiben (z. B. Produktion und Staging) oder wenn verschiedene Teams Bots mit unterschiedlichem Verhalten benoetigen.
openclaw.json
{
"channels": {
"mattermost": {
"accounts": {
"production": {
"botToken": "prod-bot-token",
"baseUrl": "https://mattermost.company.com",
"chatmode": "oncall",
"dmPolicy": "pairing",
"allowFrom": ["user-1", "user-2"]
},
"dev-team": {
"botToken": "dev-bot-token",
"baseUrl": "https://mm-dev.company.com",
"chatmode": "onmessage",
"dmPolicy": "open"
}
}
}
}
}Ausgehende Nachrichten
KI-Agenten koennen proaktiv Nachrichten an Mattermost-Kanaele und -Benutzer ueber die mattermost-Tool-Aktion senden. Dies ermoeglicht geplante Benachrichtigungen, Warnungen und automatisierte Updates ohne Benutzeraktion.
Unterstuetzte Zielformate:
• channel:<channel-id> — An einen bestimmten Kanal per ID senden
• user:<user-id> — Eine Direktnachricht an einen bestimmten Benutzer per ID senden
• @username — Eine Direktnachricht an einen Benutzer per Benutzername senden
Der Bot muss die Berechtigung haben, im Zielkanal zu posten oder eine DM mit dem Zielbenutzer zu initiieren.
agent-action.json
{
"action": "mattermost",
"params": {
"message": "Daily standup reminder: please post your updates!",
"to": "channel:abc123def456"
}
}Verwenden Sie Kanal-IDs (nicht Namen) fuer zuverlaessige Zustellung. Kanalnamen koennen umbenannt werden.
Der Bot muss Mitglied des Zielkanals sein, um Nachrichten zu posten.
Erweiterte Nachrichtenfunktionen
Mattermost unterstuetzt eine breite Palette an Nachrichtenfunktionen, die OpenClaw vollstaendig nutzt:
**Medienanhaenge** — Der Bot kann Bilder, Dateien und andere Anhaenge senden und empfangen. Von Benutzern geteilte Medien werden zur Verarbeitung an den KI-Agenten weitergeleitet.
**Reaktionen** — Der Bot kann Emoji-Reaktionen zu Nachrichten hinzufuegen. Dies ist nuetzlich fuer Bestaetigungen oder Statusanzeigen.
**Thread-Antworten** — Der Bot unterstuetzt das Threading-Modell von Mattermost. Wenn ein Benutzer in einem Thread antwortet, behaelt der Bot den Kontext innerhalb dieses Threads bei.
**Markdown** — Mattermost rendert Markdown nativ, sodass die Antworten des Bots formatierten Text, Codebloecke, Tabellen und Links enthalten koennen.
Thread-Antworten helfen, Unterhaltungen uebersichtlich zu halten, insbesondere in stark frequentierten Kanaelen.
Dateianhangse unterliegen den Upload-Groessenbeschraenkungen Ihres Mattermost-Servers.
Ratenlimits und Best Practices
Mattermost wendet Ratenlimits auf seine REST API an, um die Serverleistung zu schuetzen. Die Standardlimits sind:
• 10 Anfragen pro Sekunde pro Benutzer (dauerhaft)
• 100 Anfragen Burst-Kapazitaet
Diese Limits gelten fuer die API-Aufrufe des Bot-Kontos, einschliesslich dem Posten von Nachrichten, Hinzufuegen von Reaktionen und Hochladen von Dateien.
Best Practices fuer Produktionsumgebungen:
1. Verwenden Sie den oncall- oder onchar-Chat-Modus in stark frequentierten Kanaelen, um unnoetige API-Aufrufe zu reduzieren.
2. Belassen Sie groupPolicy auf allowlist, um zu verhindern, dass der Bot in jedem Kanal antwortet.
3. Ueberwachen Sie die API-Nutzung des Bots in der Mattermost-Systemkonsole > Environment > Rate Limiting.
4. Erwaegen Sie bei Bereitstellungen mit hohem Nachrichtenaufkommen, separate Konten fuer verschiedene Teams einzurichten.
Wenn der Bot die Ratenlimits ueberschreitet, gibt Mattermost HTTP 429-Fehler zurueck. Das Gateway wiederholt die Anfrage mit Backoff, aber bei anhaltender Ueberlastung sind moeglicherweise Konfigurationsanpassungen erforderlich.
Mattermost Konfigurationsreferenz
| Key | Type | Default | Description |
|---|---|---|---|
| enabled | boolean | true | Mattermost-Kanal aktivieren oder deaktivieren |
| botToken | string | "" | Bot Token aus der Mattermost-Systemkonsole > Bot Accounts |
| baseUrl | string | "" | Vollstaendige URL Ihres Mattermost-Servers (z. B. https://mattermost.example.com) |
| chatmode | string | "oncall" | Chat-Trigger-Modus: 'oncall' (Erwaehnung), 'onmessage' (alle) oder 'onchar' (Praefix) |
| oncharPrefixes | string[] | [] | Praefix-Zeichen, die den Bot ausloesen, wenn chatmode auf 'onchar' gesetzt ist |
| dmPolicy | string | "pairing" | DM-Zugriffsrichtlinie: 'pairing' (nur Erlaubnisliste) oder 'open' (alle Benutzer) |
| allowFrom | string[] | [] | Mattermost-Benutzer-IDs, die dem Bot DMs senden duerfen (verwendet mit dmPolicy: pairing) |
| groupPolicy | string | "allowlist" | Gruppenkanal-Richtlinie: 'allowlist' (nur angegebene Kanaele) oder 'open' (alle Kanaele) |
| groupAllowFrom | string[] | [] | Mattermost-Kanal-IDs, in denen der Bot antworten darf (verwendet mit groupPolicy: allowlist) |
| requireMention | boolean | true | Veraltete Einstellung — verwenden Sie stattdessen chatmode: 'oncall' |
| accounts.<id>.botToken | string | "" | Bot Token fuer ein bestimmtes Konto im Multi-Account-Modus |
| accounts.<id>.baseUrl | string | "" | Mattermost-Server-URL fuer ein bestimmtes Konto |
| accounts.<id>.chatmode | string | "oncall" | Chat-Trigger-Modus fuer ein bestimmtes Konto |
| accounts.<id>.dmPolicy | string | "pairing" | DM-Zugriffsrichtlinie fuer ein bestimmtes Konto |
enabled
Type: booleanDefault: true
Mattermost-Kanal aktivieren oder deaktivieren
botToken
Type: stringDefault: ""
Bot Token aus der Mattermost-Systemkonsole > Bot Accounts
baseUrl
Type: stringDefault: ""
Vollstaendige URL Ihres Mattermost-Servers (z. B. https://mattermost.example.com)
chatmode
Type: stringDefault: "oncall"
Chat-Trigger-Modus: 'oncall' (Erwaehnung), 'onmessage' (alle) oder 'onchar' (Praefix)
oncharPrefixes
Type: string[]Default: []
Praefix-Zeichen, die den Bot ausloesen, wenn chatmode auf 'onchar' gesetzt ist
dmPolicy
Type: stringDefault: "pairing"
DM-Zugriffsrichtlinie: 'pairing' (nur Erlaubnisliste) oder 'open' (alle Benutzer)
allowFrom
Type: string[]Default: []
Mattermost-Benutzer-IDs, die dem Bot DMs senden duerfen (verwendet mit dmPolicy: pairing)
groupPolicy
Type: stringDefault: "allowlist"
Gruppenkanal-Richtlinie: 'allowlist' (nur angegebene Kanaele) oder 'open' (alle Kanaele)
groupAllowFrom
Type: string[]Default: []
Mattermost-Kanal-IDs, in denen der Bot antworten darf (verwendet mit groupPolicy: allowlist)
requireMention
Type: booleanDefault: true
Veraltete Einstellung — verwenden Sie stattdessen chatmode: 'oncall'
accounts.<id>.botToken
Type: stringDefault: ""
Bot Token fuer ein bestimmtes Konto im Multi-Account-Modus
accounts.<id>.baseUrl
Type: stringDefault: ""
Mattermost-Server-URL fuer ein bestimmtes Konto
accounts.<id>.chatmode
Type: stringDefault: "oncall"
Chat-Trigger-Modus fuer ein bestimmtes Konto
accounts.<id>.dmPolicy
Type: stringDefault: "pairing"
DM-Zugriffsrichtlinie fuer ein bestimmtes Konto
Mattermost Häufig gestellte Fragen
Mattermost Fehlerbehebung
Bot antwortet nicht auf Nachrichten
Der Chat-Modus oder die Zugriffsrichtlinie filtert moeglicherweise die Nachrichten heraus.
Ueberpruefen Sie, ob chatmode Ihrem erwarteten Trigger entspricht (oncall erfordert @mention, onchar erfordert ein Praefix). Stellen Sie sicher, dass dmPolicy und allowFrom die Benutzer-ID fuer DMs enthalten oder dass groupPolicy und groupAllowFrom die Kanal-ID fuer Gruppennachrichten enthalten.
WebSocket-Verbindung schlaegt beim Start fehl
Die baseUrl ist falsch, der Bot Token ist ungueltig oder der Server ist nicht erreichbar.
Stellen Sie sicher, dass baseUrl auf den korrekten Mattermost-Server verweist (einschliesslich Protokoll, z. B. https://). Vergewissern Sie sich, dass der Bot Token gueltig ist und nicht widerrufen wurde. Ueberpruefen Sie die Netzwerkkonnektivitaet und Firewall-Regeln zwischen dem Gateway und dem Mattermost-Server.
Bot kann nicht in einem Kanal posten
Der Bot ist kein Mitglied des Zielkanals.
Fuegen Sie den Bot manuell ueber Mattermost zum Kanal hinzu (klicken Sie auf 'Add Members' im Kanal) oder laden Sie ihn per @mention seines Benutzernamens ein. Der Bot muss Kanalmitglied sein, um Nachrichten zu posten.
Medienanhaenge werden nicht verarbeitet
Die Datei-Upload-Einstellungen des Mattermost-Servers koennten Dateitypen oder -groessen einschraenken.
Ueberpruefen Sie System Console > Environment > File Storage auf Upload-Limits. Stellen Sie sicher, dass das Bot-Konto die Berechtigung zum Zugriff auf Dateianhangse hat. Vergewissern Sie sich, dass das Gateway den Mattermost File API-Endpunkt erreichen kann.
Ratenlimit-Fehler (HTTP 429) in den Logs
Der Bot fuehrt zu viele API-Anfragen in kurzer Zeit aus.
Wechseln Sie vom onmessage- zum oncall- oder onchar-Modus, um API-Aufrufe zu reduzieren. Begrenzen Sie die Anzahl der Kanaele, in denen der Bot aktiv ist. Ueberpruefen Sie System Console > Environment > Rate Limiting, um serverseitige Ratenlimits einzusehen oder anzupassen.