Slack

Productieklaar voor DM's en kanalen via Slack-appintegraties. De standaardmodus is Socket Mode; HTTP Request-URL's worden ook ondersteund. Relay-modus is bedoeld voor beheerde deployments waarbij een vertrouwde router Slack-ingress beheert.

Socket Mode of HTTP Request-URL's kiezen

Beide transports zijn productieklaar en bereiken feature parity voor messaging, slash commands, App Home en interactiviteit. Kies op basis van deploymentvorm, niet op basis van features.

Relay-modus

Relay-modus scheidt Slack-ingress van de OpenClaw-gateway. Een vertrouwde router beheert de enkele Slack Socket Mode-verbinding, kiest een doelgateway en stuurt een getypeerde event door via een geauthenticeerde websocket. De gateway blijft zijn bottoken gebruiken voor uitgaande Slack Web API-aanroepen.

{  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. Behandel het bearer-token en de routeertabel van de router als onderdeel van de Slack-autorisatiegrens: gerouteerde events komen de normale Slack-berichthandler binnen als geautoriseerde activaties. Een door de router geleverde slack_identity in het websocket-hello-frame kan de standaard uitgaande gebruikersnaam en het pictogram instellen; een expliciete identiteit die door de caller wordt geleverd, wint nog steeds. De relay-verbinding maakt opnieuw verbinding met dezelfde begrensde backoff-timing die door Socket Mode wordt gebruikt en wist de door de router geleverde identiteit telkens wanneer de verbinding wordt verbroken.

Installeren

Installeer Slack voordat je het kanaal configureert:

openclaw plugins install @openclaw/slack

plugins install registreert en activeert de Plugin. De Plugin doet nog steeds niets totdat je de Slack-app en kanaalinstellingen hieronder configureert. Zie Plugins voor algemeen Plugin-gedrag en installatieregels.

Snelle configuratie

{"display_information": {"name": "OpenClaw","description": "Slack connector for 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},"assistant_view": {"assistant_description": "OpenClaw connects Slack assistant threads to OpenClaw agents.","suggested_prompts": [{ "title": "What can you do?", "message": "What can you help me with?" },{"title": "Summarize this channel","message": "Summarize the recent activity in this channel."},{ "title": "Draft a reply", "message": "Help me draft a reply." }]},"slash_commands": [{"command": "/openclaw","description": "Send a message to OpenClaw","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","assistant_thread_context_changed","assistant_thread_started","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 for 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},"assistant_view": {"assistant_description": "OpenClaw connects Slack assistant threads to OpenClaw agents.","suggested_prompts": [{ "title": "What can you do?", "message": "What can you help me with?" },{"title": "Summarize this channel","message": "Summarize the recent activity in this channel."},{ "title": "Draft a reply", "message": "Help me draft a reply." }]},"slash_commands": [{"command": "/openclaw","description": "Send a message to OpenClaw","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","assistant_thread_context_changed","assistant_thread_started","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 for 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},"assistant_view": {"assistant_description": "OpenClaw connects Slack assistant threads to OpenClaw agents.","suggested_prompts": [{ "title": "What can you do?", "message": "What can you help me with?" },{"title": "Summarize this channel","message": "Summarize the recent activity in this channel."},{ "title": "Draft a reply", "message": "Help me draft a reply." }]},"slash_commands": [{"command": "/openclaw","description": "Send a message to OpenClaw","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","assistant_thread_context_changed","assistant_thread_started","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 for 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},"assistant_view": {"assistant_description": "OpenClaw connects Slack assistant threads to OpenClaw agents.","suggested_prompts": [{ "title": "What can you do?", "message": "What can you help me with?" },{"title": "Summarize this channel","message": "Summarize the recent activity in this channel."},{ "title": "Draft a reply", "message": "Help me draft a reply." }]},"slash_commands": [{"command": "/openclaw","description": "Send a message to OpenClaw","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","assistant_thread_context_changed","assistant_thread_started","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

Socket Mode-transportafstemming

OpenClaw stelt de pong-time-out van de Slack SDK-client standaard in op 15 seconden voor Socket Mode. Overschrijf de transportinstellingen alleen wanneer je workspace- of hostspecifieke afstemming nodig hebt:

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

Gebruik dit alleen voor Socket Mode-workspaces die Slack websocket pong/server-ping-time-outs loggen of draaien op hosts met bekende event-loop starvation. clientPingTimeout is de wachttijd op pong nadat de SDK een client-ping heeft verzonden; serverPingTimeout is de wachttijd op Slack-serverpings. Appberichten en events blijven applicatiestatus, geen signalen voor transport-liveness.

Opmerkingen:

• socketMode wordt genegeerd in HTTP Request URL-modus.
• Basisinstellingen voor channels.slack.socketMode gelden voor alle Slack-accounts tenzij ze worden overschreven. Overrides per account gebruiken channels.slack.accounts.<accountId>.socketMode; omdat dit een object-override is, moet je elk socketafstemmingsveld opnemen dat je voor dat account wilt.
• Alleen clientPingTimeout heeft een OpenClaw-standaardwaarde (15000). serverPingTimeout en pingPongLoggingEnabled worden alleen aan de Slack SDK doorgegeven wanneer ze zijn geconfigureerd.
• Restart-backoff voor Socket Mode begint rond 2 seconden en wordt begrensd rond 30 seconden. Herstelbare start-, start-wait- en disconnect-fouten proberen opnieuw totdat het kanaal stopt. Permanente account- en referentiefouten zoals ongeldige auth, ingetrokken tokens of ontbrekende scopes falen snel in plaats van eindeloos opnieuw te proberen.

Manifest- en scope-checklist

Het basismanifest voor de Slack-app is hetzelfde voor Socket Mode en HTTP Request URLs. Alleen het blok settings (en de slash command-url) verschilt.

Basemanifest (standaard voor Socket Mode):

{  "display_information": {    "name": "OpenClaw",    "description": "Slack connector for 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    },    "assistant_view": {      "assistant_description": "OpenClaw connects Slack assistant threads to OpenClaw agents.",      "suggested_prompts": [        { "title": "What can you do?", "message": "What can you help me with?" },        {          "title": "Summarize this channel",          "message": "Summarize the recent activity in this channel."        },        { "title": "Draft a reply", "message": "Help me draft a reply." }      ]    },    "slash_commands": [      {        "command": "/openclaw",        "description": "Send a message to OpenClaw",        "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",        "assistant_thread_context_changed",        "assistant_thread_started",        "channel_rename",        "member_joined_channel",        "member_left_channel",        "message.channels",        "message.groups",        "message.im",        "message.mpim",        "pin_added",        "pin_removed",        "reaction_added",        "reaction_removed"      ]    }  }}

Voor HTTP Request URLs-modus vervang je settings door de HTTP-variant en voeg je url toe aan elke slash command. Openbare URL vereist:

{  "features": {    "slash_commands": [      {        "command": "/openclaw",        "description": "Send a message to OpenClaw",        "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",        "assistant_thread_context_changed",        "assistant_thread_started",        "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

Toon verschillende functies die de bovenstaande standaarden uitbreiden.

Het standaardmanifest schakelt het Slack App Home-tabblad 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 wordt geen gesprekspayload of privéconfiguratie opgenomen. Het tabblad Messages blijft ingeschakeld voor Slack-DM's. Het manifest schakelt ook Slack-assistentthreads in met features.assistant_view, assistant:write, assistant_thread_started en assistant_thread_context_changed; assistentthreads worden naar hun eigen OpenClaw-threadsessies gerouteerd en houden door Slack geleverde threadcontext beschikbaar voor de agent.

{"slash_commands": [{"command": "/new","description": "Start a new session","usage_hint": "[model]"},{"command": "/reset","description": "Reset the current session"},{"command": "/compact","description": "Compact the session context","usage_hint": "[instructions]"},{"command": "/stop","description": "Stop the current run"},{"command": "/session","description": "Manage thread-binding expiry","usage_hint": "idle <duration|off> or max-age <duration|off>"},{"command": "/think","description": "Set the thinking level","usage_hint": "<level>"},{"command": "/verbose","description": "Toggle verbose output","usage_hint": "on|off|full"},{"command": "/fast","description": "Show or set fast mode","usage_hint": "[status|on|off]"},{"command": "/reasoning","description": "Toggle reasoning visibility","usage_hint": "[on|off|stream]"},{"command": "/elevated","description": "Toggle elevated mode","usage_hint": "[on|off|ask|full]"},{"command": "/exec","description": "Show or set exec defaults","usage_hint": "host=<auto|sandbox|gateway|node> security=<deny|allowlist|full> ask=<off|on-miss|always> node=<id>"},{"command": "/approve","description": "Approve or deny pending approval requests","usage_hint": "<id> <decision>"},{"command": "/model","description": "Show or set the model","usage_hint": "[name|#|status]"},{"command": "/models","description": "List providers/models","usage_hint": "[provider] [page] [limit=<n>|size=<n>|all]"},{"command": "/help","description": "Show the short help summary"},{"command": "/commands","description": "Show the generated command catalog"},{"command": "/tools","description": "Show what the current agent can use right now","usage_hint": "[compact|verbose]"},{"command": "/agentstatus","description": "Show runtime status, including provider usage/quota when available"},{"command": "/tasks","description": "List active/recent background tasks for the current session"},{"command": "/context","description": "Explain how context is assembled","usage_hint": "[list|detail|json]"},{"command": "/whoami","description": "Show your sender identity"},{"command": "/skill","description": "Run a skill by name","usage_hint": "<name> [input]"},{"command": "/btw","description": "Ask a side question without changing session context","usage_hint": "<question>"},{"command": "/side","description": "Ask a side question without changing session context","usage_hint": "<question>"},{"command": "/usage","description": "Control the usage footer or show cost summary","usage_hint": "off|tokens|full|cost"}]}

{"slash_commands": [{"command": "/new","description": "Start a new session","usage_hint": "[model]","url": "https://gateway-host.example.com/slack/events"},{"command": "/help","description": "Show the short help summary","url": "https://gateway-host.example.com/slack/events"}]}

Tokenmodel

• botToken + appToken zijn vereist voor Socket Mode.
• HTTP-modus vereist botToken + signingSecret.
• Relay-modus vereist botToken plus relay.url, relay.authToken en relay.gatewayId; deze gebruikt geen apptoken of ondertekeningsgeheim.
• botToken, appToken, signingSecret, relay.authToken en userToken accepteren plattetekststrings of SecretRef-objecten.
• Configuratietokens overschrijven env-fallback.
• Env-fallback SLACK_BOT_TOKEN / SLACK_APP_TOKEN is alleen van toepassing op het standaardaccount.
• userToken is alleen configuratie (geen env-fallback) en gebruikt standaard alleen-lezen gedrag (userTokenReadOnly: true).

Gedrag van statussnapshot:

• Slack-accountinspectie houdt per referentie *Source- en *Status-velden bij (botToken, appToken, signingSecret, userToken).
• Status is available, configured_unavailable of missing.
• configured_unavailable betekent dat het account is geconfigureerd via SecretRef of een andere niet-inline geheime bron, maar dat het huidige opdracht-/runtimepad de werkelijke waarde niet kon oplossen.
• In HTTP-modus wordt signingSecretStatus opgenomen; in Socket Mode is het vereiste paar botTokenStatus + appTokenStatus.

Acties en poorten

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

Beschikbare actiegroepen in de huidige Slack-tooling:

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 binnenkomende bestandsplaceholders worden weergegeven en retourneert afbeeldingsvoorbeelden voor afbeeldingen of lokale bestandsmetadata voor andere bestandstypen.

Toegangscontrole en routering

Threads, sessies en antwoordtags

• DM's routeren als direct; kanalen als channel; MPIM's als group.
• Slack-routebindingen accepteren ruwe peer-ID's plus Slack-doelvormen zoals channel:C12345678, user:U12345678 en <@U12345678>.
• Met de standaardinstelling session.dmScope=main vallen Slack-DM's samen in de hoofdsessie van de agent.
• Kanaalsessies: agent:<agentId>:slack:channel:<channelId>.
• Gewone kanaalberichten op topniveau blijven op de sessie per kanaal, zelfs wanneer replyToMode niet off is.
• Slack-threadantwoorden gebruiken de bovenliggende Slack thread_ts voor sessiesuffixen (:thread:<threadTs>), zelfs wanneer uitgaande antwoordthreads zijn uitgeschakeld met replyToMode="off".
• OpenClaw seedt een geschikte kanaalroot op topniveau in agent:<agentId>:slack:channel:<channelId>:thread:<rootTs> wanneer van die root wordt verwacht dat deze een zichtbare Slack-thread start, zodat de root en latere threadantwoorden één OpenClaw-sessie delen. Dit geldt voor app_mention-events, expliciete botmatches of geconfigureerde mention-pattern-matches, en kanalen met requireMention: false 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 start (standaard 20; stel in op 0 om uit te schakelen).
• channels.slack.thread.requireExplicitMention (standaard false): wanneer true, onderdrukt dit impliciete threadmentions zodat de bot alleen reageert op expliciete @bot-mentions binnen threads, zelfs wanneer de bot al aan de thread heeft deelgenomen. Zonder dit omzeilen antwoorden in een thread waaraan de bot heeft deelgenomen de requireMention-poort.

Besturing van antwoordthreads:

• channels.slack.replyToMode: off|first|all|batched (standaard off)
• channels.slack.replyToModeByChatType: per direct|group|channel
• verouderde fallback voor directe chats: channels.slack.dm.replyToMode

Handmatige antwoordtags worden ondersteund:

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

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

Wanneer een message-toolcall binnen een Slack-thread draait en hetzelfde kanaal target, erft OpenClaw normaal gesproken de huidige Slack-thread volgens replyToMode. 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 opt-out naar topniveau.

Ack-reacties

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

Emoji (ackReaction)

Volgorde van resolutie:

• channels.slack.accounts.<accountId>.ackReaction
• channels.slack.ackReaction
• messages.ackReaction
• fallback naar emoji van agentidentiteit (agents.list[].identity.emoji, anders "eyes" / 👀)

Opmerkingen:

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

Scope (messages.ackReactionScope)

De Slack-provider leest de scope uit messages.ackReactionScope (standaard "group-mentions"). Er is vandaag geen override op Slack-account- of Slack-kanaalniveau; de waarde is globaal voor de Gateway.

Waarden:

• "all": reageer in DM's en groepen.
• "direct": reageer alleen in DM's.
• "group-all": reageer op elk groepsbericht (geen DM's).
• "group-mentions" (standaard): reageer in groepen, maar alleen wanneer de bot wordt genoemd (of in groepsmentionables die zich hebben aangemeld). DM's zijn uitgesloten.
• "off" / "none": reageer nooit.

{  messages: {    ackReaction: "eyes",    ackReactionScope: "all", // react in DMs and groups  },}

Tekststreaming

channels.slack.streaming bestuurt het gedrag van live previews:

• off: schakel live-previewstreaming uit.
• partial (standaard): vervang previewtekst door de nieuwste gedeeltelijke uitvoer.
• block: voeg preview-updates in chunks toe.
• progress: toon voortgangsstatustekst tijdens het genereren en verzend daarna de definitieve tekst.
• streaming.preview.toolProgress: wanneer conceptpreview actief is, routeer tool-/voortgangsupdates naar hetzelfde bewerkte previewbericht (standaard: true). Stel in op false om aparte tool-/voortgangsberichten te behouden.
• streaming.preview.commandText / streaming.progress.commandText: stel in op status om compacte tool-voortgangsregels te behouden terwijl ruwe command-/exec-tekst wordt verborgen (standaard: raw).

Verberg ruwe command-/exec-tekst terwijl compacte voortgangsregels behouden blijven:

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

channels.slack.streaming.nativeTransport bestuurt Slack-native tekststreaming wanneer channels.slack.streaming.mode partial is (standaard: true).

Slack-native taak-kaarten voor voortgang zijn opt-in voor de voortgangsmodus. Stel channels.slack.streaming.progress.nativeTaskCards in op true met channels.slack.streaming.mode="progress" om een Slack-native plan-/taakkaart te verzenden terwijl werk wordt uitgevoerd, en werk daarna dezelfde taakkaart bij bij voltooiing. Zonder deze vlag behoudt de voortgangsmodus het draagbare conceptpreviewgedrag.

• Er moet een antwoordthread beschikbaar zijn voordat native tekststreaming en Slack-assistentthreadstatus kunnen verschijnen. Threadselectie volgt nog steeds replyToMode.
• Kanaal-, groepschat- en DM-roots op topniveau kunnen nog steeds de normale conceptpreview gebruiken wanneer native streaming niet beschikbaar is of er geen antwoordthread bestaat.
• Slack-DM's op topniveau blijven standaard buiten threads, dus ze tonen Slack's native stream-/statuspreview in threadstijl niet; OpenClaw plaatst en bewerkt in plaats daarvan een conceptpreview in de DM.
• Media en niet-tekstpayloads vallen terug op normale levering.
• Definitieve media-/foutberichten annuleren wachtende previewbewerkingen; geschikte definitieve tekst-/blokberichten flushen alleen wanneer ze de preview op zijn plaats kunnen bewerken.
• Als streaming halverwege een antwoord mislukt, valt OpenClaw terug op normale levering voor resterende payloads.

Gebruik conceptpreview in plaats van Slack-native tekststreaming:

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

Meld je aan voor Slack-native taak-kaarten voor voortgang:

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

Verouderde sleutels:

• channels.slack.streamMode (replace | status_final | append) is een verouderde runtime-alias voor channels.slack.streaming.mode.
• boolean channels.slack.streaming is een verouderde runtime-alias voor channels.slack.streaming.mode en channels.slack.streaming.nativeTransport.
• verouderde channels.slack.nativeStreaming is een runtime-alias voor channels.slack.streaming.nativeTransport.
• Voer openclaw doctor --fix uit om opgeslagen Slack-streamingconfiguratie te herschrijven naar de canonieke sleutels.

Fallback voor typreactie

typingReaction voegt een tijdelijke reactie toe aan het inkomende Slack-bericht terwijl OpenClaw een antwoord verwerkt, en verwijdert die wanneer de run eindigt. Dit is het nuttigst buiten threadantwoorden, die een standaardstatusindicator "is typing..." gebruiken.

Volgorde van resolutie:

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

Opmerkingen:

• Slack verwacht shortcodes (bijvoorbeeld "hourglass_flowing_sand").
• De reactie is best-effort en opschonen wordt automatisch geprobeerd nadat het antwoord- of foutpad is voltooid.

Media, chunking en levering

Commands en slashgedrag

Slashcommands verschijnen in Slack als één geconfigureerde command of als meerdere native commands. Configureer channels.slack.slashCommand om commandstandaarden te wijzigen:

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

/openclaw /help

Native commands vereisen aanvullende manifestinstellingen in je Slack-app en worden in plaats daarvan ingeschakeld met channels.slack.commands.native: true of commands.native: true in globale configuraties.

• Native command-automodus staat uit voor Slack, dus commands.native: "auto" schakelt Slack-native commands niet in.

/help

Native argumentmenu's gebruiken een adaptieve renderstrategie die een bevestigingsmodal toont voordat een geselecteerde optiewaarde wordt verzonden:

• tot 5 opties: button-blokken
• 6-100 opties: statisch selectiemenu
• meer dan 100 opties: externe selectie met asynchrone optiefiltering wanneer handlers voor interactiviteitsopties beschikbaar zijn
• overschreden Slack-limieten: gecodeerde optiewaarden vallen terug op buttons

/think

Slash-sessies gebruiken geisoleerde sleutels zoals agent:<agentId>:slack:slash:<userId> en routeren opdrachtuitvoeringen nog steeds naar de doelgesprekssessie met CommandTargetSessionKey.

Interactieve antwoorden

Slack kan door agents gemaakte interactieve antwoordknoppen weergeven, maar deze functie is standaard uitgeschakeld. Voor nieuwe agent-, CLI- en Plugin-uitvoer geeft u de voorkeur aan de gedeelde presentation-knoppen of selectieblokken. Ze gebruiken hetzelfde Slack-interactiepad en degraderen tegelijk op andere kanalen.

Schakel dit globaal in:

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

Of schakel dit alleen voor een Slack-account in:

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

Wanneer dit is ingeschakeld, kunnen agents nog steeds verouderde Slack-only antwoordrichtlijnen uitsturen:

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

Deze richtlijnen worden gecompileerd naar Slack Block Kit en routeren klikken of selecties terug via het bestaande Slack-interactiegebeurtenispad. Behoud ze voor oude prompts en Slack-specifieke uitwegen; gebruik gedeelde presentatie voor nieuwe draagbare besturingselementen.

De API's van de richtlijncompiler zijn ook verouderd voor nieuwe producer-code:

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

Gebruik presentation-payloads en buildSlackPresentationBlocks(...) voor nieuwe door Slack weergegeven besturingselementen.

Opmerkingen:

• Dit is Slack-specifieke legacy-UI. Andere kanalen vertalen Slack Block Kit-richtlijnen niet naar hun eigen knoppensystemen.
• De interactieve callbackwaarden zijn door OpenClaw gegenereerde ondoorzichtige tokens, geen ruwe door agents geschreven 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.

Modal-inzendingen die eigendom zijn van Plugins

Slack-plugins die een interactieve handler registreren, kunnen ook modal- view_submission- en view_closed-levenscyclusgebeurtenissen ontvangen voordat OpenClaw de payload compacter maakt voor de agent-zichtbare systeemgebeurtenis. Gebruik een van deze routeringspatronen wanneer u een Slack-modal opent:

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

De handler ontvangt ctx.interaction.kind als view_submission of view_closed, genormaliseerde inputs, en het volledige ruwe stateValues-object van Slack. Alleen-callback-id-routering is voldoende om de Plugin-handler aan te roepen; neem de bestaande gebruikers-/sessierouteringsvelden van modal-private_metadata op wanneer de modal ook een agent-zichtbare systeemgebeurtenis moet produceren. De agent ontvangt een compacte, geredigeerde systeemgebeurtenis Slack interaction: .... 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 Plugin-eigen opslag zonder de volledige formulierpayload te zien.

Native goedkeuringen in Slack

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

• Exec- en Plugin-goedkeuringen kunnen worden weergegeven als Slack-native Block Kit-prompts.
• channels.slack.execApprovals.* blijft de configuratie voor inschakeling van de native exec-goedkeuringsclient en DM-/kanaalroutering.
• Exec-goedkeurings-DM's gebruiken channels.slack.execApprovals.approvers of commands.ownerAllowFrom.
• Plugin-goedkeuringen gebruiken Slack-native knoppen wanneer Slack is ingeschakeld als native goedkeuringsclient voor de oorspronkelijke sessie, of wanneer approvals.plugin routeert naar de oorspronkelijke Slack-sessie of een Slack-doel.
• Plugin-goedkeurings-DM's gebruiken Slack Plugin-goedkeurders uit channels.slack.allowFrom, allowFrom van een benoemd account, of de standaardroute van het account.
• Autorisatie van goedkeurders wordt nog steeds afgedwongen: goedkeurders voor alleen exec kunnen Plugin-aanvragen niet goedkeuren tenzij ze ook Plugin-goedkeurders zijn.

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

Configuratiepad:

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

Slack schakelt native exec-goedkeuringen automatisch in wanneer enabled niet is ingesteld of "auto" is en ten minste een exec-goedkeurder wordt opgelost. Slack kan ook native Plugin-goedkeuringen via dit native-clientpad afhandelen wanneer Slack Plugin-goedkeurders worden opgelost en de aanvraag overeenkomt met de native-clientfilters. Stel enabled: false in om Slack expliciet uit te schakelen als native goedkeuringsclient. Stel enabled: true in om native goedkeuringen te forceren wanneer goedkeurders worden opgelost. Het uitschakelen van Slack exec-goedkeuringen schakelt native Slack Plugin-goedkeuringslevering die is ingeschakeld via approvals.plugin niet uit; Plugin-goedkeuringslevering gebruikt in plaats daarvan Slack Plugin-goedkeurders.

Standaardgedrag zonder expliciete Slack exec-goedkeuringsconfiguratie:

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

Expliciete Slack-native configuratie is alleen nodig wanneer u goedkeurders wilt overschrijven, filters wilt toevoegen of wilt kiezen voor levering in de oorspronkelijke chat:

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

Gedeelde approvals.exec-doorsturing is apart. Gebruik dit alleen wanneer exec-goedkeuringsprompts ook naar andere chats of expliciete out-of-band-doelen moeten routeren. Gedeelde approvals.plugin-doorsturing is ook apart; Slack-native levering onderdrukt die fallback alleen wanneer Slack de Plugin- goedkeuringsaanvraag native kan afhandelen.

Same-chat /approve werkt ook in Slack-kanalen en DM's die al opdrachten ondersteunen. Zie Exec-goedkeuringen voor het volledige goedkeuringsdoorstuurmodel.

Gebeurtenissen en operationeel gedrag

• Berichtbewerkingen/-verwijderingen worden omgezet naar systeemgebeurtenissen.
• Thread-broadcasts ("Also send to channel"-threadantwoorden) worden verwerkt als normale gebruikersberichten.
• Reactie-toevoegings-/verwijderingsgebeurtenissen worden omgezet naar systeemgebeurtenissen.
• Lid toetreden/verlaten, kanaal gemaakt/hernoemd, en pin toevoegen/verwijderen worden omgezet naar systeemgebeurtenissen.
• channel_id_changed kan kanaalconfiguratiesleutels migreren wanneer configWrites is ingeschakeld.
• Metadata voor kanaalonderwerp/-doel wordt behandeld als niet-vertrouwde context en kan in routeringscontext worden geinjecteerd.
• Threadstarter en initiale threadgeschiedenis-contextseeding worden gefilterd op geconfigureerde allowlists voor afzenders wanneer van toepassing.
• Blokacties, snelkoppelingen en modal-interacties zenden gestructureerde systeemgebeurtenissen Slack interaction: ... uit met rijke payloadvelden:
  • blokacties: geselecteerde waarden, labels, pickerwaarden en workflow_*-metadata
  • globale snelkoppelingen: callback- en actor-metadata, gerouteerd naar de directe sessie van de actor
  • berichtsnelkoppelingen: callback-, actor-, kanaal-, thread- en geselecteerde-berichtcontext
  • modal-view_submission- en view_closed-gebeurtenissen met gerouteerde kanaalmetadata en formulierinvoer

Definieer globale of berichtsnelkoppelingen in uw Slack-appconfiguratie en gebruik een niet-lege callback-ID. OpenClaw bevestigt overeenkomende snelkoppelingspayloads, past hetzelfde DM-/kanaalafzenderbeleid toe als andere Slack-interacties, en zet de opgeschoonde gebeurtenis in de wachtrij voor de gerouteerde agent-sessie. Trigger-ID's en antwoord-URL's worden uit agentcontext geredigeerd.

Configuratiereferentie

Primaire referentie: Configuratiereferentie - Slack.

Probleemoplossing

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

openclaw channels status --probeopenclaw logs --followopenclaw doctor

openclaw pairing list slack

Referentie voor bijlage-vision

Slack kan gedownloade media aan de agentbeurt koppelen wanneer Slack-bestandsdownloads slagen en groottelimieten dit toestaan. Afbeeldingsbestanden kunnen via het media-understandingpad worden doorgegeven of rechtstreeks aan een antwoordmodel met vision-mogelijkheden; andere bestanden blijven behouden als downloadbare bestandscontext in plaats van als afbeeldingsinvoer te worden behandeld.

Ondersteunde mediatypen

Inbound pipeline

Wanneer een Slack-bericht met bestandsbijlagen binnenkomt:

1. OpenClaw downloadt het bestand vanaf de privé-URL van Slack met het bot-token.
2. Het bestand wordt bij succes naar de mediaopslag geschreven.
3. Gedownloade mediapaden en inhoudstypen worden toegevoegd aan de inbound context.
4. Model-/toolpaden met afbeeldingsmogelijkheden kunnen afbeeldingsbijlagen uit die context gebruiken.
5. Niet-afbeeldingsbestanden blijven beschikbaar als bestandsmetadata of mediareferenties voor tools die ze kunnen verwerken.

Overerving van bijlagen uit de thread-root

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

• Als het antwoord zelf geen directe media heeft en het meegeleverde rootbericht bestanden heeft, kan Slack de rootbestanden hydrateren als thread-startercontext.
• Directe antwoordbijlagen hebben voorrang op bijlagen van het rootbericht.
• Een rootbericht dat alleen bestanden en geen tekst heeft, wordt weergegeven met een tijdelijke aanduiding voor bijlagen, zodat de fallback nog steeds de bestanden kan opnemen.

Verwerking van meerdere bijlagen

Wanneer één Slack-bericht meerdere bestandsbijlagen bevat:

• Elke bijlage wordt onafhankelijk via de mediapijplijn verwerkt.
• Gedownloade mediareferenties worden samengevoegd in de berichtcontext.
• De verwerkingsvolgorde volgt de bestandsvolgorde van Slack in de gebeurtenispayload.
• Een fout bij het downloaden van één bijlage blokkeert de andere niet.

Grootte-, download- en modellimieten

• Groottelimiet: standaard 20 MB per bestand. Configureerbaar via channels.slack.mediaMaxMb.
• Downloadfouten: bestanden die Slack niet kan leveren, verlopen URL's, ontoegankelijke bestanden, te grote bestanden en Slack-auth/login-HTML-responses worden overgeslagen in plaats van gerapporteerd als niet-ondersteunde formaten.
• Vision-model: afbeeldingsanalyse gebruikt het actieve antwoordmodel wanneer dit vision ondersteunt, of het afbeeldingsmodel dat is geconfigureerd op agents.defaults.imageModel.

Bekende limieten

Gerelateerde documentatie

• Media-understandingpipeline
• PDF-tool
• Epic: #51349 — inschakeling van vision voor Slack-bijlagen
• Regressietests: #51353
• Live-verificatie: #51354

Gerelateerd