Mattermost

• native en nativeSkills zijn standaard ingesteld op "auto", wat voor Mattermost als uitgeschakeld wordt geïnterpreteerd. Stel ze expliciet in op true.
• callbackPath is standaard ingesteld op /api/channels/mattermost/command.
• Als callbackUrl wordt weggelaten, leidt OpenClaw http://<gateway.customBindHost or localhost>:<gateway.port, default 18789><callbackPath> af. Jokerteken-bindhosts (0.0.0.0, ::) vallen terug op localhost.
• Voor configuraties met meerdere accounts kan commands op het hoogste niveau of onder channels.mattermost.accounts.<id>.commands worden ingesteld (accountwaarden overschrijven velden op het hoogste niveau).
• Bestaande slash-opdrachten met dezelfde trigger die door andere integraties zijn gemaakt, blijven ongewijzigd (ze worden bij registratie overgeslagen); opdrachten die door de bot zijn gemaakt, worden bijgewerkt of opnieuw gemaakt wanneer de callback-URL afwijkt.
• Opdrachtcallbacks worden gevalideerd met de tokens per opdracht die Mattermost retourneert wanneer OpenClaw oc_*-opdrachten registreert.
• OpenClaw vernieuwt de huidige registratie van Mattermost-opdrachten voordat elke callback wordt geaccepteerd, zodat verouderde tokens van verwijderde of opnieuw gegenereerde slash-opdrachten niet langer worden geaccepteerd zonder dat de Gateway opnieuw hoeft te worden gestart.
• Callbackvalidatie wordt veilig geweigerd als de Mattermost-API niet kan bevestigen dat de opdracht nog actueel is; mislukte validaties worden kort in de cache opgeslagen, gelijktijdige opzoekacties worden samengevoegd en nieuwe opzoekacties worden per opdracht in frequentie beperkt om de druk van herhalingsaanvallen te begrenzen.
• Slash-callbacks worden veilig geweigerd wanneer de registratie is mislukt, het opstarten slechts gedeeltelijk is voltooid of het callbacktoken niet overeenkomt met het geregistreerde token van de gevonden opdracht (een token dat geldig is voor één opdracht kan de bovenliggende validatie voor een andere opdracht niet bereiken).
• Geaccepteerde callbacks worden bevestigd met een kortstondig antwoord "Processing..."; het echte antwoord wordt als een normaal bericht verzonden.

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

• Stel callbackUrl niet in op localhost, tenzij Mattermost in dezelfde host-/netwerknaamruimte als OpenClaw draait.
• Stel callbackUrl niet in op de basis-URL van Mattermost, 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-aanvraag moet 405 Method Not Allowed van OpenClaw retourneren, niet 404.

Als uw callback op privé-, tailnet- of interne adressen is gericht, stelt u Mattermost ServiceSettings.AllowedUntrustedInternalConnections zo in dat de callbackhost of het callbackdomein wordt opgenomen.

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

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

• partial (standaard): één previewbericht dat wordt bewerkt naarmate het antwoord groeit en vervolgens wordt voltooid met het volledige antwoord.
• block wisselt de preview tussen voltooide tekstblokken en blokken met toolactiviteit, zodat elk blok als afzonderlijk bericht zichtbaar blijft in plaats van ter plaatse te worden overschreven. Parallelle en opeenvolgende toolupdates delen het huidige toolactiviteitsbericht.
• progress toont tijdens het genereren een statuspreview en plaatst het definitieve antwoord pas na voltooiing.
• off schakelt previewstreaming uit. Met blockStreaming: true worden voltooide assistentblokken nog steeds als normale blokantwoorden (afzonderlijke berichten) bezorgd, in plaats van als één samengevoegd definitief bericht.

• Als de stream niet ter plaatse kan worden voltooid (bijvoorbeeld omdat het bericht tijdens het streamen is verwijderd), valt OpenClaw terug op het verzenden van een nieuw definitief bericht, zodat het antwoord nooit verloren gaat.
• Payloads die uitsluitend denkactiviteit bevatten, worden niet in kanaalberichten geplaatst, inclusief tekst die als een > Thinking-blokcitaat binnenkomt. Stel /reasoning on in om denkactiviteit op andere oppervlakken te zien; het definitieve Mattermost-bericht bevat alleen het antwoord.
• Zie Streaming voor de kanaaltoewijzingsmatrix.

• Knopcallbacks gebruiken HMAC-SHA256-verificatie (automatisch, geen configuratie nodig).
• Bij een klik wordt het volledige bijlageblok vervangen, zodat alle knoppen tegelijk worden verwijderd; gedeeltelijke verwijdering is niet mogelijk.
• Actie-ID's die koppeltekens of onderstrepingstekens bevatten, worden automatisch opgeschoond (beperking van Mattermost-routering).
• Klikken waarvan de action_id niet overeenkomt met een actie in het oorspronkelijke bericht, worden geweigerd met 403 ("Unknown action").

• channels.mattermost.capabilities: matrix van mogelijkheden als tekenreeksen. Voeg "inlineButtons" toe om de beschrijving van de knoptool in de systeemprompt van de agent in te schakelen.
• channels.mattermost.interactions.callbackBaseUrl: optionele externe basis-URL voor knopcallbacks (bijvoorbeeld https://gateway.example.com). Gebruik dit wanneer Mattermost de Gateway niet rechtstreeks via diens bindingshost kan bereiken.
• In configuraties met meerdere accounts kunt u hetzelfde veld ook instellen onder channels.mattermost.accounts.<id>.interactions.callbackBaseUrl.
• Als interactions.callbackBaseUrl is weggelaten, leidt OpenClaw de callback-URL af van gateway.customBindHost + gateway.port (standaard 18789) en valt vervolgens terug op http://localhost:<port>. Het callbackpad is /mattermost/interactions/<accountId>.
• Bereikbaarheidsregel: de callback-URL van de knop moet bereikbaar zijn vanaf de Mattermost-server. localhost werkt alleen wanneer Mattermost en OpenClaw op dezelfde host/netwerknaamruimte draaien.
• channels.mattermost.interactions.allowedSourceIps: toelatingslijst met bron-IP-adressen voor knopcallbacks. Zonder deze lijst worden alleen loopback-bronnen (127.0.0.1, ::1) geaccepteerd. Een externe Mattermost-server moet hier dus aan de toelatingslijst worden toegevoegd, anders worden klikken geweigerd met 403. Stel achter een reverse proxy ook gateway.trustedProxies in, zodat het echte client-IP-adres wordt afgeleid uit doorgestuurde headers.
• Als uw callbackdoel privé, intern of in een tailnet is, voegt u de host/het domein ervan toe aan Mattermost ServiceSettings.AllowedUntrustedInternalConnections.

• Python-functie 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 (met uitzondering van _token). De Gateway verwijdert _token en ondertekent vervolgens alles wat overblijft. Het ondertekenen van een deelverzameling veroorzaakt een verificatiefout zonder melding.
• Gebruik sort_keys=True; de Gateway sorteert sleutels vóór ondertekening en Mattermost kan contextvelden opnieuw ordenen bij het opslaan van de payload.
• Leid het geheim af van het bottoken (deterministisch), niet van willekeurige bytes. Het geheim moet hetzelfde zijn in het proces dat knoppen maakt en in de Gateway die ze verifieert.

Zorg ervoor dat de bot zich in het kanaal bevindt en vermeld de bot (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: omgevingsvariabelen zijn alleen van toepassing op het default-account.
• Privé-/LAN-Mattermost-hosts vereisen network.dangerouslyAllowPrivateNetwork: true (de SSRF-beveiliging blokkeert standaard privé-IP-adressen).

• Unauthorized: invalid command token.: OpenClaw heeft het callbacktoken niet geaccepteerd. Gebruikelijke oorzaken:
  • de registratie van slash-opdrachten is mislukt of bij het opstarten slechts gedeeltelijk voltooid
  • de callback bereikt de verkeerde Gateway of het verkeerde account
  • Mattermost heeft nog oude opdrachten die naar een eerder callbackdoel verwijzen
  • de Gateway is opnieuw gestart zonder de slash-opdrachten opnieuw te activeren
• Als native slash-opdrachten niet meer werken, controleer dan de logboeken op mattermost: failed to register slash commands of mattermost: native slash commands enabled but no commands could be registered.
• Als callbackUrl is weggelaten en de logboeken waarschuwen dat de callback is omgezet naar een local loopback-URL zoals http://localhost:18789/..., is die URL waarschijnlijk alleen bereikbaar wanneer Mattermost in dezelfde host-/netwerknaamruimte als OpenClaw draait. Stel in plaats daarvan expliciet een extern bereikbare commands.callbackUrl in.

• Knoppen verschijnen als witte vakken of helemaal niet: de knopgegevens zijn ongeldig. Elke presentatieknop heeft een label en een value nodig (knoppen waarbij een van beide ontbreekt, worden weggelaten).
• Knoppen worden weergegeven, maar klikken doet niets: controleer of de Gateway bereikbaar is vanaf de Mattermost-server, of het IP-adres van de Mattermost-server is opgenomen in channels.mattermost.interactions.allowedSourceIps (zonder deze instelling wordt alleen local loopback geaccepteerd) en of ServiceSettings.AllowedUntrustedInternalConnections de callbackhost bevat voor privédoelen.
• Knoppen retourneren bij klikken een 404-fout: de knop-id bevat waarschijnlijk koppeltekens of underscores. De actierouter van Mattermost werkt niet met niet-alfanumerieke ID's. Gebruik uitsluitend [a-zA-Z0-9].
• De Gateway logt rejected callback source: de klik kwam van een IP-adres buiten interactions.allowedSourceIps. Voeg de Mattermost-server of uw ingress toe aan de toelatingslijst en stel gateway.trustedProxies in bij gebruik van een reverse proxy.
• De Gateway logt invalid _token: HMAC komt niet overeen. Controleer of u alle contextvelden ondertekent (niet slechts een subset), gesorteerde sleutels gebruikt en compacte JSON gebruikt (zonder spaties). Zie de HMAC-sectie hierboven.
• De Gateway logt missing _token in context: het veld _token staat niet in de context van de knop. Zorg ervoor dat het wordt opgenomen bij het samenstellen van de integratiepayload.
• De Gateway weigert de klik met Unknown action: context.action_id komt niet overeen met een actie-id in het bericht. Stel beide in op dezelfde opgeschoonde waarde.
• De agent biedt geen knoppen aan: voeg capabilities: ["inlineButtons"] toe aan de Mattermost-kanaalconfiguratie.