Slack

Pronto per la produzione per DM e canali tramite integrazioni dell'app Slack. La modalità predefinita è Socket Mode; sono supportati anche gli URL di richiesta HTTP.

Scegliere Socket Mode o gli URL di richiesta HTTP

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

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},"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","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},"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","message.channels","message.groups","message.im"]}}}

export SLACK_APP_TOKEN=xapp-...export SLACK_BOT_TOKEN=xoxb-...cat > 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=xapp-...SLACK_BOT_TOKEN=xoxb-...

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},"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","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},"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","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=xoxb-...export 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

Regolazione del trasporto Socket Mode

OpenClaw imposta per impostazione predefinita il timeout pong del client SDK Slack a 15 secondi per Socket Mode. Sovrascrivi le impostazioni di trasporto solo quando hai bisogno di una regolazione 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/server-ping del websocket Slack o che vengono eseguiti su host con starvation nota 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 dell'applicazione, non segnali di attività del trasporto.

Checklist di manifest e ambiti

Il manifest di base dell'app Slack è lo stesso per Socket Mode e per gli URL di richiesta HTTP. Solo il blocco settings (e l'url del comando slash) cambia.

Manifest di base (Socket Mode predefinita):

{  "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    },    "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",        "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à URL di richiesta HTTP, 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",        "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 le impostazioni predefinite sopra.

Il manifest predefinito abilita la scheda Home della Slack App Home e sottoscrive app_home_opened. Quando un membro del workspace 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 Messaggi resta abilitata per i DM 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": "/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.
• botToken, appToken, signingSecret e userToken accettano stringhe in testo semplice o 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 (xoxp-...) è solo di configurazione (nessun fallback env) e usa per impostazione predefinita un comportamento di sola lettura (userTokenReadOnly: true).

Comportamento dello snapshot di stato:

• L'ispezione dell'account Slack traccia i campi *Source e *Status per credenziale (botToken, appToken, signingSecret, userToken).
• Lo stato è available, configured_unavailable o missing.
• configured_unavailable indica che l'account è configurato tramite SecretRef o un'altra origine di segreto non inline, ma il percorso corrente di comando/runtime 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 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 placeholder dei file in ingresso e restituisce anteprime immagine per le immagini o metadati di file locale per altri tipi di file.

Controllo dell'accesso e routing

Thread, sessioni e tag di risposta

• I DM vengono instradati come direct; i canali come channel; gli MPIM come group.
• I binding di route 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 confluiscono nella sessione principale dell'agente.
• Sessioni canale: agent:<agentId>:slack:channel:<channelId>.
• Le risposte nei thread possono creare suffissi di sessione thread (:thread:<threadTs>) quando applicabile.
• Nei canali in cui OpenClaw gestisce messaggi di primo livello senza richiedere una menzione esplicita, replyToMode non off instrada ogni radice gestita in agent:<agentId>:slack:channel:<channelId>:thread:<rootTs> in modo che il thread Slack visibile corrisponda a una sessione OpenClaw dal primo turno.
• Il valore predefinito di channels.slack.thread.historyScope è thread; il valore predefinito di thread.inheritParent è false.
• channels.slack.thread.initialHistoryLimit controlla quanti messaggi thread esistenti vengono recuperati quando inizia una nuova sessione thread (predefinito 20; imposta 0 per disabilitare).
• channels.slack.thread.requireExplicitMention (predefinito false): quando true, sopprime le menzioni implicite nei thread in modo che il bot risponda solo a menzioni esplicite @bot 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 chat dirette: channels.slack.dm.replyToMode

Sono supportati tag di risposta manuali:

• [[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 chat.postMessage di Slack 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 normalmente eredita 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 dal primo livello.

Reazioni di ack

ackReaction invia un emoji di conferma mentre OpenClaw sta elaborando un messaggio in ingresso.

Ordine di risoluzione:

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

Note:

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

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 a blocchi.
• progress: mostra testo di stato di 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 separati i messaggi di strumenti/avanzamento.
• streaming.preview.commandText / streaming.progress.commandText: imposta a status per mantenere righe compatte di avanzamento strumenti nascondendo il testo raw di comando/exec (predefinito: raw).

Nascondi il testo raw 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 di testo nativo Slack quando channels.slack.streaming.mode è partial (predefinito: true).

• Deve essere disponibile un thread di risposta affinché compaiano lo streaming di testo nativo e lo stato del thread dell'assistente 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 della 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 di streaming/stato nativa in stile thread di Slack; OpenClaw pubblica e modifica invece un'anteprima della bozza nel DM.
• I media e i payload non testuali ricadono sulla consegna normale.
• I finali media/errore annullano le modifiche di anteprima in sospeso; i finali testuali/a blocchi idonei vengono scaricati solo quando possono modificare l'anteprima sul posto.
• Se lo streaming fallisce a metà risposta, OpenClaw ricade sulla consegna normale per i payload rimanenti.

Usa l'anteprima della bozza invece dello streaming di testo nativo di Slack:

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

Chiavi legacy:

• channels.slack.streamMode (replace | status_final | append) è un alias runtime legacy per channels.slack.streaming.mode.
• boolean channels.slack.streaming è un alias runtime legacy per channels.slack.streaming.mode e channels.slack.streaming.nativeTransport.
• legacy channels.slack.nativeStreaming è 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 elabora una risposta, poi la rimuove al termine dell'esecuzione. Questo è più utile fuori dalle risposte in thread, che usano un indicatore di stato predefinito "is typing...".

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 del percorso di risposta o errore.

Media, suddivisione in blocchi e consegna

Comandi e comportamento slash

I comandi slash compaiono in Slack come un singolo comando configurato o 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 aggiuntive del manifesto nella tua app Slack e sono invece abilitati 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 degli argomenti nativi usano una strategia di rendering adattiva che mostra una modale di conferma prima di inviare il valore dell'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 gli handler delle opzioni di interattività
• limiti Slack superati: i valori delle opzioni codificati ricadono sui pulsanti

/think

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

Risposte interattive

Slack può renderizzare controlli di risposta interattivi creati dall'agente, ma questa funzionalità è disabilitata per impostazione predefinita.

Abilitala globalmente:

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

Oppure abilitala solo per un account Slack:

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

Quando è abilitata, gli agenti possono emettere direttive di risposta solo 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.

Note:

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

Approvazioni exec in Slack

Slack può agire come client di approvazione nativo con pulsanti e interazioni interattivi, invece di ricadere sulla Web UI o sul terminale.

• Le approvazioni exec usano channels.slack.execApprovals.* per l'instradamento nativo di DM/canale.
• Le approvazioni Plugin possono comunque risolversi tramite la stessa superficie di pulsanti nativa Slack quando la richiesta arriva già in Slack e il tipo dell'ID approvazione è plugin:.
• L'autorizzazione dell'approvatore viene comunque applicata: solo gli utenti identificati come approvatori possono approvare o negare richieste tramite Slack.

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

Percorso di configurazione:

• channels.slack.execApprovals.enabled
• channels.slack.execApprovals.approvers (facoltativo; ricade 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 viene risolto. Imposta enabled: false per disabilitare esplicitamente Slack come client di approvazione nativo. Imposta enabled: true per forzare l'attivazione delle approvazioni native quando gli approvatori vengono risolti.

Comportamento predefinito senza una configurazione esplicita delle approvazioni exec Slack:

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

La configurazione nativa Slack esplicita è 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 essere instradati anche ad altre chat o a destinatari espliciti fuori banda. Anche l'inoltro condiviso approvals.plugin è separato; i pulsanti nativi Slack possono comunque risolvere le approvazioni Plugin quando quelle richieste arrivano già in Slack.

Anche /approve nella stessa chat funziona nei canali Slack e nei DM che supportano già i comandi. Consulta 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.
• Le trasmissioni dei thread ("Also send to channel" nelle risposte in thread) vengono elaborate come normali messaggi utente.
• Gli eventi di aggiunta/rimozione delle reazioni vengono mappati in eventi di sistema.
• Gli eventi di ingresso/uscita dei membri, creazione/ridenominazione dei canali e aggiunta/rimozione dei 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 inseriti nel contesto di instradamento.
• L'iniziatore del thread e il seeding del contesto iniziale della cronologia del thread vengono filtrati dalle allowlist dei mittenti configurate quando applicabile.
• Le azioni sui blocchi e le interazioni modali emettono eventi di sistema strutturati Slack interaction: ... con campi payload ricchi:
  • azioni sui blocchi: valori selezionati, etichette, valori picker e metadati workflow_*
  • eventi modali view_submission e view_closed con metadati di canale instradati e input del modulo

Riferimento di configurazione

Riferimento principale: Riferimento di configurazione - Slack.

Risoluzione dei problemi

openclaw channels status --probeopenclaw logs --followopenclaw doctor

openclaw pairing list slack

Riferimento alla visione degli allegati

Slack può allegare media scaricati al turno dell'agente quando i download dei file Slack riescono e i limiti di dimensione lo permettono. I file immagine possono passare attraverso il percorso di comprensione dei media o direttamente a un modello di risposta con capacità di visione; gli altri file vengono mantenuti come contesto di 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 (xoxb-...).
2. In caso di successo, il file viene scritto nell'archivio dei media.
3. I percorsi dei media scaricati e i tipi di contenuto vengono aggiunti al contesto in ingresso.
4. I percorsi di modelli/strumenti compatibili con le immagini 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 del messaggio iniziale del thread.
• Gli allegati diretti della risposta hanno la precedenza sugli allegati del messaggio radice.
• Un messaggio radice che ha solo file e nessun testo viene rappresentato con un segnaposto per 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 indipendentemente attraverso 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: 20 MB predefiniti per file. Configurabile tramite channels.slack.mediaMaxMb.
• Errori di download: I file che Slack non può servire, gli URL scaduti, i file inaccessibili, i file troppo grandi e le risposte HTML di autenticazione/accesso Slack vengono ignorati invece di essere segnalati come formati non supportati.
• Modello di visione: L'analisi delle immagini usa il modello di risposta attivo quando supporta la visione, oppure il modello immagine configurato in agents.defaults.imageModel.

Limiti noti

Documentazione correlata

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

Correlati