Mattermost

• native: "auto" ist für Mattermost standardmäßig deaktiviert. Setzen Sie native: true, um es zu aktivieren.
• Wenn callbackUrl weggelassen wird, leitet OpenClaw eine URL aus Gateway-Host/Port + callbackPath ab.
• Für Multi-Account-Einrichtungen kann commands auf oberster Ebene oder unter channels.mattermost.accounts.<id>.commands gesetzt werden (Kontowerte überschreiben Felder auf oberster Ebene).
• Befehls-Callbacks werden mit den pro Befehl zurückgegebenen Token validiert, die Mattermost zurückgibt, wenn OpenClaw oc_*-Befehle registriert.
• OpenClaw aktualisiert die aktuelle Mattermost-Befehlsregistrierung, bevor jeder Callback akzeptiert wird, sodass veraltete Token von gelöschten oder neu generierten Slash-Befehlen ohne Gateway-Neustart nicht mehr akzeptiert werden.
• Die Callback-Validierung schlägt geschlossen fehl, wenn die Mattermost-API nicht bestätigen kann, dass der Befehl noch aktuell ist; fehlgeschlagene Validierungen werden kurz zwischengespeichert, gleichzeitige Lookups werden zusammengeführt, und Starts frischer Lookups werden pro Befehl ratenbegrenzt, um Wiedergabedruck zu begrenzen.
• Slash-Callbacks schlagen geschlossen fehl, wenn die Registrierung fehlgeschlagen ist, der Start nur teilweise erfolgreich war oder das Callback-Token nicht mit dem registrierten Token des aufgelösten Befehls übereinstimmt (ein für einen Befehl gültiges Token kann die Upstream-Validierung für einen anderen Befehl nicht erreichen).

Der Callback-Endpunkt muss vom Mattermost-Server erreichbar sein.

• Setzen Sie callbackUrl nicht auf localhost, es sei denn, Mattermost läuft auf demselben Host/in demselben Netzwerk-Namespace wie OpenClaw.
• Setzen Sie callbackUrl nicht auf Ihre Mattermost-Basis-URL, es sei denn, diese URL leitet /api/channels/mattermost/command per Reverse Proxy an OpenClaw weiter.
• Eine schnelle Prüfung ist curl https://<gateway-host>/api/channels/mattermost/command; ein GET sollte von OpenClaw 405 Method Not Allowed zurückgeben, nicht 404.

Wenn Ihr Callback private/Tailnet-/interne Adressen ansteuert, setzen Sie Mattermost ServiceSettings.AllowedUntrustedInternalConnections so, dass der Callback-Host/die Callback-Domain enthalten ist.

Verwenden Sie Host-/Domain-Einträge, keine vollständigen URLs.

• Gut: gateway.tailnet-name.ts.net
• Schlecht: https://gateway.tailnet-name.ts.net

• partial ist die übliche Wahl: ein Vorschau-Post, der bearbeitet wird, während die Antwort wächst, und dann mit der vollständigen Antwort finalisiert wird.
• block verwendet Entwurfs-Chunks im Append-Stil innerhalb des Vorschau-Posts.
• progress zeigt während der Generierung eine Statusvorschau und postet die endgültige Antwort erst nach Abschluss.
• off deaktiviert Preview-Streaming.

• Wenn der Stream nicht direkt finalisiert werden kann (zum Beispiel weil der Post während des Streams gelöscht wurde), fällt OpenClaw auf das Senden eines frischen finalen Posts zurück, damit die Antwort nie verloren geht.
• Payloads, die nur Denkprozesse enthalten, werden aus Channel-Posts unterdrückt, einschließlich Text, der als > Thinking-Blockquote eintrifft. Setzen Sie /reasoning on, um Denkprozesse in anderen Oberflächen zu sehen; der finale Mattermost-Post enthält nur die Antwort.
• Siehe Streaming für die Channel-Mapping-Matrix.

• Schaltflächen-Callbacks verwenden HMAC-SHA256-Verifizierung (automatisch, keine Konfiguration erforderlich).
• Mattermost entfernt Callback-Daten aus seinen API-Antworten (Sicherheitsfunktion), daher werden beim Klicken alle Schaltflächen entfernt - eine teilweise Entfernung ist nicht möglich.
• Aktions-IDs, die Bindestriche oder Unterstriche enthalten, werden automatisch bereinigt (Mattermost-Routing-Einschränkung).

• channels.mattermost.capabilities: Array von Capability-Strings. Fügen Sie "inlineButtons" hinzu, um die Beschreibung des Schaltflächen-Tools im Agent-System-Prompt zu aktivieren.
• channels.mattermost.interactions.callbackBaseUrl: optionale externe Basis-URL für Schaltflächen-Callbacks (zum Beispiel https://gateway.example.com). Verwenden Sie dies, wenn Mattermost den Gateway nicht direkt über dessen Bind-Host erreichen kann.
• In Multi-Account-Setups können Sie dasselbe Feld auch unter channels.mattermost.accounts.<id>.interactions.callbackBaseUrl setzen.
• Wenn interactions.callbackBaseUrl ausgelassen wird, leitet OpenClaw die Callback-URL aus gateway.customBindHost + gateway.port ab und fällt dann auf http://localhost:<port> zurück.
• Erreichbarkeitsregel: Die Schaltflächen-Callback-URL muss vom Mattermost-Server erreichbar sein. localhost funktioniert nur, wenn Mattermost und OpenClaw auf demselben Host/in demselben Netzwerk-Namespace ausgeführt werden.
• Wenn Ihr Callback-Ziel privat/tailnet/intern ist, fügen Sie seinen Host bzw. seine Domain zu Mattermost ServiceSettings.AllowedUntrustedInternalConnections hinzu.

• Pythons json.dumps fügt standardmäßig Leerzeichen hinzu ({"key": "val"}). Verwenden Sie separators=(",", ":"), um der kompakten JavaScript-Ausgabe ({"key":"val"}) zu entsprechen.
• Signieren Sie immer alle Kontextfelder (minus _token). Der Gateway entfernt _token und signiert dann alles, was übrig bleibt. Das Signieren einer Teilmenge führt zu einem stillen Verifizierungsfehler.
• Verwenden Sie sort_keys=True - der Gateway sortiert Schlüssel vor dem Signieren, und Mattermost kann Kontextfelder beim Speichern der Payload neu anordnen.
• Leiten Sie das Secret aus dem Bot-Token ab (deterministisch), nicht aus zufälligen Bytes. Das Secret muss in dem Prozess, der Schaltflächen erstellt, und im Gateway, der verifiziert, identisch sein.

Stellen Sie sicher, dass sich der Bot im Channel befindet, und erwähnen Sie ihn (oncall), verwenden Sie ein Trigger-Präfix (onchar), oder setzen Sie chatmode: "onmessage".

• Prüfen Sie das Bot-Token, die Basis-URL und ob der Account aktiviert ist.
• Multi-Account-Probleme: Env-Vars gelten nur für den default-Account.

• Unauthorized: invalid command token.: OpenClaw hat das Callback-Token nicht akzeptiert. Typische Ursachen:
  • Die Slash-Command-Registrierung ist fehlgeschlagen oder wurde beim Start nur teilweise abgeschlossen
  • Der Callback trifft den falschen Gateway/Account
  • Mattermost hat noch alte Commands, die auf ein früheres Callback-Ziel zeigen
  • Der Gateway wurde neu gestartet, ohne Slash Commands erneut zu aktivieren
• Wenn native Slash Commands nicht mehr funktionieren, prüfen Sie die Logs auf mattermost: failed to register slash commands oder mattermost: native slash commands enabled but no commands could be registered.
• Wenn callbackUrl ausgelassen wird und Logs warnen, dass der Callback zu http://127.0.0.1:18789/... aufgelöst wurde, ist diese URL wahrscheinlich nur erreichbar, wenn Mattermost auf demselben Host/in demselben Netzwerk-Namespace wie OpenClaw läuft. Setzen Sie stattdessen eine explizite, extern erreichbare commands.callbackUrl.

• Schaltflächen erscheinen als weiße Kästen: Der Agent sendet möglicherweise fehlerhafte Schaltflächendaten. Prüfen Sie, dass jede Schaltfläche sowohl ein text- als auch ein callback_data-Feld hat.
• Schaltflächen werden gerendert, aber Klicks bewirken nichts: Stellen Sie sicher, dass AllowedUntrustedInternalConnections in der Mattermost-Serverkonfiguration 127.0.0.1 localhost enthält und dass EnablePostActionIntegration in ServiceSettings auf true gesetzt ist.
• Schaltflächen geben beim Klicken 404 zurück: Die Schaltflächen-id enthält wahrscheinlich Bindestriche oder Unterstriche. Mattermosts Aktions-Router scheitert bei nicht alphanumerischen IDs. Verwenden Sie nur [a-zA-Z0-9].
• Gateway-Logs melden invalid _token: HMAC stimmt nicht überein. Prüfen Sie, dass Sie alle Kontextfelder signieren (nicht nur eine Teilmenge), sortierte Schlüssel verwenden und kompaktes JSON verwenden (keine Leerzeichen). Siehe den HMAC-Abschnitt oben.
• Gateway-Logs melden missing _token in context: Das _token-Feld befindet sich nicht im Kontext der Schaltfläche. Stellen Sie sicher, dass es beim Erstellen der Integrations-Payload enthalten ist.
• Bestätigung zeigt rohe ID statt Schaltflächennamen: context.action_id stimmt nicht mit der id der Schaltfläche überein. Setzen Sie beide auf denselben bereinigten Wert.
• Der Agent weiß nichts von Schaltflächen: Fügen Sie capabilities: ["inlineButtons"] zur Mattermost-Channel-Konfiguration hinzu.