Zum Hauptinhalt springen

​
Mattermost (Plugin)

Status: unterstützt über Plugin (Bot-Token + WebSocket-Events). Kanäle, Gruppen und DMs werden unterstützt. Mattermost ist eine selbst hostbare Team-Messaging-Plattform; siehe die offizielle Website unter mattermost.com für Produktdetails und Downloads.

​
Plugin erforderlich

Mattermost wird als Plugin ausgeliefert und ist nicht im Core-Install enthalten. Installation per CLI (npm-Registry): 
openclaw plugins install @openclaw/mattermost
Lokales Checkout (bei Ausführung aus einem Git-Repo): 
openclaw plugins install ./extensions/mattermost
Wenn Sie Mattermost während der Konfiguration/des Onboardings auswählen und ein Git-Checkout erkannt wird, bietet OpenClaw den lokalen Installationspfad automatisch an. Details: Plugins

​
Schnellstart

  1. Installieren Sie das Mattermost-Plugin.
  2. Erstellen Sie ein Mattermost-Bot-Konto und kopieren Sie den Bot-Token.
  3. Kopieren Sie die Mattermost-Basis-URL (z. B. https://chat.example.com).
  4. Konfigurieren Sie OpenClaw und starten Sie das Gateway.
Minimale Konfiguration: 
{
  channels: {
    mattermost: {
      enabled: true,
      botToken: "mm-token",
      baseUrl: "https://chat.example.com",
      dmPolicy: "pairing",
    },
  },
}

​
Umgebungsvariablen (Standardkonto)

Setzen Sie diese auf dem Gateway-Host, wenn Sie Umgebungsvariablen bevorzugen:
  • MATTERMOST_BOT_TOKEN=...
  • MATTERMOST_URL=https://chat.example.com
Umgebungsvariablen gelten nur für das Standard-Konto (default). Andere Konten müssen Konfigurationswerte verwenden.

​
Chat-Modi

Mattermost antwortet automatisch auf DMs. Das Verhalten in Kanälen wird über chatmode gesteuert:
  • oncall (Standard): antwortet nur, wenn in Kanälen per @ erwähnt.
  • onmessage: antwortet auf jede Nachricht im Kanal.
  • onchar: antwortet, wenn eine Nachricht mit einem Trigger-Präfix beginnt.
Konfigurationsbeispiel: 
{
  channels: {
    mattermost: {
      chatmode: "onchar",
      oncharPrefixes: [">", "!"],
    },
  },
}
Hinweise:
  • onchar reagiert weiterhin auf explizite @Erwähnungen.
  • channels.mattermost.requireMention wird für Legacy-Konfigurationen berücksichtigt, chatmode wird jedoch bevorzugt.

​
Zugriffskontrolle (DMs)

  • Standard: channels.mattermost.dmPolicy = "pairing" (unbekannte Absender erhalten einen Pairing-Code).
  • Freigabe über:
    • openclaw pairing list mattermost
    • openclaw pairing approve mattermost <CODE>
  • Öffentliche DMs: channels.mattermost.dmPolicy="open" plus channels.mattermost.allowFrom=["*"].

​
Kanäle (Gruppen)

  • Standard: channels.mattermost.groupPolicy = "allowlist" (Erwähnung erforderlich).
  • Allowlist-Absender mit channels.mattermost.groupAllowFrom (Benutzer-IDs oder @username).
  • Offene Kanäle: channels.mattermost.groupPolicy="open" (Erwähnung erforderlich).

​
Ziele für ausgehende Zustellung

Verwenden Sie diese Zielformate mit openclaw message send oder Cron/Webhooks:
  • channel:<id> für einen Kanal
  • user:<id> für eine DM
  • @username für eine DM (über die Mattermost-API aufgelöst)
Reine IDs werden als Kanäle behandelt.

​
Mehrere Konten

Mattermost unterstützt mehrere Konten unter channels.mattermost.accounts: 
{
  channels: {
    mattermost: {
      accounts: {
        default: { name: "Primary", botToken: "mm-token", baseUrl: "https://chat.example.com" },
        alerts: { name: "Alerts", botToken: "mm-token-2", baseUrl: "https://alerts.example.com" },
      },
    },
  },
}

​
Fehlerbehebung

  • Keine Antworten in Kanälen: Stellen Sie sicher, dass der Bot im Kanal ist und erwähnt wird (oncall), verwenden Sie ein Trigger-Präfix (onchar) oder setzen Sie chatmode: "onmessage".
  • Authentifizierungsfehler: Prüfen Sie den Bot-Token, die Basis-URL und ob das Konto aktiviert ist.
  • Probleme mit mehreren Konten: Umgebungsvariablen gelten nur für das default-Konto.