Slack

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

# Scegliere Socket Mode o HTTP Request URLs

Entrambi i trasporti sono pronti per la produzione e raggiungono la parità funzionale per messaggistica, slash commands, App Home e interattività. Scegli in base alla forma della 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" },
},
},
}
JSON5
openclaw config patch --file ./slack.socket.patch.json5 --dry-run
openclaw 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",
},
},
}
JSON5
openclaw config patch --file ./slack.http.patch.json5 --dry-run
openclaw config patch --file ./slack.http.patch.json5

openclaw gateway

# Regolazione del trasporto in modalità 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 serve 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/websocket server-ping di 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 del server Slack. I messaggi e gli eventi dell’app restano stato applicativo, non segnali di liveness del trasporto.

# Checklist di manifesto e ambiti

Il manifesto di base dell’app Slack è lo stesso per Socket Mode e per gli URL di richiesta HTTP. Cambia solo il blocco settings (e l’url del comando slash).

Manifesto di base (impostazione predefinita 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
    },
    "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 manifesto

Espone funzionalità diverse che estendono le impostazioni predefinite precedenti.

Il manifesto predefinito abilita la scheda Home dell’App Home di Slack e si iscrive a 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 né alcuna configurazione privata. La scheda Messages 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 normale 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 il comportamento predefinito è 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 significa che l'account è configurato tramite SecretRef o un'altra sorgente segreta non inline, ma il comando/percorso runtime corrente non ha potuto 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 immagini per le immagini o metadati di file locali 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 target Slack come channel:C12345678, user:U12345678 e <@U12345678>.
• Con session.dmScope=main predefinito, i DM Slack convergono 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.
• 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 così il bot risponde solo a menzioni esplicite @bot dentro i thread, anche quando il bot ha già partecipato al thread. Senza questo, le risposte in un thread a cui il bot ha partecipato bypassano il gate requireMention.

Controlli di 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

I tag di risposta manuali sono supportati:

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

# Reazioni ack

ackReaction invia un'emoji di conferma mentre OpenClaw elabora un messaggio in ingresso.

Ordine di risoluzione:

• channels.slack.accounts.<accountId>.ackReaction
• channels.slack.ackReaction
• messages.ackReaction
• fallback emoji dell'identità 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 di anteprima con l'ultimo output parziale.
• block: aggiunge aggiornamenti di anteprima a blocchi.
• progress: mostra il 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 messaggi strumenti/avanzamento separati.
• 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).

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

Usa l'anteprima bozza invece dello streaming di testo nativo 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.
• il booleano channels.slack.streaming è un alias runtime legacy per channels.slack.streaming.mode e channels.slack.streaming.nativeTransport.
• il legacy channels.slack.nativeStreaming è un alias runtime per channels.slack.streaming.nativeTransport.
• Esegui openclaw doctor --fix per riscrivere la configurazione di streaming Slack persistita usando le chiavi canoniche.

# Fallback della reazione di digitazione

typingReaction aggiunge una reazione temporanea al messaggio Slack in ingresso mentre OpenClaw elabora una risposta, quindi la rimuove quando l'esecuzione termina. È particolarmente utile al di fuori delle risposte nei 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 (ad 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, chunking e recapito

# Comandi e comportamento slash

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

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

/openclaw /help

I comandi nativi richiedono impostazioni aggiuntive del manifest nella tua app Slack e vengono 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 di 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 gestori delle opzioni di interattività
• limiti Slack superati: i valori delle opzioni codificati ripiegano sui pulsanti

/think

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

# Risposte interattive

Slack può visualizzare controlli di risposta interattivi creati dagli agenti, 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 esistente degli eventi di interazione Slack.

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 delle callback interattive sono token opachi generati da OpenClaw, non valori grezzi scritti dagli agenti.
• Se i blocchi interattivi generati superassero i limiti di Slack Block Kit, OpenClaw ripiega 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 interattive, invece di ripiegare sulla Web UI o sul terminale.

• Le approvazioni exec usano channels.slack.execApprovals.* per il routing nativo verso DM/canali.
• Le approvazioni Plugin possono comunque risolversi tramite la stessa superficie di pulsanti nativa di Slack quando la richiesta arriva già in Slack e il tipo dell'id di 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 è abilitato nelle impostazioni della tua app Slack, le richieste di approvazione vengono visualizzate come pulsanti Block Kit direttamente nella conversazione. Quando questi pulsanti sono presenti, costituiscono la UX di approvazione primaria; 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 (opzionale; 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 viene risolto. 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.

Comportamento predefinito senza 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 scegliere il recapito nella chat di origine:

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

L'inoltro condiviso approvals.exec è separato. Usalo solo quando le richieste di approvazione exec devono essere instradate anche verso altre chat o target 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.

/approve nella stessa chat funziona anche 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.
• I thread broadcast (risposte nei 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 di membri, creazione/ridenominazione di canali e aggiunta/rimozione di 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 routing.
• L'avvio del thread e il popolamento 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 dei selettori e metadati workflow_*
  • eventi modali view_submission e view_closed con metadati del canale instradato e input del modulo

# Riferimento di configurazione

Riferimento principale: Riferimento di configurazione - Slack.

# Risoluzione dei problemi

openclaw channels status --probe
openclaw logs --follow
openclaw doctor

openclaw pairing list slack

# Riferimento per la visione degli allegati

Slack può allegare i 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. Il file viene scritto nell’archivio dei media in caso di successo.
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 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 della radice del thread

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

• Se la risposta non ha media diretti e il messaggio radice incluso contiene file, Slack può idratare i file radice come contesto dell’iniziatore 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 è 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 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 saltati 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 per gli allegati Slack
• Test di regressione: #51353
• Verifica live: #51354

# Correlati