Mattermost

• native: "auto" is standaard uitgeschakeld voor Mattermost. Stel native: true in om dit in te schakelen.
• Als callbackUrl is weggelaten, leidt OpenClaw er een af uit Gateway-host/poort + callbackPath.
• Voor configuraties met meerdere accounts kan commands op het hoogste niveau worden ingesteld of onder channels.mattermost.accounts.<id>.commands (accountwaarden overschrijven velden op het hoogste niveau).
• Commandocallbacks worden gevalideerd met de tokens per commando die Mattermost retourneert wanneer OpenClaw oc_*-commando's registreert.
• OpenClaw vernieuwt de huidige Mattermost-commandoregistratie voordat elke callback wordt geaccepteerd, zodat verouderde tokens van verwijderde of opnieuw gegenereerde slashcommando's niet meer worden geaccepteerd zonder een herstart van de Gateway.
• Callbackvalidatie faalt gesloten als de Mattermost API niet kan bevestigen dat het commando nog actueel is; mislukte validaties worden kort gecachet, gelijktijdige lookups worden samengevoegd, en nieuwe lookup-starts worden per commando beperkt in snelheid om replay-druk te begrenzen.
• Slashcallbacks falen gesloten wanneer registratie is mislukt, het opstarten gedeeltelijk was, of de callbacktoken niet overeenkomt met de geregistreerde token van het opgeloste commando (een token die geldig is voor één commando kan geen upstreamvalidatie bereiken voor een ander commando).

Het callback-eindpunt moet bereikbaar zijn vanaf de Mattermost-server.

• Stel callbackUrl niet in op localhost, tenzij Mattermost op dezelfde host/netwerknaamruimte draait als OpenClaw.
• Stel callbackUrl niet in op je Mattermost-basis-URL, tenzij die URL /api/channels/mattermost/command via een reverse proxy naar OpenClaw doorstuurt.
• Een snelle controle is curl https://<gateway-host>/api/channels/mattermost/command; een GET moet 405 Method Not Allowed van OpenClaw retourneren, niet 404.

Als je callback naar private/tailnet/interne adressen verwijst, stel dan Mattermost ServiceSettings.AllowedUntrustedInternalConnections in om de callbackhost/het callbackdomein op te nemen.

Gebruik host-/domeinitems, geen volledige URL's.

• Goed: gateway.tailnet-name.ts.net
• Fout: https://gateway.tailnet-name.ts.net

• partial is de gebruikelijke keuze: één previewbericht dat wordt bewerkt terwijl het antwoord groeit, en daarna definitief wordt gemaakt met het volledige antwoord.
• block gebruikt conceptdelen in append-stijl binnen het previewbericht.
• progress toont een statuspreview tijdens het genereren en plaatst het definitieve antwoord pas bij voltooiing.
• off schakelt previewstreaming uit.

• Als de stream niet ter plekke definitief kan worden gemaakt (bijvoorbeeld omdat het bericht halverwege de stream is verwijderd), valt OpenClaw terug op het verzenden van een nieuw definitief bericht, zodat het antwoord nooit verloren gaat.
• Payloads met alleen redenering worden onderdrukt in kanaalberichten, inclusief tekst die binnenkomt als een > Reasoning:-blockquote. Stel /reasoning on in om denken op andere oppervlakken te zien; het definitieve Mattermost-bericht behoudt alleen het antwoord.
• Zie Streaming voor de kanaaltoewijzingsmatrix.

• Knop-callbacks gebruiken HMAC-SHA256-verificatie (automatisch, geen configuratie nodig).
• Mattermost verwijdert callbackgegevens uit zijn API-antwoorden (beveiligingsfunctie), dus alle knoppen worden bij klikken verwijderd - gedeeltelijke verwijdering is niet mogelijk.
• Actie-ID's met koppeltekens of underscores worden automatisch gesaneerd (routeringsbeperking van Mattermost).

• channels.mattermost.capabilities: array van capability-strings. Voeg "inlineButtons" toe om de beschrijving van de knoppentool in de systeemprompt van de agent in te schakelen.
• channels.mattermost.interactions.callbackBaseUrl: optionele externe basis-URL voor knop-callbacks (bijvoorbeeld https://gateway.example.com). Gebruik dit wanneer Mattermost de gateway niet rechtstreeks kan bereiken op de bindhost ervan.
• In opstellingen met meerdere accounts kun je hetzelfde veld ook instellen onder channels.mattermost.accounts.<id>.interactions.callbackBaseUrl.
• Als interactions.callbackBaseUrl wordt weggelaten, leidt OpenClaw de callback-URL af uit gateway.customBindHost + gateway.port, en valt daarna terug op http://localhost:<port>.
• Bereikbaarheidsregel: de URL voor knop-callbacks moet bereikbaar zijn vanaf de Mattermost-server. localhost werkt alleen wanneer Mattermost en OpenClaw op dezelfde host/netwerknamespace draaien.
• Als je callbackdoel privé/tailnet/intern is, voeg dan de host/het domein toe aan Mattermost ServiceSettings.AllowedUntrustedInternalConnections.

• Python's json.dumps voegt standaard spaties toe ({"key": "val"}). Gebruik separators=(",", ":") om overeen te komen met de compacte uitvoer van JavaScript ({"key":"val"}).
• Onderteken altijd alle contextvelden (minus _token). De Gateway verwijdert _token en ondertekent daarna alles wat overblijft. Het ondertekenen van een subset veroorzaakt een stilzwijgende verificatiefout.
• Gebruik sort_keys=True - de Gateway sorteert sleutels vóór het ondertekenen, en Mattermost kan contextvelden opnieuw ordenen bij het opslaan van de payload.
• Leid het geheim af uit het bottoken (deterministisch), niet uit willekeurige bytes. Het geheim moet hetzelfde zijn in het proces dat knoppen maakt en de Gateway die verifieert.

Zorg dat de bot in het kanaal zit en vermeld deze (oncall), gebruik een triggerprefix (onchar), of stel chatmode: "onmessage" in.

• Controleer het bottoken, de basis-URL en of het account is ingeschakeld.
• Problemen met meerdere accounts: env-vars zijn alleen van toepassing op het default-account.

• Unauthorized: invalid command token.: OpenClaw heeft het callbacktoken niet geaccepteerd. Typische oorzaken:
  • registratie van slash commands is mislukt of slechts gedeeltelijk voltooid bij het opstarten
  • de callback raakt de verkeerde gateway/het verkeerde account
  • Mattermost heeft nog oude commands die naar een eerder callbackdoel wijzen
  • de Gateway is opnieuw gestart zonder slash commands opnieuw te activeren
• Als native slash commands niet meer werken, controleer dan de logs op mattermost: failed to register slash commands of mattermost: native slash commands enabled but no commands could be registered.
• Als callbackUrl wordt weggelaten en logs waarschuwen dat de callback is opgelost naar http://127.0.0.1:18789/..., is die URL waarschijnlijk alleen bereikbaar wanneer Mattermost op dezelfde host/netwerknamespace draait als OpenClaw. Stel in plaats daarvan een expliciete extern bereikbare commands.callbackUrl in.

• Knoppen verschijnen als witte vakken: de agent stuurt mogelijk misvormde knopgegevens. Controleer of elke knop zowel text- als callback_data-velden heeft.
• Knoppen worden weergegeven maar klikken doen niets: controleer of AllowedUntrustedInternalConnections in de Mattermost-serverconfiguratie 127.0.0.1 localhost bevat, en dat EnablePostActionIntegration true is in ServiceSettings.
• Knoppen retourneren 404 bij klikken: de knop-id bevat waarschijnlijk koppeltekens of underscores. De actierouter van Mattermost breekt op niet-alfanumerieke ID's. Gebruik alleen [a-zA-Z0-9].
• Gateway-logs invalid _token: HMAC komt niet overeen. Controleer of je alle contextvelden ondertekent (niet een subset), gesorteerde sleutels gebruikt en compacte JSON gebruikt (geen spaties). Zie de HMAC-sectie hierboven.
• Gateway-logs missing _token in context: het _token-veld staat niet in de context van de knop. Zorg dat het is opgenomen bij het bouwen van de integratiepayload.
• Bevestiging toont ruwe ID in plaats van knopnaam: context.action_id komt niet overeen met de id van de knop. Stel beide in op dezelfde gesaneerde waarde.
• Agent weet niets van knoppen: voeg capabilities: ["inlineButtons"] toe aan de Mattermost-kanaalconfiguratie.