Slack

Slack-ondersteuning omvat DM's en kanalen via Slack-appintegraties. Het standaardtransport is Socket Mode; HTTP Request URLs worden ook ondersteund. Relay-modus is bedoeld voor beheerde implementaties waarbij een vertrouwde router de Slack-ingang beheert.

Een transport kiezen

Socket Mode en HTTP Request URLs bieden dezelfde functionaliteit voor berichten, slash-opdrachten, App Home en interactiviteit. Kies op basis van de implementatievorm, niet van de functies.

Relay-modus

Relay-modus scheidt de Slack-ingang van de OpenClaw-gateway. Een vertrouwde router beheert de enige Slack Socket Mode-verbinding, kiest een bestemmingsgateway en stuurt een getypeerde gebeurtenis door via een geauthenticeerde websocket. De gateway gebruikt nog steeds zijn eigen bottoken voor uitgaande aanroepen naar de Slack Web API.

{  channels: {    slack: {      mode: "relay",      botToken: { source: "env", provider: "default", id: "SLACK_BOT_TOKEN" },      relay: {        url: "wss://router.example.com/gateway/ws",        authToken: { source: "env", provider: "default", id: "SLACK_RELAY_AUTH_TOKEN" },        gatewayId: "team-gateway",      },    },  },}

De relay-URL moet wss:// gebruiken, tenzij deze naar localhost verwijst. Beschouw het bearertoken en de routeringstabel van de router als onderdeel van de Slack-autorisatiegrens: gerouteerde gebeurtenissen komen de normale Slack-berichtenhandler binnen als geautoriseerde activeringen. Een door de router verstrekte slack_identity in het websocket-hello-frame kan de standaard uitgaande gebruikersnaam en het pictogram instellen; een expliciete identiteit die door de aanroeper wordt verstrekt, heeft nog steeds voorrang. De relay-verbinding maakt opnieuw verbinding met dezelfde begrensde back-offtiming als Socket Mode en wist de door de router verstrekte identiteit telkens wanneer de verbinding wordt verbroken.

Organisatiebrede installaties voor Enterprise Grid

Eén Slack-account kan berichten ontvangen uit elke workspace die onder een organisatiebrede Enterprise Grid-installatie valt. Kies rechtstreekse Socket Mode of HTTP Request URLs; relay-modus wordt niet ondersteund voor enterprise-accounts. Beide onderstaande manifesten met minimale bevoegdheden schakelen alleen het V1-pad voor message- en app_mention-gebeurtenissen, directe antwoorden en door de listener beheerde statusreacties in.

Socket Mode

{  "display_information": {    "name": "OpenClaw",    "description": "Slack-connector voor OpenClaw"  },  "features": {    "bot_user": { "display_name": "OpenClaw", "always_online": true }  },  "oauth_config": {    "scopes": {      "bot": [        "app_mentions:read",        "channels:history",        "channels:read",        "chat:write",        "files:read",        "files:write",        "groups:history",        "groups:read",        "im:history",        "im:read",        "mpim:history",        "mpim:read",        "reactions:write",        "users:read"      ]    }  },  "settings": {    "org_deploy_enabled": true,    "socket_mode_enabled": true,    "event_subscriptions": {      "bot_events": [        "app_mention",        "message.channels",        "message.groups",        "message.im",        "message.mpim"      ]    }  }}

Laat een Enterprise Grid Org Admin of Org Owner de app goedkeuren, op organisatieniveau installeren en de workspaces kiezen die onder de installatie vallen. Controleer voordat je OpenClaw start of de app in elke beoogde workspace beschikbaar is. Genereer voor Socket Mode een app-level token met connections:write en kopieer vervolgens het bottoken uit de organisatie-installatie. Configureer het account dat het organisatiebreed geïnstalleerde bottoken gebruikt:

{  channels: {    slack: {      enabled: true,      mode: "socket",      enterpriseOrgInstall: true,      appToken: { source: "env", provider: "default", id: "SLACK_APP_TOKEN" },      botToken: { source: "env", provider: "default", id: "SLACK_BOT_TOKEN" },      dmPolicy: "open",      allowFrom: ["*"],      groupPolicy: "allowlist",      channels: {        C0123456789: { requireMention: true },      },    },  },}

HTTP Request URLs

Gebruik de HTTP-modus wanneer de Gateway een openbaar HTTPS-eindpunt heeft en geen Socket Mode-verbinding opent. Vervang de voorbeeld-URL door de openbare webhookPath-URL van de Gateway (standaard /slack/events):

{  "display_information": {    "name": "OpenClaw",    "description": "Slack-connector voor OpenClaw"  },  "features": {    "bot_user": { "display_name": "OpenClaw", "always_online": true }  },  "oauth_config": {    "scopes": {      "bot": [        "app_mentions:read",        "channels:history",        "channels:read",        "chat:write",        "files:read",        "files:write",        "groups:history",        "groups:read",        "im:history",        "im:read",        "mpim:history",        "mpim:read",        "reactions:write",        "users:read"      ]    }  },  "settings": {    "org_deploy_enabled": true,    "event_subscriptions": {      "request_url": "https://gateway-host.example.com/slack/events",      "bot_events": [        "app_mention",        "message.channels",        "message.groups",        "message.im",        "message.mpim"      ]    }  }}

Laat een Enterprise Grid Org Admin of Org Owner de app goedkeuren, op organisatieniveau installeren en de workspaces kiezen die onder de installatie vallen. Nadat Slack de Request URL heeft geverifieerd, kopieer je het bottoken van de organisatie-installatie en de Basic Information -> App Credentials -> Signing Secret van de app. Configureer het enterprise-account met hetzelfde pad voor de Request URL:

{  channels: {    slack: {      enabled: true,      mode: "http",      enterpriseOrgInstall: true,      botToken: { source: "env", provider: "default", id: "SLACK_BOT_TOKEN" },      signingSecret: {        source: "env",        provider: "default",        id: "SLACK_SIGNING_SECRET",      },      webhookPath: "/slack/events",      dmPolicy: "open",      allowFrom: ["*"],      groupPolicy: "allowlist",      channels: {        C0123456789: { requireMention: true },      },    },  },}

Bij het opstarten verifieert OpenClaw enterpriseOrgInstall met Slack auth.test. Een organisatiebreed geïnstalleerd token zonder de vlag, of een workspace-token met de vlag, zorgt ervoor dat het opstarten mislukt. Slack blijft de gezaghebbende bron voor welke workspaces de installatie hebben toegestaan; OpenClaw past vervolgens het geconfigureerde beleid voor kanalen, gebruikers, DM's en vermeldingen toe op elke geleverde gebeurtenis. Enterprise V1 weigert vóór het doorsturen alle door bots geschreven message- en app_mention-gebeurtenissen, ongeacht allowBots, omdat organisatie-installaties geen stabiele, aan een workspace gekoppelde botidentiteit bieden om lussen te voorkomen.

Enterprise-ondersteuning is bewust beperkt tot rechtstreekse Socket Mode- of HTTP- message- en app_mention-gebeurtenissen en de directe antwoorden daarop. Relay-modus, slash-opdrachten, interacties, App Home, listeners voor reactiegebeurtenissen, vastgezette items, Slack-actietools, native Slack-goedkeuringen, bindingen, levering in de wachtrij of volgens een planning en proactieve verzendingen zijn niet beschikbaar voor een enterprise-account. Uitgaande bevestigings-, typ- en statusreacties worden ondersteund via de door de listener beheerde Slack-client en vereisen reactions:write; inkomende reactiemeldingen en reactie-actietools blijven niet beschikbaar.

Directe antwoorden hergebruiken het standaardbezorggedrag van Slack voor fragmenten, media, metagegevens, identiteitsterugval, linkvoorvertoningen en ontvangstbevestigingen, maar alleen zolang de gevalideerde client die eigendom is van de listener in de actieve gebeurtenisafhandeling blijft. De verzendwachtrij in het geheugen en registraties van deelname aan threads worden gepartitioneerd op basis van de workspace van die gebeurtenis; de client zelf wordt nooit geserialiseerd of persistent opgeslagen.

Kanaalbeleidsleutels en dm.groupChannels-vermeldingen moeten onbewerkte, stabiele Slack-kanaal-ID's of de channel:<id>-vorm gebruiken. OpenClaw normaliseert beide vormen naar het onbewerkte kanaal-ID voor runtimeovereenkomsten; voorvoegsels slack:, group: en mpim: laten het opstarten mislukken. Gebruikersbeleidsvermeldingen moeten stabiele Slack-gebruikers-ID's gebruiken; namen, slugs, weergavenamen en e-mailadressen laten het opstarten mislukken. ID's moeten het canonieke Slack-voorvoegsel in hoofdletters en de canonieke hoofdtekst gebruiken (bijvoorbeeld C0123456789 of U0123456789); varianten in kleine letters en korte lookalikes laten het opstarten mislukken. Enterprise-accounts kunnen dangerouslyAllowNameMatching niet inschakelen. Enterprise-accounts mogen de algemene mentionPatterns.mode instellen, maar mentionPatterns.allowIn en mentionPatterns.denyIn laten het opstarten mislukken omdat kale Slack-kanaal-ID's niet aan een workspace zijn gekoppeld en in meerdere workspaces kunnen worden hergebruikt. Workspace-installaties behouden het bestaande, begrensde gedrag voor vermeldingspatronen. Elke geaccepteerde workspace krijgt een afzonderlijke identiteit voor routering, sessies, transcripties, deduplicatie, geschiedenis en caching, zelfs wanneer Slack-ID's overlappen. Binnen de message-stream worden gewone gebruikersberichten en door gebruikers aangemaakte file_share-gebeurtenissen ondersteund; andere berichtsubtypen worden vóór autorisatie of verwerking van systeemgebeurtenissen geweigerd.

Enterprise-DM's moeten uitgeschakeld zijn (dm.enabled=false of dmPolicy="disabled") of expliciet geopend zijn met dmPolicy="open" en een effectieve account-allowFrom die de letterlijke waarde "*" bevat. Een lege toegestane lijst of gebruikersspecifieke ID's zonder "*" laten het opstarten mislukken. Koppeling en DM-toegestane lijsten per gebruiker worden geweigerd omdat Slack-gebruikers-ID's in die autorisatieopslag niet aan een workspace zijn gekoppeld. Kanaal- en afzenderbeleid blijft van toepassing op kanaalberichten.

Installatie

openclaw plugins install @openclaw/slack

plugins install registreert en activeert de Plugin. Deze doet niets totdat je de Slack-app en onderstaande kanaalinstellingen configureert. Zie Plugins voor algemene regels voor het installeren van plugins.

Snelle configuratie

De manifesten in deze sectie maken een installatie die tot één workspace is beperkt. Gebruik voor een installatie voor een volledige Enterprise Grid-organisatie in plaats daarvan het speciale organisatiebrede manifest en de bijbehorende workflow.

{"display_information": {"name": "OpenClaw","description": "Slack-connector voor OpenClaw"},"features": {"bot_user": { "display_name": "OpenClaw", "always_online": true },"app_home": {"home_tab_enabled": true,"messages_tab_enabled": true,"messages_tab_read_only_enabled": false},"agent_view": {"agent_description": "OpenClaw koppelt Slack Agent View-gesprekken aan OpenClaw-agents.","suggested_prompts": [{ "title": "Wat kun je doen?", "message": "Waarmee kun je me helpen?" },{"title": "Dit kanaal samenvatten","message": "Vat de recente activiteit in dit kanaal samen."},{ "title": "Een antwoord opstellen", "message": "Help me een antwoord op te stellen." }]},"slash_commands": [{"command": "/openclaw","description": "Een bericht naar OpenClaw sturen","should_escape": false}]},"oauth_config": {"scopes": {"bot": ["app_mentions:read","assistant:write","channels:history","channels:read","chat:write","commands","emoji:read","files:read","files:write","groups:history","groups:read","im:history","im:read","im:write","mpim:history","mpim:read","mpim:write","pins:read","pins:write","reactions:read","reactions:write","usergroups:read","users:read"]}},"settings": {"socket_mode_enabled": true,"event_subscriptions": {"bot_events": ["app_home_opened","app_mention","app_context_changed","channel_rename","member_joined_channel","member_left_channel","message.channels","message.groups","message.im","message.mpim","pin_added","pin_removed","reaction_added","reaction_removed"]}}}

{"display_information": {"name": "OpenClaw","description": "Slack-connector voor OpenClaw"},"features": {"bot_user": { "display_name": "OpenClaw", "always_online": true },"app_home": {"home_tab_enabled": true,"messages_tab_enabled": true,"messages_tab_read_only_enabled": false},"agent_view": {"agent_description": "OpenClaw koppelt Slack Agent View-gesprekken aan OpenClaw-agents.","suggested_prompts": [{ "title": "Wat kun je doen?", "message": "Waarmee kun je me helpen?" },{"title": "Dit kanaal samenvatten","message": "Vat de recente activiteit in dit kanaal samen."},{ "title": "Een antwoord opstellen", "message": "Help me een antwoord op te stellen." }]},"slash_commands": [{"command": "/openclaw","description": "Een bericht naar OpenClaw sturen","should_escape": false}]},"oauth_config": {"scopes": {"bot": ["app_mentions:read","assistant:write","channels:history","channels:read","chat:write","commands","groups:history","groups:read","im:history","im:read","im:write","users:read"]}},"settings": {"socket_mode_enabled": true,"event_subscriptions": {"bot_events": ["app_home_opened","app_mention","app_context_changed","message.channels","message.groups","message.im"]}}}

export SLACK_APP_TOKEN=slack-app-token-exampleexport SLACK_BOT_TOKEN=slack-bot-token-examplecat > slack.socket.patch.json5 <<'JSON5'{channels: {slack: {enabled: true,mode: "socket",appToken: { source: "env", provider: "default", id: "SLACK_APP_TOKEN" },botToken: { source: "env", provider: "default", id: "SLACK_BOT_TOKEN" },},},}JSON5openclaw config patch --file ./slack.socket.patch.json5 --dry-runopenclaw config patch --file ./slack.socket.patch.json5

SLACK_APP_TOKEN=slack-app-token-exampleSLACK_BOT_TOKEN=slack-bot-token-example

openclaw gateway

{"display_information": {"name": "OpenClaw","description": "Slack-connector voor OpenClaw"},"features": {"bot_user": { "display_name": "OpenClaw", "always_online": true },"app_home": {"home_tab_enabled": true,"messages_tab_enabled": true,"messages_tab_read_only_enabled": false},"agent_view": {"agent_description": "OpenClaw koppelt Slack Agent View-gesprekken aan OpenClaw-agents.","suggested_prompts": [{ "title": "Wat kun je doen?", "message": "Waarmee kun je me helpen?" },{"title": "Dit kanaal samenvatten","message": "Vat de recente activiteit in dit kanaal samen."},{ "title": "Een antwoord opstellen", "message": "Help me een antwoord op te stellen." }]},"slash_commands": [{"command": "/openclaw","description": "Een bericht naar OpenClaw sturen","should_escape": false,"url": "https://gateway-host.example.com/slack/events"}]},"oauth_config": {"scopes": {"bot": ["app_mentions:read","assistant:write","channels:history","channels:read","chat:write","commands","emoji:read","files:read","files:write","groups:history","groups:read","im:history","im:read","im:write","mpim:history","mpim:read","mpim:write","pins:read","pins:write","reactions:read","reactions:write","usergroups:read","users:read"]}},"settings": {"event_subscriptions": {"request_url": "https://gateway-host.example.com/slack/events","bot_events": ["app_home_opened","app_mention","app_context_changed","channel_rename","member_joined_channel","member_left_channel","message.channels","message.groups","message.im","message.mpim","pin_added","pin_removed","reaction_added","reaction_removed"]},"interactivity": {"is_enabled": true,"request_url": "https://gateway-host.example.com/slack/events","message_menu_options_url": "https://gateway-host.example.com/slack/events"}}}

{"display_information": {"name": "OpenClaw","description": "Slack-connector voor OpenClaw"},"features": {"bot_user": { "display_name": "OpenClaw", "always_online": true },"app_home": {"home_tab_enabled": true,"messages_tab_enabled": true,"messages_tab_read_only_enabled": false},"agent_view": {"agent_description": "OpenClaw verbindt gesprekken in Slack Agent View met OpenClaw-agents.","suggested_prompts": [{ "title": "Wat kun je doen?", "message": "Waarmee kun je me helpen?" },{"title": "Dit kanaal samenvatten","message": "Vat de recente activiteit in dit kanaal samen."},{ "title": "Een antwoord opstellen", "message": "Help me een antwoord op te stellen." }]},"slash_commands": [{"command": "/openclaw","description": "Een bericht naar OpenClaw sturen","should_escape": false,"url": "https://gateway-host.example.com/slack/events"}]},"oauth_config": {"scopes": {"bot": ["app_mentions:read","assistant:write","channels:history","channels:read","chat:write","commands","groups:history","groups:read","im:history","im:read","im:write","users:read"]}},"settings": {"event_subscriptions": {"request_url": "https://gateway-host.example.com/slack/events","bot_events": ["app_home_opened","app_mention","app_context_changed","message.channels","message.groups","message.im"]},"interactivity": {"is_enabled": true,"request_url": "https://gateway-host.example.com/slack/events","message_menu_options_url": "https://gateway-host.example.com/slack/events"}}}

export SLACK_BOT_TOKEN=slack-bot-token-exampleexport SLACK_SIGNING_SECRET=...cat > slack.http.patch.json5 <<'JSON5'{channels: {slack: {enabled: true,mode: "http",botToken: { source: "env", provider: "default", id: "SLACK_BOT_TOKEN" },signingSecret: { source: "env", provider: "default", id: "SLACK_SIGNING_SECRET" },webhookPath: "/slack/events",},},}JSON5openclaw config patch --file ./slack.http.patch.json5 --dry-runopenclaw config patch --file ./slack.http.patch.json5

openclaw gateway

Gebruikersidentiteit (plaatsen als een echte persoon)

Met een gebruikersidentiteit kan OpenClaw lezen en berichten plaatsen als de persoon die de Slack-app autoriseert. De userToken is de handelende identiteit; een bijbehorende Slack-app verwerkt verkeer van de Events API via Socket Mode of een HTTP Request URL. De bijbehorende app heeft geen botgebruiker of bottoken nodig.

Stel de bijbehorende app als volgt in:

1. Voeg onder OAuth & Permissions -> User Token Scopes deze machtigingen met gebruikersscope toe:

   • geschiedenis: channels:history, groups:history, im:history, mpim:history
   • gesprekken opzoeken: channels:read, groups:read, im:read, mpim:read
   • personen: users:read
   • berichten plaatsen: chat:write (berichten worden geplaatst als de autoriserende gebruiker)
   • DM's openen: im:write, mpim:write

2. Voeg onder Event Subscriptions -> Subscribe to events on behalf of users deze gebruikersgebeurtenissen toe. Voeg ze niet alleen toe aan de lijst met botgebeurtenissen:

   • message.channels
   • message.groups
   • message.im
   • message.mpim

3. Kies één gebeurtenistransport:

   • Socket Mode: schakel Socket Mode in en maak een token op appniveau met connections:write. Configureer dit als appToken.
   • HTTP Request URL: laat Event Subscriptions verwijzen naar het openbare Slack-eindpunt van OpenClaw en kopieer Basic Information -> App Credentials -> Signing Secret. Configureer dit als signingSecret.

4. Installeer de app of installeer deze opnieuw, autoriseer deze als de beoogde persoon en kopieer het resulterende OAuth-gebruikerstoken naar userToken.

Configuratie voor Socket Mode:

{  channels: {    slack: {      identity: "user",      userToken: "<xoxp>",      appToken: "<xapp>",    },  },}

Configuratie voor HTTP Request URL:

{  channels: {    slack: {      identity: "user",      mode: "http",      userToken: "<xoxp>",      signingSecret: "<signing-secret>",      webhookPath: "/slack/events",    },  },}

OpenClaw negeert automatisch berichtgebeurtenissen met gebruikersscope die door de herkende menselijke identiteit zijn gemaakt, zodat verzonden berichten geen antwoorden aan zichzelf activeren.

Transportafstemming voor Socket Mode

OpenClaw stelt voor Socket Mode de pong-time-out van de Slack SDK-client standaard in op 15 seconden. Pas de transportinstellingen alleen aan wanneer werkruimte- of hostspecifieke afstemming nodig is:

{  channels: {    slack: {      mode: "socket",      socketMode: {        clientPingTimeout: 20000,        serverPingTimeout: 30000,        pingPongLoggingEnabled: false,      },    },  },}

Gebruik dit alleen voor Socket Mode-werkruimten die time-outs voor websocket-pongs/serverpings van Slack registreren of die draaien op hosts met bekende uithongering van de eventloop. clientPingTimeout is de wachttijd voor een pong nadat de SDK een clientping heeft verzonden; serverPingTimeout is de wachttijd voor serverpings van Slack. Appberichten en gebeurtenissen blijven applicatiestatus, geen signalen voor de beschikbaarheid van het transport.

Opmerkingen:

• socketMode wordt genegeerd in de HTTP Request URL-modus.
• Basisinstellingen voor channels.slack.socketMode gelden voor alle Slack-accounts, tenzij ze worden overschreven. Overschrijvingen per account gebruiken channels.slack.accounts.<accountId>.socketMode; omdat dit een objectoverschrijving is, moet je elk veld voor socketafstemming opnemen dat je voor dat account wilt gebruiken.
• Alleen clientPingTimeout heeft een OpenClaw-standaardwaarde (15000). serverPingTimeout en pingPongLoggingEnabled worden alleen aan de Slack SDK doorgegeven wanneer ze zijn geconfigureerd.
• De wachttijd voor het opnieuw starten van Socket Mode begint rond 2 seconden en loopt op tot maximaal ongeveer 30 seconden. Herstelbare fouten bij het starten, wachten op het starten en verbreken van de verbinding worden opnieuw geprobeerd totdat het kanaal stopt. Permanente account- en referentiefouten, zoals ongeldige authenticatie, ingetrokken tokens of ontbrekende scopes, mislukken direct in plaats van eindeloos opnieuw te worden geprobeerd.

Checklist voor manifest en scopes

Het basismanifest van de Slack-app is hetzelfde voor Socket Mode en HTTP Request URL's. Alleen het blok settings (en url van de slash-opdracht) verschilt.

Basismanifest (standaard voor Socket Mode):

{  "display_information": {    "name": "OpenClaw",    "description": "Slack-connector voor OpenClaw"  },  "features": {    "bot_user": { "display_name": "OpenClaw", "always_online": true },    "app_home": {      "home_tab_enabled": true,      "messages_tab_enabled": true,      "messages_tab_read_only_enabled": false    },    "agent_view": {      "agent_description": "OpenClaw verbindt gesprekken in Slack Agent View met OpenClaw-agents.",      "suggested_prompts": [        { "title": "Wat kun je doen?", "message": "Waarmee kun je me helpen?" },        {          "title": "Dit kanaal samenvatten",          "message": "Vat de recente activiteit in dit kanaal samen."        },        { "title": "Een antwoord opstellen", "message": "Help me een antwoord op te stellen." }      ]    },    "slash_commands": [      {        "command": "/openclaw",        "description": "Een bericht naar OpenClaw sturen",        "should_escape": false      }    ]  },  "oauth_config": {    "scopes": {      "bot": [        "app_mentions:read",        "assistant:write",        "channels:history",        "channels:read",        "chat:write",        "commands",        "emoji:read",        "files:read",        "files:write",        "groups:history",        "groups:read",        "im:history",        "im:read",        "im:write",        "mpim:history",        "mpim:read",        "mpim:write",        "pins:read",        "pins:write",        "reactions:read",        "reactions:write",        "usergroups:read",        "users:read"      ]    }  },  "settings": {    "socket_mode_enabled": true,    "event_subscriptions": {      "bot_events": [        "app_home_opened",        "app_mention",        "app_context_changed",        "channel_rename",        "member_joined_channel",        "member_left_channel",        "message.channels",        "message.groups",        "message.im",        "message.mpim",        "pin_added",        "pin_removed",        "reaction_added",        "reaction_removed"      ]    }  }}

Vervang voor de HTTP Request URL-modus settings door de HTTP-variant en voeg url toe aan elke slash-opdracht. Openbare URL vereist:

{  "features": {    "slash_commands": [      {        "command": "/openclaw",        "description": "Een bericht naar OpenClaw sturen",        "should_escape": false,        "url": "https://gateway-host.example.com/slack/events"      }    ]  },  "settings": {    "event_subscriptions": {      "request_url": "https://gateway-host.example.com/slack/events",      "bot_events": [        "app_home_opened",        "app_mention",        "app_context_changed",        "channel_rename",        "member_joined_channel",        "member_left_channel",        "message.channels",        "message.groups",        "message.im",        "message.mpim",        "pin_added",        "pin_removed",        "reaction_added",        "reaction_removed"      ]    },    "interactivity": {      "is_enabled": true,      "request_url": "https://gateway-host.example.com/slack/events",      "message_menu_options_url": "https://gateway-host.example.com/slack/events"    }  }}

Aanvullende manifestinstellingen

Maak verschillende functies beschikbaar die de bovenstaande standaardinstellingen uitbreiden.

Het standaardmanifest schakelt het tabblad Home van Slack App Home in en abonneert zich op app_home_opened. Wanneer een werkruimtelid het tabblad Home opent, publiceert OpenClaw een veilige standaardweergave voor Home met views.publish; er worden geen gespreksgegevens of privéconfiguratie opgenomen. Wanneer de modus met één slash-opdracht is ingeschakeld, gebruikt de opdrachthint channels.slack.slashCommand.name; installaties die native opdrachten of geen slash-opdrachten gebruiken, laten die hint weg. Het tabblad Messages blijft ingeschakeld voor Slack-DM's. Nieuwe apps gebruiken Slack Agent View via features.agent_view, assistant:write en app_context_changed. Elke zichtbare hoofdweergave van Agent View wordt naar een eigen OpenClaw-threadsessie gerouteerd en de geordende actieve-weergave-entiteiten van Slack bereiken de agent uitsluitend als niet-vertrouwde context.

Bestaande apps die features.assistant_view al gebruiken, kunnen hun huidige manifest behouden. OpenClaw blijft assistant_thread_started en assistant_thread_context_changed voor die installaties afhandelen. Slack maakt de migratie van Assistant View naar Agent View onomkeerbaar en vereist dat gebruikers daarna een harde vernieuwing uitvoeren. Vervang assistant_view daarom pas in een bestaande app wanneer je de volledige werkruimte wilt migreren.

{"slash_commands": [{"command": "/new","description": "Een nieuwe sessie starten","usage_hint": "[model]"},{"command": "/reset","description": "De huidige sessie opnieuw instellen"},{"command": "/compact","description": "De sessiecontext comprimeren","usage_hint": "[instructions]"},{"command": "/stop","description": "De huidige uitvoering stoppen"},{"command": "/session","description": "De vervaltijd van de threadkoppeling beheren","usage_hint": "inactief <duration|off> of maximale leeftijd <duration|off>"},{"command": "/think","description": "Het denkniveau instellen","usage_hint": "<level>"},{"command": "/verbose","description": "Uitgebreide uitvoer in- of uitschakelen","usage_hint": "on|off|full"},{"command": "/fast","description": "Snelle modus weergeven of instellen","usage_hint": "[status|on|off]"},{"command": "/reasoning","description": "Zichtbaarheid van redeneringen in- of uitschakelen","usage_hint": "[on|off|stream]"},{"command": "/elevated","description": "Verhoogde modus in- of uitschakelen","usage_hint": "[on|off|ask|full]"},{"command": "/exec","description": "Standaardwaarden voor uitvoering weergeven of instellen","usage_hint": "host=<auto|sandbox|gateway|node> security=<deny|allowlist|full> ask=<off|on-miss|always> node=<id>"},{"command": "/approve","description": "Openstaande goedkeuringsverzoeken goedkeuren of weigeren","usage_hint": "<id> <decision>"},{"command": "/model","description": "Het model weergeven of instellen","usage_hint": "[name|#|status]"},{"command": "/models","description": "Providers/modellen weergeven","usage_hint": "[provider] [page] [limit=<n>|size=<n>|all]"},{"command": "/help","description": "De korte helpsamenvatting weergeven"},{"command": "/commands","description": "De gegenereerde opdrachtencatalogus weergeven"},{"command": "/tools","description": "Weergeven wat de huidige agent nu kan gebruiken","usage_hint": "[compact|verbose]"},{"command": "/agentstatus","description": "Runtimestatus weergeven, inclusief providergebruik/quotum indien beschikbaar"},{"command": "/tasks","description": "Actieve/recente achtergrondtaken voor de huidige sessie weergeven"},{"command": "/context","description": "Uitleggen hoe de context wordt samengesteld","usage_hint": "[list|detail|json]"},{"command": "/whoami","description": "Je afzenderidentiteit weergeven"},{"command": "/skill","description": "Een skill op naam uitvoeren","usage_hint": "<name> [input]"},{"command": "/btw","description": "Een zijvraag stellen zonder de sessiecontext te wijzigen","usage_hint": "<question>"},{"command": "/login","description": "Codex-aanmelding koppelen","usage_hint": "[codex|openai]"},{"command": "/usage","description": "De gebruiksvoettekst beheren of het kostenoverzicht weergeven","usage_hint": "off|tokens|full|cost"}]}

{"slash_commands": [{"command": "/new","description": "Een nieuwe sessie starten","usage_hint": "[model]","url": "https://gateway-host.example.com/slack/events"},{"command": "/help","description": "De korte helpsamenvatting weergeven","url": "https://gateway-host.example.com/slack/events"}]}

Tokenmodel

• Botidentiteit (standaard) vereist botToken + appToken voor Socket Mode, of botToken + signingSecret voor HTTP-modus.
• Gebruikersidentiteit vereist userToken + appToken voor Socket Mode, of userToken + signingSecret voor HTTP-modus. Hierbij wordt geen bottoken gebruikt.
• Relaymodus vereist botToken plus relay.url, relay.authToken en relay.gatewayId; hierbij wordt geen apptoken of ondertekeningsgeheim gebruikt.
• botToken, appToken, signingSecret, relay.authToken en userToken accepteren tekenreeksen met platte tekst of SecretRef-objecten.
• Tokens in de configuratie overschrijven de terugval op omgevingsvariabelen.
• De terugval via de omgevingsvariabelen SLACK_BOT_TOKEN, SLACK_APP_TOKEN en SLACK_USER_TOKEN geldt telkens alleen voor het standaardaccount.
• userToken gebruikt standaard alleen-lezen gedrag (userTokenReadOnly: true).

Gedrag van de statusmomentopname:

• Slack-accountinspectie houdt per aanmeldgegeven de velden *Source en *Status bij (botToken, appToken, signingSecret, userToken).
• De status is available, configured_unavailable of missing.
• configured_unavailable betekent dat het account via SecretRef of een andere niet-inline bron voor geheimen is geconfigureerd, maar dat het huidige opdracht-/runtimepad de daadwerkelijke waarde niet kon omzetten.
• In HTTP-modus wordt signingSecretStatus opgenomen. Socket Mode gebruikt botTokenStatus + appTokenStatus voor botidentiteit en userTokenStatus + appTokenStatus voor gebruikersidentiteit.

Acties en poorten

Slack-acties worden beheerd door channels.slack.actions.*.

Beschikbare actiegroepen in de huidige Slack-tooling:

De huidige Slack-berichtacties omvatten send, upload-file, download-file, read, edit, delete, pin, unpin, list-pins, member-info en emoji-list. download-file accepteert Slack-bestands-ID's die in tijdelijke aanduidingen voor inkomende bestanden worden weergegeven en retourneert afbeeldingsvoorbeelden voor afbeeldingen of lokale bestandsmetadata voor andere bestandstypen.

Toegangsbeheer en routering

Threads, sessies en antwoordtags

• Privéberichten worden gerouteerd als direct; kanalen als channel; MPIM's als group.
• Slack-routekoppelingen accepteren onbewerkte peer-ID's plus Slack-doelvormen zoals channel:C12345678, user:U12345678 en <@U12345678>.
• Met de standaardwaarde session.dmScope=main worden gewone Slack-privéberichten samengevoegd in de hoofdsessie van de agent. Hoofdelementen van Agent View en bestaande threads van Assistant View blijven geïsoleerd als :thread:<threadTs>-sessies.
• Kanaalsessies: agent:<agentId>:slack:channel:<channelId>.
• Gewone kanaalberichten op het hoogste niveau blijven in de sessie per kanaal, zelfs wanneer replyToMode niet off is.
• Antwoorden in threads van Slack-kanalen, MPIM's, Agent View en Assistant View gebruiken de bovenliggende Slack-thread_ts voor sessieachtervoegsels (:thread:<threadTs>). Gewone antwoordthreads in privéberichten blijven een UI-voorziening binnen de basisprivéberichtsessie.
• OpenClaw voegt een geschikt kanaalhoofdelement op het hoogste niveau toe aan agent:<agentId>:slack:channel:<channelId>:thread:<rootTs> wanneer wordt verwacht dat dit hoofdelement een zichtbare Slack-thread start, zodat het hoofdelement en latere antwoorden in de thread één OpenClaw-sessie delen. Dit geldt voor app_mention-gebeurtenissen, expliciete botvermeldingen of overeenkomsten met geconfigureerde vermeldingspatronen, en requireMention: false-kanalen met een niet-off replyToMode.
• De standaardwaarde van channels.slack.thread.historyScope is thread; de standaardwaarde van thread.inheritParent is false.
• channels.slack.thread.initialHistoryLimit bepaalt hoeveel bestaande threadberichten worden opgehaald wanneer een nieuwe threadsessie begint (standaard 20; stel in op 0 om uit te schakelen).
• channels.slack.implicitMentions.replyToBot bepaalt of een antwoord op het eigen bericht van de bot de vereiste vermelding omzeilt (standaard true).
• channels.slack.implicitMentions.threadParticipation bepaalt of vervolgberichten in een thread waarin de bot heeft geantwoord de vereiste vermelding omzeilen (standaard true). Stel dit in op false om in die vervolgberichten een nieuwe expliciete vermelding te vereisen. openclaw doctor --fix migreert de voormalige sleutel channels.slack.thread.requireExplicitMention naar deze positieve canonieke vlag.
• Accountoverschrijvingen staan onder channels.slack.accounts.<id>.implicitMentions; gedeelde standaardwaarden staan onder channels.defaults.implicitMentions.

Instellingen voor antwoordthreads:

• channels.slack.channels.<id>.replyToMode: overschrijving per kanaal voor berichten in Slack-kanalen/privékanalen
• channels.slack.replyToMode: off|first|all|batched (standaard off)
• channels.slack.replyToModeByChatType: per direct|group|channel
• verouderde terugvaloptie voor directe chats: channels.slack.dm.replyToMode

Handmatige antwoordtags worden ondersteund:

• [[reply_to_current]]
• [[reply_to:<id>]]

Stel voor expliciete Slack-threadantwoorden vanuit het hulpprogramma message replyBroadcast: true in met action: "send" en threadId of replyTo om Slack te vragen het threadantwoord ook naar het bovenliggende kanaal te verspreiden. Dit wordt gekoppeld aan Slacks chat.postMessage-vlag reply_broadcast en wordt alleen ondersteund voor verzendingen met tekst of Block Kit, niet voor media-uploads.

Wanneer een aanroep van het hulpprogramma message binnen een Slack-thread wordt uitgevoerd en op hetzelfde kanaal is gericht, neemt OpenClaw normaal gesproken de huidige Slack-thread over volgens de effectieve replyToMode voor het account, chattype of kanaal. Automatische antwoorden en aanroepen van send of upload-file binnen hetzelfde kanaal gebruiken dezelfde overschrijving per kanaal. Stel topLevel: true in op action: "send" of action: "upload-file" om in plaats daarvan een nieuw bericht in het bovenliggende kanaal af te dwingen. threadId: null wordt geaccepteerd als dezelfde afmelding op het hoogste niveau.

Bevestigingsreacties

ackReaction verzendt een bevestigingsemoji terwijl OpenClaw een binnenkomend bericht verwerkt. ackReactionScope bepaalt wanneer die emoji daadwerkelijk wordt verzonden.

Standaard blijft de bevestiging statisch terwijl de ingebouwde threadstatus van de Slack-agent/-assistent de voortgang toont met wisselende laadberichten. Stel messages.statusReactions.enabled: true in om in plaats daarvan de reactielevenscyclus in wachtrij/nadenken/hulpprogramma/voltooid/fout te gebruiken.

Emoji (ackReaction)

Volgorde van omzetting:

• channels.slack.accounts.<accountId>.ackReaction
• channels.slack.ackReaction
• messages.ackReaction
• terugvalemoji voor de agentidentiteit (agents.entries.*.identity.emoji, anders "eyes" / 👀)

Opmerkingen:

• Slack verwacht shortcodes (bijvoorbeeld "eyes").
• Gebruik "" om de reactie voor het Slack-account of globaal uit te schakelen.

Bereik (messages.ackReactionScope)

De Slack-provider leest het bereik uit messages.ackReactionScope (standaard "group-mentions"). Momenteel bestaat er geen overschrijving op Slack-account- of Slack-kanaalniveau; de waarde geldt globaal voor de Gateway.

Waarden:

• "all": reageer in privéberichten en groepen, inclusief omgevingsgebeurtenissen in ruimtes.
• "direct": reageer alleen in privéberichten.
• "group-all": reageer op elk groepsbericht behalve omgevingsgebeurtenissen in ruimtes (geen privéberichten).
• "group-mentions" (standaard): reageer in groepen, maar alleen wanneer de bot wordt vermeld (of in groepsvermeldingen waarvoor deelname is ingeschakeld). Privéberichten zijn uitgesloten.
• "off" / "none": reageer nooit.

{  messages: {    ackReaction: "eyes",    ackReactionScope: "all", // reageer in privéberichten en groepen  },}

Tekststreaming

channels.slack.streaming bepaalt het gedrag van livevoorbeelden:

• off: schakel het streamen van livevoorbeelden uit.
• partial (standaard): vervang de voorbeeldtekst door de nieuwste gedeeltelijke uitvoer.
• block: voeg voorbeeldupdates in delen toe.
• progress: toon voortgangsstatustekst tijdens het genereren en verzend daarna de definitieve tekst.
• streaming.preview.toolProgress: wanneer een conceptvoorbeeld actief is, worden updates van hulpprogramma's en voortgang naar hetzelfde bewerkte voorbeeldbericht gerouteerd (standaard: true). Stel false in om afzonderlijke berichten voor hulpprogramma's en voortgang te behouden.
• streaming.preview.commandText / streaming.progress.commandText: stel in op status om compacte voortgangsregels voor hulpprogramma's te behouden en onbewerkte opdracht-/uitvoeringstekst te verbergen (standaard: raw).

Verberg onbewerkte opdracht-/uitvoeringstekst en behoud compacte voortgangsregels:

{  "channels": {    "slack": {      "streaming": {        "mode": "progress",        "progress": {          "toolProgress": true,          "commandText": "status"        }      }    }  }}

channels.slack.streaming.nativeTransport bepaalt het ingebouwde streamen van tekst in Slack wanneer channels.slack.streaming.mode partial is (standaard: true).

Ingebouwde Slack-taakkaarten voor voortgang moeten expliciet worden ingeschakeld voor de voortgangsmodus. Stel channels.slack.streaming.progress.nativeTaskCards in op true met channels.slack.streaming.mode="progress" om tijdens het werk een ingebouwde plan-/taakkaart van Slack te verzenden en dezelfde taakkaart na voltooiing bij te werken. Zonder deze vlag behoudt de voortgangsmodus het overdraagbare gedrag voor conceptvoorbeelden.

• Er moet een antwoordthread beschikbaar zijn om native tekststreaming en de Slack-assistentthreadstatus weer te geven. De threadselectie volgt nog steeds replyToMode.
• Kanalen, groepschats en DM-hoofdberichten kunnen nog steeds het normale conceptvoorbeeld gebruiken wanneer native streaming niet beschikbaar is of er geen antwoordthread bestaat.
• Slack-DM's op hoofdniveau blijven standaard buiten een thread, zodat ze Slacks threadachtige native streaming-/statusvoorbeeld niet weergeven; in plaats daarvan plaatst en bewerkt OpenClaw een conceptvoorbeeld in de DM.
• Media en niet-tekstuele payloads vallen terug op normale aflevering.
• Definitieve media-/foutpayloads annuleren wachtende voorbeeldbewerkingen; geschikte definitieve tekst-/blokpayloads worden alleen verzonden wanneer ze het voorbeeld ter plaatse kunnen bewerken.
• Als streaming halverwege een antwoord mislukt, valt OpenClaw voor de resterende payloads terug op normale aflevering.

Gebruik een conceptvoorbeeld in plaats van native tekststreaming van Slack:

{  channels: {    slack: {      streaming: {        mode: "partial",        nativeTransport: false,      },    },  },}

Schakel native Slack-taakkaarten voor voortgang in:

{  channels: {    slack: {      streaming: {        mode: "progress",        progress: {          nativeTaskCards: true,          render: "rich",        },      },    },  },}

Verouderde sleutels:

• channels.slack.streamMode (replace | status_final | append) is een verouderde alias voor channels.slack.streaming.mode.
• boolean channels.slack.streaming is een verouderde alias voor channels.slack.streaming.mode en channels.slack.streaming.nativeTransport.
• channels.slack.chunkMode en channels.slack.nativeStreaming op hoofdniveau zijn verouderde aliassen voor channels.slack.streaming.chunkMode en channels.slack.streaming.nativeTransport.
• Verouderde aliassen worden tijdens runtime niet gelezen; voer openclaw doctor --fix uit om de opgeslagen Slack-streamingconfiguratie te herschrijven naar de canonieke sleutels.

Terugvalreactie voor typen

typingReaction voegt tijdelijk een reactie toe aan het binnenkomende Slack-bericht terwijl OpenClaw een antwoord verwerkt en verwijdert deze wanneer de uitvoering is voltooid. Dit is vooral nuttig buiten antwoorden in threads, die standaard de statusindicator "is aan het typen..." gebruiken.

Volgorde van omzetting:

• channels.slack.accounts.<accountId>.typingReaction
• channels.slack.typingReaction

Opmerkingen:

• Slack verwacht shortcodes (bijvoorbeeld "hourglass_flowing_sand").
• De reactie is op basis van beste inspanning en er wordt automatisch geprobeerd deze op te ruimen nadat het antwoord- of foutpad is voltooid.

Spraakinvoer

Als je OpenClaw momenteel in Slack met spraak wilt gebruiken, stuur je een Slack-audiofragment naar de OpenClaw-app. De dicteermicrofoon van Slackbot is een afzonderlijke functie van Slack en geen app-API.

• Spraakdicteren met Slackbot vindt plaats in het privégesprek van de gebruiker met Slackbot. Slack zet de opname om in een Slackbot-prompt, maar verstuurt via de Events API geen audiobestand, dicteergebeurtenis, prompt of invoerbronmarkering naar Slack-apps van derden. De OpenClaw-Plugin voor Slack kan deze functie niet inschakelen of ontvangen.
• Slack-audiofragmenten zijn opgeslagen Slack-bestanden die in een OpenClaw-DM, kanaal of thread kunnen worden geplaatst. OpenClaw downloadt een toegankelijk fragment met het bottoken, normaliseert Slacks MIME-metadata voor fragmenten en stuurt het door de gedeelde pijplijn voor audiotranscriptie. Het aanbevolen app-manifest bevat het vereiste bereik files:read.

Audiofragmenten en Slackbot-dicteren hebben verschillende privacykenmerken: fragmenten vallen onder Slacks bewaarbeleid voor bestanden en OpenClaw downloadt ze voor transcriptie, terwijl Slack aangeeft dat dicteeraudio niet wordt opgeslagen.

In een kanaal met requireMention: true kan een audiofragment zonder bijschrift aan de voorwaarde voldoen door een geconfigureerd vermeldingspatroon uit te spreken (agents.entries.*.groupChat.mentionPatterns, met terugval op messages.groupChat.mentionPatterns). OpenClaw autoriseert de afzender voordat het fragment wordt gedownload of getranscribeerd en laat het vervolgens alleen toe wanneer het transcript overeenkomt. Een mislukt of niet-overeenkomend voorlopig transcript wordt samen met het gedownloade fragment verwijderd; het wordt niet bewaard in de kanaalgeschiedenis. De native Slack-identiteit @bot kan niet uit spraak worden afgeleid, dus configureer een patroon voor een gesproken naam of voeg een getypte vermelding toe. Als het terugsturen van het transcript is ingeschakeld, wordt dit pas na toelating verzonden.

Media, opsplitsing en aflevering

Opdrachten en slashgedrag

Slashopdrachten verschijnen in Slack als één geconfigureerde opdracht of als meerdere native opdrachten. Configureer channels.slack.slashCommand om de standaardwaarden voor opdrachten te wijzigen:

• enabled: false
• name: "openclaw"
• sessionPrefix: "slack:slash"
• ephemeral: true

/openclaw /help

Voor native opdrachten zijn aanvullende manifestinstellingen in je Slack-app vereist. Ze worden ingeschakeld met channels.slack.commands.native: true of commands.native: true in algemene configuraties.

• De automatische modus voor native opdrachten staat voor Slack uit, zodat commands.native: "auto" native Slack-opdrachten niet inschakelt.

/help

Menu's met native argumenten worden in de volgende prioriteitsvolgorde weergegeven:

• 3-5 opties die kort genoeg zijn: een overloopmenu ("...")
• meer dan 100 opties, wanneer asynchrone filtering van opties beschikbaar is: externe selectie
• 1-2 opties, of een optie waarvan de gecodeerde waarde te lang is voor een selectie: knopblokken
• anders (6-100 opties, of meer dan 100 zonder asynchrone filtering): statisch selectiemenu, opgesplitst in 100 opties per menu

/think

Slashsessies gebruiken geïsoleerde sleutels zoals agent:<agentId>:slack:slash:<userId> en leiden de uitvoering van opdrachten nog steeds met CommandTargetSessionKey naar de sessie van het doelgesprek.

Native grafieken

Slacks openbare data_visualization Block Kit-blok geeft lijn-, staaf-, vlak- en cirkeldiagrammen weer in berichten. OpenClaw zet het overdraagbare presentation chart-blok om naar die native vorm; buiten de normale chat:write-berichttoegang zijn geen aanvullend OAuth-bereik, bestandsupload, afbeeldingsrenderer of Slack-configuratie vereist.

{  "blocks": [    {      "type": "chart",      "chartType": "bar",      "title": "Kwartaalomzet",      "categories": ["Q1", "Q2"],      "series": [{ "name": "Omzet", "values": [120, 145] }],      "xLabel": "Kwartaal"    }  ]}

Slacks limieten worden vóór native weergave afgedwongen:

• titel en optionele aslabels: 50 tekens
• cirkel: 1-12 positieve segmenten
• lijn/staaf/vlak: 1-12 reeksen met unieke namen en 1-20 gedeelde categorieën
• labels voor segmenten, categorieën en reeksen: 20 tekens
• elke reeks moet voor elke categorie één eindige waarde bevatten; niet-cirkelwaarden mogen negatief zijn

Elke native grafiek bevat ook een tekstuele weergave op hoofdniveau voor schermlezers, meldingen, sessiespiegeling en clients die het blok niet kunnen weergeven. Standaardpresentaties die naar andere OpenClaw-kanalen worden verzonden, ontvangen dezelfde deterministische grafiekgegevens als tekst, tenzij ze ondersteuning voor native grafieken aangeven. Als Slack tijdens een gefaseerde uitrol de grafiek afwijst met invalid_blocks, verwijdert OpenClaw de afgewezen native gegevensblokken, behoudt het eventuele aangrenzende bedieningselementen en verzendt het de volledige grafiekweergave als zichtbare tekst.

Slack accepteert momenteel maximaal twee data_visualization-blokken per bericht. Wanneer een presentatie meer dan twee geldige grafieken bevat, behoudt OpenClaw hun volgorde en gaat de native weergave verder in vervolgberichten, met maximaal twee grafieken in elk bericht.

Slacks lancering voor ontwikkelaars beschrijft het blok als een appgerichte Block Kit-functie en vermeldt geen beperking tot betaalde abonnementen. De tekst over beschikbaarheid voor Business+/Enterprise is van toepassing op Slakbots automatische AI-grafiekgeneratie, die losstaat van een app die een reeds gestructureerde Block Kit-grafiek verzendt. Grafieken zijn uitsluitend berichtblokken, geen inhoud voor App Home, modals of Canvas.

Native tabellen

Slacks huidige data_table Block Kit-blok geeft gestructureerde rijen en kolommen weer in berichten. OpenClaw zet een expliciet overdraagbaar presentation table-blok om naar data_table; het gebruikt niet Slacks verouderde table-blok. Buiten de normale chat:write-berichttoegang is geen aanvullend OAuth-bereik of Slack-configuratie vereist.

{  "blocks": [    {      "type": "table",      "caption": "Open pijplijn",      "headers": ["Account", "Fase", "ARR"],      "rows": [        ["Acme", "Gewonnen", 125000],        ["Globex", "Beoordeling", 82000]      ],      "rowHeaderColumnIndex": 0    }  ]}

OpenClaw zet koptekst- en tekenreekscellen om naar Slack-raw_text-cellen. Numerieke cellen worden omgezet naar raw_number, waarbij de eindige numerieke waarde behouden blijft voor native sortering en filtering. rowHeaderColumnIndex markeert, indien aanwezig, die op nul gebaseerde kolom als Slack-rijkoppen.

Slacks gepubliceerde data_table-limieten worden vóór native weergave afgedwongen:

• 1-20 kolommen
• 1-100 gegevensrijen, plus de koprij
• hetzelfde aantal cellen in elke rij
• maximaal 10.000 tekens in totaal voor alle tabelcellen in één bericht

Meerdere geldige tabelblokken kunnen native worden weergegeven zolang het bericht binnen de totale tekenlimiet blijft. Een tabel die niet binnen de native grenzen kan worden weergegeven, wordt volledige deterministische tekst in plaats van rijen of cellen te verliezen. Als die tekst langer is dan één Slack-bericht, gebruiken verzendingen en slashantwoorden geordende tekstfragmenten. Tabelbewerkingen mislukken met een expliciete groottefout in plaats van stilzwijgend rijen uit een bestaand bericht af te kappen.

Elke systeemeigen tabel die uit draagbare presentatie wordt gegenereerd, bevat ook een tekstweergave op het hoogste niveau voor schermlezers, meldingen, sessiespiegeling en clients die het blok niet kunnen weergeven. Ruwe diagram- en tabelwaarden blijven letterlijk in de terugvalweergave, zodat celgegevens zoals <@U123> geen Slack-vermelding worden. Als Slack systeemeigen diagram- of tabelblokken weigert met invalid_blocks, verwijdert OpenClaw alle systeemeigen gegevensblokken in één begrensde herstelstap, behoudt het geldige naastliggende blokken zoals knoppen en selecties, en verzendt het volledige zichtbare diagram- en tabeltekst met Slack-opmaak uitgeschakeld. Levering via slash-opdrachten houdt voor de hele opdracht het budget van vijf aanroepen van Slack voor response_url bij. Vóór elke antwoordbatch selecteert OpenClaw een volledig plan dat binnen de resterende aanroepen past, of mislukt het voordat die batch wordt geplaatst.

Alleen expliciete presentation-tabelblokken worden naar systeemeigen tabellen gepromoveerd. Markdown-tabellen met sluistekens blijven geschreven tekst; OpenClaw doet geen aannames over de tabelstructuur of celtypen. Bestaande vertrouwde producenten van systeemeigen Slack-inhoud kunnen ruwe blokken blijven doorgeven via channelData.slack.blocks; OpenClaw leidt terugvaltekst af uit geldige ruwe data_table-cellen, terwijl onjuist gevormde aangepaste blokken mogelijk terugvallen op hun bijschrift of de algemene Block Kit-terugvalweergave. Draagbare uitvoer van agents, de CLI en plugins moet presentation gebruiken.

Interactieve antwoorden

Slack kan door agents gemaakte interactieve antwoordbedieningselementen weergeven, maar deze functie is standaard uitgeschakeld. Geef voor nieuwe uitvoer van agents, de CLI en plugins de voorkeur aan de gedeelde presentation-knoppen of selectieblokken. Ze gebruiken hetzelfde Slack-interactiepad en vallen ook bruikbaar terug op andere kanalen.

Schakel dit globaal in:

{  channels: {    slack: {      capabilities: {        interactiveReplies: true,      },    },  },}

Of schakel dit alleen voor één Slack-account in:

{  channels: {    slack: {      accounts: {        ops: {          capabilities: {            interactiveReplies: true,          },        },      },    },  },}

Als dit is ingeschakeld, kunnen agents nog steeds verouderde, uitsluitend voor Slack bestemde antwoordrichtlijnen uitvoeren:

• [[slack_buttons: Approve:approve, Reject:reject]]
• [[slack_select: Choose a target | Canary:canary, Production:production]]

Deze richtlijnen worden gecompileerd naar Slack Block Kit en sturen klikken of selecties terug via het bestaande gebeurtenispad voor Slack-interacties. Behoud ze voor oude prompts en Slack-specifieke uitwijkmogelijkheden; gebruik gedeelde presentatie voor nieuwe draagbare bedieningselementen.

De API's van de richtlijncompiler zijn ook verouderd voor nieuwe producentcode:

• compileSlackInteractiveReplies(...)
• parseSlackOptionsLine(...)
• isSlackInteractiveRepliesEnabled(...)
• buildSlackInteractiveBlocks(...)

Gebruik presentation-payloads en buildSlackPresentationBlocks(...) voor nieuwe in Slack weergegeven bedieningselementen.

Opmerkingen:

• Dit is verouderde Slack-specifieke UI. Andere kanalen vertalen Slack Block Kit-richtlijnen niet naar hun eigen knopsystemen.
• De interactieve callbackwaarden zijn door OpenClaw gegenereerde ondoorzichtige tokens, geen ruwe door agents gemaakte waarden.
• Als gegenereerde interactieve blokken de limieten van Slack Block Kit zouden overschrijden, valt OpenClaw terug op het oorspronkelijke tekstantwoord in plaats van een ongeldige blokkenpayload te verzenden.

Door plugins beheerde modale inzendingen

Slack-plugins die een interactieve handler registreren, kunnen ook modale view_submission- en view_closed-levenscyclusgebeurtenissen ontvangen voordat OpenClaw de payload comprimeert voor de systeemgebeurtenis die voor de agent zichtbaar is. Gebruik een van deze routeringspatronen bij het openen van een modaal venster in Slack:

• Stel callback_id in op openclaw:<namespace>:<payload>.
• Of behoud een bestaande callback_id en plaats pluginInteractiveData: "<namespace>:<payload>" in de modale private_metadata.

De handler ontvangt ctx.interaction.kind als view_submission of view_closed, genormaliseerde inputs en het volledige ruwe stateValues-object van Slack. Routering uitsluitend op callback-id volstaat om de pluginhandler aan te roepen; neem de bestaande modale private_metadata-routeringsvelden voor gebruiker/sessie op wanneer het modale venster ook een voor de agent zichtbare systeemgebeurtenis moet produceren. De agent ontvangt een compacte, geredigeerde Slack interaction: ...-systeemgebeurtenis. Als de handler systemEvent.summary, systemEvent.reference of systemEvent.data retourneert, worden die velden opgenomen in die compacte gebeurtenis, zodat de agent kan verwijzen naar door plugins beheerde opslag zonder de volledige formulierpayload te zien.

Systeemeigen goedkeuringen in Slack

Slack kan fungeren als systeemeigen goedkeuringsclient met interactieve knoppen en interacties, in plaats van terug te vallen op de web-UI of terminal.

• Uitvoerings- en plugingoedkeuringen kunnen worden weergegeven als systeemeigen Slack-prompts in Block Kit.
• channels.slack.execApprovals.* blijft de configuratie voor inschakeling van de systeemeigen goedkeuringsclient voor uitvoering en routering naar DM/kanaal.
• DM's voor uitvoeringsgoedkeuring gebruiken channels.slack.execApprovals.approvers of commands.ownerAllowFrom.
• Plugingoedkeuringen gebruiken systeemeigen Slack-knoppen wanneer Slack is ingeschakeld als systeemeigen goedkeuringsclient voor de oorspronkelijke sessie, of wanneer approvals.plugin naar de oorspronkelijke Slack-sessie of een Slack-doel routeert.
• DM's voor plugingoedkeuring gebruiken Slack-plugingoedkeurders uit channels.slack.allowFrom, allowFrom voor een benoemd account, of de standaardroute van het account.
• Autorisatie van goedkeurders wordt nog steeds afgedwongen: goedkeurders die alleen uitvoering mogen goedkeuren, kunnen pluginverzoeken niet goedkeuren tenzij ze ook plugingoedkeurders zijn.

Dit gebruikt hetzelfde gedeelde oppervlak voor goedkeuringsknoppen als andere kanalen. Wanneer interactivity is ingeschakeld in de instellingen van je Slack-app, worden goedkeuringsprompts rechtstreeks als Block Kit-knoppen in het gesprek weergegeven. Wanneer die knoppen aanwezig zijn, vormen ze de primaire goedkeurings-UX; OpenClaw mag alleen een handmatige /approve-opdracht opnemen wanneer het gereedschapsresultaat aangeeft dat chatgoedkeuringen niet beschikbaar zijn of handmatige goedkeuring de enige mogelijkheid is.

Configuratiepad:

• channels.slack.execApprovals.enabled
• channels.slack.execApprovals.approvers (optioneel; valt indien mogelijk terug op commands.ownerAllowFrom)
• channels.slack.execApprovals.target (dm | channel | both, standaard: dm)
• agentFilter, sessionFilter

Slack schakelt systeemeigen uitvoeringsgoedkeuringen automatisch in wanneer enabled niet is ingesteld of "auto" is, en ten minste één uitvoeringsgoedkeurder kan worden bepaald. Slack kan via dit systeemeigen-clientpad ook systeemeigen plugingoedkeuringen afhandelen wanneer Slack-plugingoedkeurders kunnen worden bepaald en het verzoek overeenkomt met de systeemeigen-clientfilters. Stel enabled: false in om Slack expliciet uit te schakelen als systeemeigen goedkeuringsclient. Stel enabled: true in om systeemeigen goedkeuringen geforceerd in te schakelen wanneer goedkeurders kunnen worden bepaald. Het uitschakelen van Slack-uitvoeringsgoedkeuringen schakelt de levering van systeemeigen Slack-plugingoedkeuringen die via approvals.plugin is ingeschakeld niet uit; voor de levering van plugingoedkeuringen worden in plaats daarvan Slack-plugingoedkeurders gebruikt.

Standaardgedrag zonder expliciete Slack-configuratie voor uitvoeringsgoedkeuring:

{  commands: {    ownerAllowFrom: ["slack:U12345678"],  },}

Expliciete systeemeigen Slack-configuratie is alleen nodig wanneer je goedkeurders wilt overschrijven, filters wilt toevoegen of levering in de oorspronkelijke chat wilt inschakelen:

{  channels: {    slack: {      execApprovals: {        enabled: true,        approvers: ["U12345678"],        target: "both",      },    },  },}

Gedeeld doorsturen via approvals.exec staat hiervan los. Gebruik dit alleen wanneer prompts voor uitvoeringsgoedkeuring ook naar andere chats of expliciete externe doelen moeten worden gerouteerd. Gedeeld doorsturen via approvals.plugin staat eveneens los hiervan; systeemeigen Slack-levering onderdrukt die terugval alleen wanneer Slack het verzoek om plugingoedkeuring systeemeigen kan afhandelen.

/approve in dezelfde chat werkt ook in Slack-kanalen en DM's die al opdrachten ondersteunen. Zie Uitvoeringsgoedkeuringen voor het volledige model voor het doorsturen van goedkeuringen.

Gebeurtenissen en operationeel gedrag

• Bewerkingen/verwijderingen van berichten worden omgezet in systeemgebeurtenissen.
• Threaduitzendingen (threadantwoorden met "Also send to channel") worden verwerkt als normale gebruikersberichten.
• Gebeurtenissen voor het toevoegen/verwijderen van reacties worden omgezet in systeemgebeurtenissen.
• Gebeurtenissen voor het toetreden/verlaten van leden, het maken/hernoemen van kanalen en het toevoegen/verwijderen van pins worden omgezet in systeemgebeurtenissen.
• Optionele aanwezigheidspeiling kan een waargenomen overgang van away naar active van een menselijke deelnemer omzetten in een gebeurtenis in de meest recent actieve, geschikte Slack-sessie van die deelnemer. Dit is standaard uitgeschakeld.
• channel_id_changed kan kanaalconfiguratiesleutels migreren wanneer configWrites is ingeschakeld.
• Metadata voor kanaalonderwerp/-doel wordt behandeld als niet-vertrouwde context en kan in de routeringscontext worden geïnjecteerd.
• Agent View-app_context-entiteiten worden gevalideerd in de relevantievolgorde van Slack en uitsluitend beschikbaar gesteld als gestructureerde, niet-vertrouwde context; bij een ontbrekende context wordt de beurt gewist in plaats van verouderde entiteiten opnieuw te gebruiken.
• De threadstarter en initiële contextvulling uit de threadgeschiedenis worden, indien van toepassing, gefilterd op basis van geconfigureerde afzenderstoegestane lijsten.
• Blokacties, snelkoppelingen en modale interacties genereren gestructureerde Slack interaction: ...-systeemgebeurtenissen met uitgebreide payloadvelden:
  • blokacties: geselecteerde waarden, labels, kiezerwaarden en workflow_*-metadata
  • globale snelkoppelingen: callback- en actormetadata, gerouteerd naar de directe sessie van de actor
  • berichtsnelkoppelingen: callback, actor, kanaal, thread en context van het geselecteerde bericht
  • modale view_submission- en view_closed-gebeurtenissen met gerouteerde kanaalmetadata en formulierinvoer

Definieer globale of berichtsnelkoppelingen in de configuratie van je Slack-app en gebruik een niet-lege callback-ID. OpenClaw bevestigt overeenkomende snelkoppelingspayloads, past hetzelfde afzenderbeleid voor DM's/kanalen toe als voor andere Slack-interacties en plaatst de opgeschoonde gebeurtenis in de wachtrij voor de gerouteerde agentsessie. Trigger-ID's en antwoord-URL's worden uit de agentcontext geredigeerd.

Aanwezigheidsgebeurtenissen

Slack verstuurt aanwezigheidswijzigingen niet via de Events API of Socket Mode. OpenClaw kan in plaats daarvan users.getPresence peilen voor menselijke deelnemers van wie de berichten de normale Slack-toegangs- en routeringscontroles hebben doorstaan.

{  channels: {    slack: {      presenceEvents: { mode: "auto" },      channels: {        C0123456789: { presenceEvents: { mode: "on" } },        C0987654321: { presenceEvents: { mode: "off" } },      },    },  },}

• off (standaard): geen aanwezigheidstimer of Slack-API-aanroepen.
• auto: bewaak DM's, MPIM's en Slack-threads die in de afgelopen 24 uur actief waren, met maximaal 8 waargenomen menselijke deelnemers. Kanaalsessies op het hoogste niveau zijn uitgesloten.
• on: bewaak dezelfde gesprekken zonder deelnemerslimiet en neem kanaalsessies op het hoogste niveau mee. Gebruik een overschrijving per kanaal om één kanaal af te dwingen of te onderdrukken.

OpenClaw peilt per Slack-account maximaal 45 unieke gebruikers per minuut, initialiseert het eerste resultaat zonder de agent te activeren en activeert de agent alleen bij een waargenomen overgang van away naar active. Per Slack-account en gebruiker geldt een duurzame afkoelperiode van 8 uur, zelfs als die persoon aan meerdere threads deelneemt. De gebeurtenis wordt alleen naar het meest recent actieve, geschikte gesprek van die persoon gerouteerd en instrueert de agent om het geheugen/de wiki en bekende tijdzonecontext te raadplegen voordat deze beslist of één korte begroeting wordt verzonden. De agent mag stil blijven.

Het bottoken heeft users:read nodig, dat al in het aanbevolen manifest is opgenomen. Aanwezigheidsgebeurtenissen zijn niet beschikbaar voor organisatiebrede Enterprise Grid-installaties.

Configuratiereferentie

Primaire referentie: Configuratiereferentie - Slack.

Problemen oplossen

{messages: {groupChat: {  visibleReplies: "automatic",},},}

openclaw channels status --probeopenclaw logs --followopenclaw doctor

openclaw pairing list slack

Naslaginformatie voor bijlagemedia

Slack kan gedownloade media aan de agentbeurt toevoegen wanneer het downloaden van Slack-bestanden slaagt en de groottelimieten dit toestaan. Audioclips kunnen worden getranscribeerd, afbeeldingsbestanden kunnen via het pad voor mediabegrip of rechtstreeks naar een antwoordmodel met beeldondersteuning worden doorgegeven, en andere bestanden blijven beschikbaar als downloadbare bestandscontext.

Ondersteunde mediatypen

Inkomende pijplijn

Wanneer een Slack-bericht met bestandsbijlagen binnenkomt:

1. OpenClaw downloadt het bestand vanaf de privé-URL van Slack met behulp van het bot-token.
2. Na een geslaagde download wordt het bestand naar de mediaopslag geschreven.
3. Paden en inhoudstypen van gedownloade media worden aan de inkomende context toegevoegd.
4. Audioclips worden naar de gedeelde transcriptiepijplijn gerouteerd; model-/hulpmiddelpaden met beeldondersteuning kunnen afbeeldingsbijlagen uit dezelfde context gebruiken.
5. Andere bestanden blijven beschikbaar als bestandsmetadata of mediaverwijzingen voor hulpmiddelen die ze kunnen verwerken.

Overerving van bijlagen uit het hoofdbericht van een thread

Wanneer een bericht binnenkomt in een thread (met een bovenliggend thread_ts):

• Als het antwoord zelf geen directe media bevat en het opgenomen hoofdbericht bestanden bevat, kan Slack de hoofdbestanden laden als context van de threadstarter.
• Hoofdbestanden worden alleen geladen bij het initialiseren van een nieuwe of opnieuw ingestelde threadsessie. Latere antwoorden met alleen tekst hergebruiken de bestaande sessiecontext en koppelen hoofdbestanden niet opnieuw als nieuwe media.
• Directe antwoordbijlagen hebben voorrang op bijlagen van het hoofdbericht.
• Een hoofdbericht dat alleen bestanden en geen tekst bevat, wordt weergegeven met een bijlageplaceholder, zodat de terugvaloptie de bestanden toch kan opnemen.

Verwerking van meerdere bijlagen

Wanneer één Slack-bericht meerdere bestandsbijlagen bevat:

• Elke bijlage wordt afzonderlijk via de mediapijplijn verwerkt.
• Verwijzingen naar gedownloade media worden samengevoegd in de berichtcontext.
• De verwerkingsvolgorde volgt de bestandsvolgorde van Slack in de gebeurtenispayload.
• Een mislukte download van één bijlage blokkeert de andere niet.

Limieten voor grootte, downloaden en modellen

• Groottelimiet: standaard 20 MB per bestand. Configureerbaar via channels.slack.mediaMaxMb.
• Limiet voor audiotranscriptie: de maxBytes van de geselecteerde vermelding tools.media.models[] met audio-ondersteuning is ook van toepassing wanneer het gedownloade bestand naar een transcriptieprovider of CLI wordt verzonden.
• Downloadfouten: bestanden die Slack niet kan leveren, verlopen URL's, ontoegankelijke bestanden, te grote bestanden en HTML-antwoorden voor Slack-authenticatie/-aanmelding worden overgeslagen in plaats van als niet-ondersteunde indelingen te worden gemeld.
• Beeldmodel: voor beeldanalyse wordt het actieve antwoordmodel gebruikt wanneer dit beeld ondersteunt, of het afbeeldingsmodel dat is geconfigureerd bij agents.defaults.imageModel.

Bekende beperkingen

Gerelateerde documentatie

• Pijplijn voor mediabegrip
• Audio- en spraaknotities
• PDF-tool

Gerelateerd