Slack

Pronto per la produzione per DM e canali tramite integrazioni app Slack. La modalità predefinita è Socket Mode; sono supportati anche gli HTTP Request URL. La modalità relay è pensata per distribuzioni gestite in cui un router attendibile controlla l'ingresso Slack.

Scegliere Socket Mode o gli HTTP Request URL

Entrambi i trasporti sono pronti per la produzione e raggiungono la parità di funzionalità per messaggistica, slash command, App Home e interattività. Scegli in base alla forma della distribuzione, non alle funzionalità.

Modalità relay

La modalità relay separa l'ingresso Slack dal gateway OpenClaw. Un router attendibile controlla la singola connessione Slack Socket Mode, sceglie un gateway di destinazione e inoltra un evento tipizzato tramite un websocket autenticato. Il gateway continua a usare il proprio token bot per le chiamate in uscita alla 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",      },    },  },}

L'URL relay deve usare wss:// a meno che non punti a localhost. Considera il bearer token e la tabella di routing del router come parte del confine di autorizzazione Slack: gli eventi instradati entrano nel normale handler dei messaggi Slack come attivazioni autorizzate. Un slack_identity fornito dal router nel frame websocket hello può impostare il nome utente e l'icona predefiniti in uscita; un'identità esplicita fornita dal chiamante ha comunque la precedenza. La connessione relay si riconnette con la stessa temporizzazione di backoff limitato usata da Socket Mode e cancella l'identità fornita dal router ogni volta che si disconnette.

Installazione

Installa Slack prima di configurare il canale:

openclaw plugins install @openclaw/slack

plugins install registra e abilita il plugin. Il plugin non fa comunque nulla finché non configuri l'app Slack e le impostazioni del canale qui sotto. Vedi Plugin per il comportamento generale dei plugin e le regole di installazione.

Configurazione rapida

{"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

Ottimizzazione del trasporto in modalità Socket Mode

OpenClaw imposta per impostazione predefinita il timeout pong del client Slack SDK a 15 secondi per Socket Mode. Sovrascrivi le impostazioni di trasporto solo quando hai bisogno di un'ottimizzazione specifica per workspace o host:

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

Usalo solo per workspace Socket Mode che registrano timeout pong/websocket server-ping di Slack o che vengono eseguiti su host con nota saturazione dell'event loop. clientPingTimeout è l'attesa del pong dopo che l'SDK invia un ping client; serverPingTimeout è l'attesa dei ping server di Slack. I messaggi e gli eventi dell'app restano stato applicativo, non segnali di vitalità del trasporto.

Note:

• socketMode viene ignorato in modalità HTTP Request URL.
• Le impostazioni di base channels.slack.socketMode si applicano a tutti gli account Slack salvo sovrascrittura. Le sovrascritture per account usano channels.slack.accounts.<accountId>.socketMode; poiché si tratta di una sovrascrittura di oggetto, includi ogni campo di ottimizzazione socket che vuoi per quell'account.
• Solo clientPingTimeout ha un valore predefinito OpenClaw (15000). serverPingTimeout e pingPongLoggingEnabled vengono passati allo Slack SDK solo quando configurati.
• Il backoff del riavvio di Socket Mode parte da circa 2 secondi e arriva a un massimo di circa 30 secondi. Gli errori recuperabili di avvio, attesa dell'avvio e disconnessione vengono ritentati finché il canale non si arresta. Gli errori permanenti di account e credenziali, come autenticazione non valida, token revocati o ambiti mancanti, falliscono rapidamente invece di ritentare per sempre.

Checklist di manifest e ambiti

Il manifest di base dell'app Slack è lo stesso per Socket Mode e HTTP Request URLs. Cambia solo il blocco settings (e l'url del comando slash).

Manifest di base (predefinito 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"      ]    }  }}

Per la modalità HTTP Request URLs, sostituisci settings con la variante HTTP e aggiungi url a ogni comando slash. URL pubblico richiesto:

{  "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"    }  }}

Impostazioni aggiuntive del manifest

Espone funzionalità diverse che estendono i valori predefiniti sopra.

Il manifest predefinito abilita la scheda Home di Slack App Home e sottoscrive app_home_opened. Quando un membro dell'area di lavoro apre la scheda Home, OpenClaw pubblica una vista Home predefinita sicura con views.publish; non viene incluso alcun payload di conversazione o configurazione privata. La scheda Messages resta abilitata per i DM di Slack. Il manifest abilita inoltre i thread assistente di Slack con features.assistant_view, assistant:write, assistant_thread_started e assistant_thread_context_changed; i thread assistente vengono instradati alle proprie sessioni di thread OpenClaw e mantengono disponibile per l'agente il contesto del thread fornito da Slack.

{"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"}]}

Modello dei token

• botToken + appToken sono obbligatori per Socket Mode.
• La modalità HTTP richiede botToken + signingSecret.
• La modalità relay richiede botToken più relay.url, relay.authToken e relay.gatewayId; non usa un token app né un segreto di firma.
• botToken, appToken, signingSecret, relay.authToken e userToken accettano stringhe in testo normale oppure oggetti SecretRef.
• I token di configurazione hanno la precedenza sul fallback env.
• Il fallback env SLACK_BOT_TOKEN / SLACK_APP_TOKEN si applica solo all'account predefinito.
• userToken è solo di configurazione (nessun fallback env) e per impostazione predefinita usa un comportamento di sola lettura (userTokenReadOnly: true).

Comportamento dell'istantanea di stato:

• L'ispezione dell'account Slack traccia i campi per credenziale *Source e *Status (botToken, appToken, signingSecret, userToken).
• Lo stato è available, configured_unavailable o missing.
• configured_unavailable significa che l'account è configurato tramite SecretRef o un'altra fonte di segreti non inline, ma il percorso comando/runtime corrente non è riuscito a risolvere il valore effettivo.
• In modalità HTTP, signingSecretStatus è incluso; in Socket Mode, la coppia richiesta è botTokenStatus + appTokenStatus.

Azioni e gate

Le azioni Slack sono controllate da channels.slack.actions.*.

Gruppi di azioni disponibili negli strumenti Slack correnti:

Le azioni di messaggio Slack correnti includono send, upload-file, download-file, read, edit, delete, pin, unpin, list-pins, member-info ed emoji-list. download-file accetta gli ID file Slack mostrati nei segnaposto dei file in ingresso e restituisce anteprime immagine per le immagini o metadati di file locali per altri tipi di file.

Controllo degli accessi e instradamento

Thread, sessioni e tag di risposta

• I DM vengono instradati come direct; i canali come channel; gli MPIM come group.
• I binding di routing Slack accettano ID peer grezzi più forme di destinazione Slack come channel:C12345678, user:U12345678 e <@U12345678>.
• Con session.dmScope=main predefinito, i DM Slack convergono nella sessione principale dell'agente.
• Sessioni di canale: agent:<agentId>:slack:channel:<channelId>.
• I normali messaggi di canale di primo livello restano nella sessione per canale, anche quando replyToMode non è off.
• Le risposte nei thread Slack usano lo Slack thread_ts padre per i suffissi di sessione (:thread:<threadTs>), anche quando il threading delle risposte in uscita è disabilitato con replyToMode="off".
• OpenClaw inizializza una radice di canale di primo livello idonea in agent:<agentId>:slack:channel:<channelId>:thread:<rootTs> quando ci si aspetta che quella radice avvii un thread Slack visibile, così la radice e le risposte successive nel thread condividono una singola sessione OpenClaw. Questo si applica agli eventi app_mention, alle corrispondenze esplicite di bot o di pattern di menzione configurati, e ai canali con requireMention: false con replyToMode diverso da off.
• Il valore predefinito di channels.slack.thread.historyScope è thread; il valore predefinito di thread.inheritParent è false.
• channels.slack.thread.initialHistoryLimit controlla quanti messaggi esistenti del thread vengono recuperati quando inizia una nuova sessione di thread (predefinito 20; imposta 0 per disabilitare).
• channels.slack.thread.requireExplicitMention (predefinito false): quando è true, sopprime le menzioni implicite nei thread, così il bot risponde solo alle menzioni @bot esplicite dentro i thread, anche quando il bot ha già partecipato al thread. Senza questa opzione, le risposte in un thread a cui il bot ha partecipato aggirano il gate requireMention.

Controlli del threading delle risposte:

• channels.slack.replyToMode: off|first|all|batched (predefinito off)
• channels.slack.replyToModeByChatType: per direct|group|channel
• fallback legacy per le chat dirette: channels.slack.dm.replyToMode

I tag manuali di risposta sono supportati:

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

Per risposte esplicite nei thread Slack dallo strumento message, imposta replyBroadcast: true con action: "send" e threadId o replyTo per chiedere a Slack di trasmettere anche la risposta del thread al canale padre. Questo corrisponde al flag reply_broadcast di Slack chat.postMessage ed è supportato solo per invii di testo o Block Kit, non per caricamenti multimediali.

Quando una chiamata allo strumento message viene eseguita dentro un thread Slack e punta allo stesso canale, OpenClaw eredita normalmente il thread Slack corrente secondo replyToMode. Imposta topLevel: true su action: "send" o action: "upload-file" per forzare invece un nuovo messaggio nel canale padre. threadId: null è accettato come la stessa esclusione di primo livello.

Reazioni di conferma

ackReaction invia un'emoji di conferma mentre OpenClaw sta elaborando un messaggio in ingresso. ackReactionScope decide quando quell'emoji viene effettivamente inviata.

Emoji (ackReaction)

Ordine di risoluzione:

• channels.slack.accounts.<accountId>.ackReaction
• channels.slack.ackReaction
• messages.ackReaction
• fallback emoji dell'identità dell'agente (agents.list[].identity.emoji, altrimenti "eyes" / 👀)

Note:

• Slack si aspetta shortcode (per esempio "eyes").
• Usa "" per disabilitare la reazione per l'account Slack o globalmente.

Ambito (messages.ackReactionScope)

Il provider Slack legge l'ambito da messages.ackReactionScope (predefinito "group-mentions"). Oggi non esiste override a livello di account Slack o di canale Slack; il valore è globale per il Gateway.

Valori:

• "all": reagisci nei DM e nei gruppi.
• "direct": reagisci solo nei DM.
• "group-all": reagisci a ogni messaggio di gruppo (nessun DM).
• "group-mentions" (predefinito): reagisci nei gruppi, ma solo quando il bot viene menzionato (o nei mentionable di gruppo che hanno aderito). I DM sono esclusi.
• "off" / "none": non reagire mai.

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

Streaming del testo

channels.slack.streaming controlla il comportamento dell'anteprima live:

• off: disabilita lo streaming dell'anteprima live.
• partial (predefinito): sostituisce il testo dell'anteprima con l'ultimo output parziale.
• block: aggiunge aggiornamenti di anteprima in blocchi.
• progress: mostra testo di stato dell'avanzamento durante la generazione, poi invia il testo finale.
• streaming.preview.toolProgress: quando l'anteprima bozza è attiva, instrada gli aggiornamenti di strumenti/avanzamento nello stesso messaggio di anteprima modificato (predefinito: true). Imposta false per mantenere messaggi separati di strumenti/avanzamento.
• streaming.preview.commandText / streaming.progress.commandText: imposta su status per mantenere righe compatte di avanzamento degli strumenti nascondendo il testo grezzo di comando/exec (predefinito: raw).

Nascondi il testo grezzo di comando/exec mantenendo righe di avanzamento compatte:

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

channels.slack.streaming.nativeTransport controlla lo streaming testuale nativo Slack quando channels.slack.streaming.mode è partial (predefinito: true).

Le schede attività di avanzamento native Slack sono opt-in per la modalità progress. Imposta channels.slack.streaming.progress.nativeTaskCards su true con channels.slack.streaming.mode="progress" per inviare una scheda piano/attività nativa Slack mentre il lavoro è in corso, poi aggiornare la stessa scheda attività al completamento. Senza questo flag, la modalità progress mantiene il comportamento portabile dell'anteprima bozza.

• Un thread di risposta deve essere disponibile perché compaiano lo streaming testuale nativo e lo stato del thread assistente di Slack. La selezione del thread segue comunque replyToMode.
• Le radici di canali, chat di gruppo e DM di primo livello possono comunque usare la normale anteprima bozza quando lo streaming nativo non è disponibile o non esiste alcun thread di risposta.
• I DM Slack di primo livello restano fuori thread per impostazione predefinita, quindi non mostrano l'anteprima nativa di streaming/stato in stile thread di Slack; OpenClaw invece pubblica e modifica un'anteprima bozza nel DM.
• I payload multimediali e non testuali ripiegano sulla consegna normale.
• I finali multimediali/di errore annullano le modifiche di anteprima in sospeso; i finali testuali/blocco idonei vengono scaricati solo quando possono modificare l'anteprima in loco.
• Se lo streaming fallisce a metà risposta, OpenClaw ripiega sulla consegna normale per i payload rimanenti.

Usa l'anteprima bozza invece dello streaming testuale nativo Slack:

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

Aderisci alle schede attività di avanzamento native Slack:

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

Chiavi legacy:

• channels.slack.streamMode (replace | status_final | append) è un alias runtime legacy per channels.slack.streaming.mode.
• channels.slack.streaming booleano è un alias runtime legacy per channels.slack.streaming.mode e channels.slack.streaming.nativeTransport.
• channels.slack.nativeStreaming legacy è un alias runtime per channels.slack.streaming.nativeTransport.
• Esegui openclaw doctor --fix per riscrivere la configurazione di streaming Slack persistita nelle chiavi canoniche.

Fallback della reazione di digitazione

typingReaction aggiunge una reazione temporanea al messaggio Slack in ingresso mentre OpenClaw sta elaborando una risposta, poi la rimuove quando l'esecuzione termina. È particolarmente utile fuori dalle risposte nei thread, che usano un indicatore di stato predefinito "sta scrivendo...".

Ordine di risoluzione:

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

Note:

• Slack si aspetta shortcode (per esempio "hourglass_flowing_sand").
• La reazione è best-effort e la pulizia viene tentata automaticamente dopo il completamento della risposta o del percorso di errore.

Media, suddivisione in blocchi e consegna

Comandi e comportamento slash

I comandi slash compaiono in Slack come un singolo comando configurato oppure come più comandi nativi. Configura channels.slack.slashCommand per cambiare i valori predefiniti dei comandi:

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

/openclaw /help

I comandi nativi richiedono impostazioni manifest aggiuntive nella tua app Slack e vengono abilitati invece con channels.slack.commands.native: true o commands.native: true nelle configurazioni globali.

• La modalità automatica dei comandi nativi è disattivata per Slack, quindi commands.native: "auto" non abilita i comandi nativi Slack.

/help

I menu di argomenti nativi usano una strategia di rendering adattiva che mostra una modale di conferma prima di inviare il valore di un'opzione selezionata:

• fino a 5 opzioni: blocchi di pulsanti
• 6-100 opzioni: menu di selezione statico
• più di 100 opzioni: selezione esterna con filtro asincrono delle opzioni quando sono disponibili gestori delle opzioni di interattività
• limiti Slack superati: i valori di opzione codificati ripiegano sui pulsanti

/think

Le sessioni slash usano chiavi isolate come agent:<agentId>:slack:slash:<userId> e instradano comunque le esecuzioni dei comandi alla sessione di conversazione di destinazione usando CommandTargetSessionKey.

Risposte interattive

Slack può visualizzare controlli di risposta interattivi creati dall'agente, ma questa funzionalità è disabilitata per impostazione predefinita. Per il nuovo output di agente, CLI e Plugin, preferisci i pulsanti condivisi presentation o i blocchi di selezione. Usano lo stesso percorso di interazione Slack e degradano anche sugli altri canali.

Abilitalo globalmente:

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

Oppure abilitalo solo per un account Slack:

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

Quando è abilitato, gli agenti possono ancora emettere direttive di risposta deprecate specifiche per Slack:

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

Queste direttive vengono compilate in Slack Block Kit e instradano clic o selezioni attraverso il percorso evento di interazione Slack esistente. Conservale per i vecchi prompt e per vie di uscita specifiche di Slack; usa la presentazione condivisa per i nuovi controlli portabili.

Anche le API del compilatore di direttive sono deprecate per il nuovo codice producer:

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

Usa i payload presentation e buildSlackPresentationBlocks(...) per i nuovi controlli visualizzati in Slack.

Note:

• Questa è un'interfaccia legacy specifica di Slack. Gli altri canali non traducono le direttive Slack Block Kit nei propri sistemi di pulsanti.
• I valori di callback interattivi sono token opachi generati da OpenClaw, non valori grezzi creati dall'agente.
• Se i blocchi interattivi generati superano i limiti di Slack Block Kit, OpenClaw ripiega sulla risposta testuale originale invece di inviare un payload di blocchi non valido.

Invii di modali di proprietà del Plugin

I Plugin Slack che registrano un gestore interattivo possono anche ricevere eventi del ciclo di vita modali view_submission e view_closed prima che OpenClaw compatti il payload per l'evento di sistema visibile all'agente. Usa uno di questi schemi di instradamento quando apri una modale Slack:

• Imposta callback_id su openclaw:<namespace>:<payload>.
• Oppure conserva un callback_id esistente e inserisci pluginInteractiveData: "<namespace>:<payload>" nel private_metadata della modale.

Il gestore riceve ctx.interaction.kind come view_submission o view_closed, gli inputs normalizzati e l'oggetto grezzo completo stateValues da Slack. L'instradamento solo tramite callback-id è sufficiente per invocare il gestore del Plugin; includi i campi di instradamento utente/sessione esistenti di private_metadata della modale quando la modale deve anche produrre un evento di sistema visibile all'agente. L'agente riceve un evento di sistema Slack interaction: ... compatto e redatto. Se il gestore restituisce systemEvent.summary, systemEvent.reference o systemEvent.data, quei campi vengono inclusi in tale evento compatto affinché l'agente possa fare riferimento allo storage di proprietà del Plugin senza vedere il payload completo del modulo.

Approvazioni native in Slack

Slack può agire come client di approvazione nativo con pulsanti e interazioni interattivi, invece di ripiegare sull'interfaccia Web o sul terminale.

• Le approvazioni exec e Plugin possono essere visualizzate come prompt Slack-native Block Kit.
• channels.slack.execApprovals.* resta la configurazione di abilitazione del client nativo per approvazioni exec e di instradamento DM/canale.
• I DM di approvazione exec usano channels.slack.execApprovals.approvers o commands.ownerAllowFrom.
• Le approvazioni Plugin usano pulsanti Slack-native quando Slack è abilitato come client di approvazione nativo per la sessione di origine, oppure quando approvals.plugin instrada alla sessione Slack di origine o a una destinazione Slack.
• I DM di approvazione Plugin usano gli approvatori del Plugin Slack da channels.slack.allowFrom, allowFrom dell'account denominato o la route predefinita dell'account.
• L'autorizzazione degli approvatori viene comunque applicata: gli approvatori solo exec non possono approvare richieste Plugin a meno che non siano anche approvatori Plugin.

Questo usa la stessa superficie condivisa dei pulsanti di approvazione degli altri canali. Quando interactivity è abilitato nelle impostazioni della tua app Slack, i prompt di approvazione vengono visualizzati come pulsanti Block Kit direttamente nella conversazione. Quando quei pulsanti sono presenti, sono la UX di approvazione principale; OpenClaw dovrebbe includere un comando manuale /approve solo quando il risultato dello strumento indica che le approvazioni in chat non sono disponibili o che l'approvazione manuale è l'unico percorso.

Percorso di configurazione:

• channels.slack.execApprovals.enabled
• channels.slack.execApprovals.approvers (facoltativo; ripiega su commands.ownerAllowFrom quando possibile)
• channels.slack.execApprovals.target (dm | channel | both, predefinito: dm)
• agentFilter, sessionFilter

Slack abilita automaticamente le approvazioni exec native quando enabled non è impostato o è "auto" e almeno un approvatore exec viene risolto. Slack può anche gestire approvazioni Plugin native tramite questo percorso di client nativo quando gli approvatori del Plugin Slack vengono risolti e la richiesta corrisponde ai filtri del client nativo. Imposta enabled: false per disabilitare esplicitamente Slack come client di approvazione nativo. Imposta enabled: true per forzare le approvazioni native quando gli approvatori vengono risolti. Disabilitare le approvazioni exec Slack non disabilita la consegna delle approvazioni Plugin native Slack abilitata tramite approvals.plugin; la consegna delle approvazioni Plugin usa invece gli approvatori del Plugin Slack.

Comportamento predefinito senza una configurazione esplicita delle approvazioni exec Slack:

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

La configurazione esplicita Slack-native è necessaria solo quando vuoi sovrascrivere gli approvatori, aggiungere filtri o aderire alla consegna nella chat di origine:

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

L'inoltro condiviso approvals.exec è separato. Usalo solo quando i prompt di approvazione exec devono anche essere instradati ad altre chat o a destinazioni esplicite fuori banda. Anche l'inoltro condiviso approvals.plugin è separato; la consegna nativa Slack sopprime quel fallback solo quando Slack può gestire nativamente la richiesta di approvazione Plugin.

Anche /approve nella stessa chat funziona nei canali Slack e nei DM che supportano già i comandi. Vedi Approvazioni exec per il modello completo di inoltro delle approvazioni.

Eventi e comportamento operativo

• Le modifiche/eliminazioni dei messaggi vengono mappate in eventi di sistema.
• I broadcast dei thread (risposte ai thread con "Also send to channel") vengono elaborati come normali messaggi utente.
• Gli eventi di aggiunta/rimozione delle reazioni vengono mappati in eventi di sistema.
• Gli eventi di ingresso/uscita membri, creazione/rinomina canale e aggiunta/rimozione pin vengono mappati in eventi di sistema.
• channel_id_changed può migrare le chiavi di configurazione del canale quando configWrites è abilitato.
• I metadati di argomento/scopo del canale sono trattati come contesto non attendibile e possono essere iniettati nel contesto di instradamento.
• L'avvio del thread e il seed del contesto iniziale della cronologia del thread vengono filtrati dalle allowlist dei mittenti configurate quando applicabile.
• Azioni dei blocchi, scorciatoie e interazioni modali emettono eventi di sistema strutturati Slack interaction: ... con campi payload ricchi:
  • azioni dei blocchi: valori selezionati, etichette, valori dei selettori e metadati workflow_*
  • scorciatoie globali: metadati di callback e attore, instradati alla sessione diretta dell'attore
  • scorciatoie messaggio: callback, attore, canale, thread e contesto del messaggio selezionato
  • eventi modali view_submission e view_closed con metadati del canale instradato e input del modulo

Definisci scorciatoie globali o messaggio nella configurazione della tua app Slack e usa qualsiasi ID callback non vuoto. OpenClaw conferma i payload di scorciatoia corrispondenti, applica la stessa policy mittente DM/canale delle altre interazioni Slack e accoda l'evento sanificato per la sessione agente instradata. Gli ID trigger e gli URL di risposta vengono redatti dal contesto dell'agente.

Riferimento di configurazione

Riferimento principale: Riferimento di configurazione - Slack.

Risoluzione dei problemi

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

openclaw channels status --probeopenclaw logs --followopenclaw doctor

openclaw pairing list slack

Riferimento vision per gli allegati

Slack può allegare i media scaricati al turno dell'agente quando i download dei file Slack riescono e i limiti di dimensione lo consentono. I file immagine possono passare attraverso il percorso di comprensione dei media o direttamente a un modello di risposta con capacità vision; gli altri file vengono mantenuti come contesto file scaricabile invece di essere trattati come input immagine.

Tipi di media supportati

Pipeline in ingresso

Quando arriva un messaggio Slack con allegati file:

1. OpenClaw scarica il file dall'URL privato di Slack usando il token del bot.
2. In caso di successo, il file viene scritto nello store dei media.
3. I percorsi dei media scaricati e i tipi di contenuto vengono aggiunti al contesto in ingresso.
4. I percorsi modello/strumento con capacità immagine possono usare gli allegati immagine da quel contesto.
5. I file non immagine restano disponibili come metadati file o riferimenti media per gli strumenti che possono gestirli.

Ereditarietà degli allegati dalla radice del thread

Quando un messaggio arriva in un thread (ha un genitore thread_ts):

• Se la risposta stessa non ha media diretti e il messaggio radice incluso ha file, Slack può idratare i file radice come contesto iniziale del thread.
• Gli allegati diretti della risposta hanno la precedenza sugli allegati del messaggio radice.
• Un messaggio radice che contiene solo file e nessun testo viene rappresentato con un segnaposto allegato, così il fallback può comunque includere i suoi file.

Gestione di più allegati

Quando un singolo messaggio Slack contiene più allegati file:

• Ogni allegato viene elaborato in modo indipendente tramite la pipeline dei media.
• I riferimenti ai media scaricati vengono aggregati nel contesto del messaggio.
• L'ordine di elaborazione segue l'ordine dei file Slack nel payload dell'evento.
• Un errore nel download di un allegato non blocca gli altri.

Limiti di dimensione, download e modello

• Limite di dimensione: predefinito 20 MB per file. Configurabile tramite channels.slack.mediaMaxMb.
• Errori di download: file che Slack non può servire, URL scaduti, file inaccessibili, file troppo grandi e risposte HTML di autenticazione/login Slack vengono ignorati invece di essere segnalati come formati non supportati.
• Modello vision: l'analisi delle immagini usa il modello di risposta attivo quando supporta vision, oppure il modello immagine configurato in agents.defaults.imageModel.

Limiti noti

Documentazione correlata

• Pipeline di comprensione dei media
• Strumento PDF
• Epic: #51349 — abilitazione della vision per gli allegati Slack
• Test di regressione: #51353
• Verifica live: #51354

Correlati