Mattermost

​

Installieren

openclaw plugins install @openclaw/mattermost

openclaw plugins install ./path/to/local/mattermost-plugin

​

Schnelle Einrichtung

{
  channels: {
    mattermost: {
      enabled: true,
      botToken: "mm-token",
      baseUrl: "https://chat.example.com",
      dmPolicy: "pairing",
    },
  },
}

​

Native Slash-Befehle

{
  channels: {
    mattermost: {
      commands: {
        native: true,
        nativeSkills: true,
        callbackPath: "/api/channels/mattermost/command",
        // Use when Mattermost cannot reach the gateway directly (reverse proxy/public URL).
        callbackUrl: "https://gateway.example.com/api/channels/mattermost/command",
      },
    },
  },
}

​

Umgebungsvariablen (Standardkonto)

• MATTERMOST_BOT_TOKEN=...
• MATTERMOST_URL=https://chat.example.com

​

Chat-Modi

{
  channels: {
    mattermost: {
      chatmode: "onchar",
      oncharPrefixes: [">", "!"],
    },
  },
}

• onchar reagiert weiterhin auf explizite @Erwähnungen.
• channels.mattermost.requireMention wird für Legacy-Konfigurationen berücksichtigt, aber chatmode wird bevorzugt.
• Nachdem der Bot in einem Channel-Thread eine sichtbare Antwort gesendet hat, werden spätere Nachrichten im selben Thread ohne neue @Erwähnung oder onchar-Präfix beantwortet, sodass mehrstufige Thread-Unterhaltungen weiterlaufen. Die Teilnahme wird für 7 Tage Thread-Inaktivität gespeichert (bei jeder Antwort aufgefrischt) und bleibt über Gateway-Neustarts hinweg bestehen. Threads, die der Bot nur beobachtet hat, sind nicht betroffen; starten Sie eine neue Top-Level-Nachricht, um wieder eine explizite Erwähnung zu verlangen.

​

Threading und Sitzungen

• off (Standard): nur in einem Thread antworten, wenn der eingehende Post bereits in einem ist.
• first: bei Top-Level-Channel-/Gruppen-Posts einen Thread unter diesem Post starten und die Unterhaltung an eine Thread-bezogene Sitzung weiterleiten.
• all: heute dasselbe Verhalten wie first für Mattermost.
• Direktnachrichten ignorieren diese Einstellung und bleiben ohne Thread.

{
  channels: {
    mattermost: {
      replyToMode: "all",
    },
  },
}

• Thread-bezogene Sitzungen verwenden die ID des auslösenden Posts als Thread-Stamm.
• first und all sind derzeit äquivalent, weil Folge-Chunks und Medien im selben Thread fortgesetzt werden, sobald Mattermost einen Thread-Stamm hat.

​

Zugriffskontrolle (DMs)

• Standard: channels.mattermost.dmPolicy = "pairing" (unbekannte Absender erhalten einen Kopplungscode).
• Genehmigen über:
  • openclaw pairing list mattermost
  • openclaw pairing approve mattermost <CODE>
• Öffentliche DMs: channels.mattermost.dmPolicy="open" plus channels.mattermost.allowFrom=["*"].
• channels.mattermost.allowFrom akzeptiert accessGroup:<name>-Einträge. Siehe Zugriffsgruppen.

​

Channels (Gruppen)

• Standard: channels.mattermost.groupPolicy = "allowlist" (erwähnungsgesteuert).
• Absender mit channels.mattermost.groupAllowFrom erlauben (Benutzer-IDs empfohlen).
• channels.mattermost.groupAllowFrom akzeptiert accessGroup:<name>-Einträge. Siehe Zugriffsgruppen.
• Erwähnungsüberschreibungen pro Channel befinden sich unter channels.mattermost.groups.<channelId>.requireMention oder channels.mattermost.groups["*"].requireMention als Standardwert.
• @username-Abgleich ist veränderlich und nur aktiviert, wenn channels.mattermost.dangerouslyAllowNameMatching: true.
• Offene Channels: channels.mattermost.groupPolicy="open" (erwähnungsgesteuert).
• Laufzeithinweis: Wenn channels.mattermost vollständig fehlt, fällt die Laufzeit für Gruppenprüfungen auf groupPolicy="allowlist" zurück (auch wenn channels.defaults.groupPolicy gesetzt ist).

{
  channels: {
    mattermost: {
      groupPolicy: "open",
      groups: {
        "*": { requireMention: true },
        "team-channel-id": { requireMention: false },
      },
    },
  },
}

​

Ziele für ausgehende Zustellung

• channel:<id> für einen Channel
• user:<id> für eine DM
• @username für eine DM (über die Mattermost-API aufgelöst)

​

DM-Channel-Wiederholung

{
  channels: {
    mattermost: {
      dmChannelRetry: {
        maxRetries: 3,
        initialDelayMs: 1000,
        maxDelayMs: 10000,
        timeoutMs: 30000,
      },
    },
  },
}

• Dies gilt nur für die Erstellung von DM-Channels (/api/v4/channels/direct), nicht für jeden Mattermost-API-Aufruf.
• Wiederholungen gelten für vorübergehende Fehler wie Ratenlimits, 5xx-Antworten sowie Netzwerk- oder Timeout-Fehler.
• 4xx-Clientfehler außer 429 werden als dauerhaft behandelt und nicht erneut versucht.

​

Preview-Streaming

{
  channels: {
    mattermost: {
      streaming: "partial", // off | partial | block | progress
    },
  },
}

​

Reaktionen (Nachrichtentool)

• Verwenden Sie message action=react mit channel=mattermost.
• messageId ist die Mattermost-Post-ID.
• emoji akzeptiert Namen wie thumbsup oder :+1: (Doppelpunkte sind optional).
• Setzen Sie remove=true (boolesch), um eine Reaktion zu entfernen.
• Ereignisse zum Hinzufügen/Entfernen von Reaktionen werden als Systemereignisse an die geroutete Agentensitzung weitergeleitet.

message action=react channel=mattermost target=channel:<channelId> messageId=<postId> emoji=thumbsup
message action=react channel=mattermost target=channel:<channelId> messageId=<postId> emoji=thumbsup remove=true

• channels.mattermost.actions.reactions: Reaktionsaktionen aktivieren/deaktivieren (standardmäßig true).
• Überschreibung pro Konto: channels.mattermost.accounts.<id>.actions.reactions.

​

Interaktive Buttons (Nachrichtentool)

{
  channels: {
    mattermost: {
      capabilities: ["inlineButtons"],
    },
  },
}

message action=send channel=mattermost target=channel:<channelId> buttons=[[{"text":"Yes","callback_data":"yes"},{"text":"No","callback_data":"no"}]]

​

Direkte API-Integration (externe Skripte)

{
  channel_id: "<channelId>",
  message: "Choose an option:",
  props: {
    attachments: [
      {
        actions: [
          {
            id: "mybutton01", // alphanumeric only - see below
            type: "button", // required, or clicks are silently ignored
            name: "Approve", // display label
            style: "primary", // optional: "default", "primary", "danger"
            integration: {
              url: "https://gateway.example.com/mattermost/interactions/default",
              context: {
                action_id: "mybutton01", // must match button id (for name lookup)
                action: "approve",
                // ... any custom fields ...
                _token: "<hmac>", // see HMAC section below
              },
            },
          },
        ],
      },
    ],
  },
}

import hmac, hashlib, json

secret = hmac.new(
    b"openclaw-mattermost-interactions",
    bot_token.encode(), hashlib.sha256
).hexdigest()

ctx = {"action_id": "mybutton01", "action": "approve"}
payload = json.dumps(ctx, sort_keys=True, separators=(",", ":"))
token = hmac.new(secret.encode(), payload.encode(), hashlib.sha256).hexdigest()

context = {**ctx, "_token": token}

​

Verzeichnisadapter

​

Multi-Account

{
  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

​

Verwandt

• Channel-Routing - Session-Routing für Nachrichten
• Channel-Übersicht - alle unterstützten Channels
• Gruppen - Gruppenchat-Verhalten und Mention-Gating
• Pairing - DM-Authentifizierung und Pairing-Ablauf
• Sicherheit - Zugriffsmodell und Härtung