​

Slack

​

Configurazione rapida

{
  channels: {
    slack: {
      enabled: true,
      mode: "socket",
      appToken: "xapp-...",
      botToken: "xoxb-...",
    },
  },
}

SLACK_APP_TOKEN=xapp-...
SLACK_BOT_TOKEN=xoxb-...

openclaw gateway

{
  channels: {
    slack: {
      enabled: true,
      mode: "http",
      botToken: "xoxb-...",
      signingSecret: "your-signing-secret",
      webhookPath: "/slack/events",
    },
  },
}

​

Checklist del manifest e degli scope

{
  "display_information": {
    "name": "OpenClaw",
    "description": "Slack connector for OpenClaw"
  },
  "features": {
    "bot_user": {
      "display_name": "OpenClaw",
      "always_online": true
    },
    "app_home": {
      "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",
        "users:read"
      ]
    }
  },
  "settings": {
    "socket_mode_enabled": true,
    "event_subscriptions": {
      "bot_events": [
        "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"
      ]
    }
  }
}

​

Modello dei token

• botToken + appToken sono richiesti per Socket Mode.
• La modalità HTTP richiede botToken + signingSecret.
• botToken, appToken, signingSecret e userToken accettano stringhe in chiaro 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 il comportamento di sola lettura (userTokenReadOnly: true).
• Facoltativo: aggiungi chat:write.customize se vuoi che i messaggi in uscita usino l’identità dell’agente attivo (campi username e icona personalizzati). icon_emoji usa la sintassi :emoji_name:.

• L’ispezione dell’account Slack tiene traccia dei 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 origine di segreti non inline, ma il percorso di comando/runtime corrente non ha potuto risolvere il valore effettivo.
• In modalità HTTP, è incluso signingSecretStatus; in Socket Mode, la coppia richiesta è botTokenStatus + appTokenStatus.

​

Azioni e controlli

​

Controllo degli accessi e instradamento

​

Threading, sessioni e tag di risposta

• Le DM vengono instradate come direct; i canali come channel; gli MPIM come group.
• Con il valore predefinito session.dmScope=main, le DM di Slack confluiscono nella sessione principale dell’agente.
• Sessioni canale: agent:<agentId>:slack:channel:<channelId>.
• Le risposte nei thread possono creare suffissi di sessione del 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 esistenti del thread vengono recuperati quando inizia una nuova sessione thread (predefinito 20; imposta 0 per disabilitare).

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

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

​

Reazioni di conferma

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

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

​

Streaming del testo

• off: disabilita lo streaming dell’anteprima live.
• partial (predefinito): sostituisce il testo di anteprima con l’output parziale più recente.
• block: aggiunge aggiornamenti di anteprima in blocchi.
• progress: mostra un testo di stato di avanzamento durante la generazione, quindi invia il testo finale.

• Perché lo streaming di testo nativo venga visualizzato, deve essere disponibile un thread di risposta. La selezione del thread continua comunque a seguire replyToMode. Senza di esso, viene usata la normale anteprima bozza.
• I contenuti multimediali e i payload non testuali tornano alla consegna normale.
• Se lo streaming fallisce a metà risposta, OpenClaw torna alla consegna normale per i payload rimanenti.

{
  channels: {
    slack: {
      streaming: "partial",
      nativeStreaming: false,
    },
  },
}

• channels.slack.streamMode (replace | status_final | append) viene migrato automaticamente a channels.slack.streaming.
• il booleano channels.slack.streaming viene migrato automaticamente a channels.slack.nativeStreaming.

​

Fallback della reazione di digitazione

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

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

​

Media, suddivisione e consegna

​

Comandi e comportamento slash

• La modalità automatica dei comandi nativi è disattivata per Slack (commands.native: "auto" non abilita i comandi nativi di Slack).
• Abilita gli handler dei comandi Slack nativi con channels.slack.commands.native: true (o globale commands.native: true).
• Quando i comandi nativi sono abilitati, registra i comandi slash corrispondenti in Slack (nomi /<command>), con un’eccezione:
  • registra /agentstatus per il comando di stato (Slack riserva /status)
• Se i comandi nativi non sono abilitati, puoi eseguire un singolo comando slash configurato tramite channels.slack.slashCommand.
• I menu argomenti nativi ora adattano la propria strategia di rendering:
  • 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à
  • se i valori delle opzioni codificati superano i limiti di Slack, il flusso torna ai pulsanti
• Per payload di opzioni lunghi, i menu degli argomenti dei comandi slash usano una finestra di conferma prima di inviare un valore selezionato.

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

• agent:<agentId>:slack:slash:<userId>

​

Risposte interattive

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

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

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

• Questa è un’interfaccia 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 torna alla risposta testuale originale invece di inviare un payload blocks non valido.

​

Approvazioni exec in Slack

• Le approvazioni exec usano channels.slack.execApprovals.* per l’instradamento nativo DM/canale.
• Le approvazioni dei plugin possono comunque essere risolte tramite la stessa superficie di pulsanti nativa di Slack quando la richiesta arriva già in Slack e il tipo di id approvazione è plugin:.
• L’autorizzazione degli approvatori continua a essere applicata: solo gli utenti identificati come approvatori possono approvare o negare richieste tramite Slack.

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

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

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

​

Eventi e comportamento operativo

• Le modifiche/eliminazioni dei messaggi e le trasmissioni di thread vengono mappate in eventi di sistema.
• Gli eventi di aggiunta/rimozione delle reazioni vengono mappati in eventi di sistema.
• Gli eventi di entrata/uscita dei membri, creazione/rinomina del canale 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 topic/purpose del canale vengono trattati come contesto non attendibile e possono essere iniettati nel contesto di instradamento.
• Il thread starter e il seeding iniziale del contesto della cronologia del thread vengono filtrati dalle allowlist dei mittenti configurate quando applicabile.
• Le azioni dei blocchi e le interazioni modali emettono eventi di sistema strutturati Slack interaction: ... con campi payload avanzati:
  • azioni dei blocchi: valori selezionati, etichette, valori dei selettori e metadati workflow_*
  • eventi modali view_submission e view_closed con metadati del canale instradati e input del modulo

​

Riferimenti alla configurazione

• Riferimento della configurazione - Slack Campi Slack ad alto segnale:
  • modalità/autenticazione: mode, botToken, appToken, signingSecret, webhookPath, accounts.*
  • accesso DM: dm.enabled, dmPolicy, allowFrom (legacy: dm.policy, dm.allowFrom), dm.groupEnabled, dm.groupChannels
  • interruttore di compatibilità: dangerouslyAllowNameMatching (solo emergenza; tienilo disattivato se non necessario)
  • accesso ai canali: groupPolicy, channels.*, channels.*.users, channels.*.requireMention
  • threading/cronologia: replyToMode, replyToModeByChatType, thread.*, historyLimit, dmHistoryLimit, dms.*.historyLimit
  • consegna: textChunkLimit, chunkMode, mediaMaxMb, streaming, nativeStreaming
  • operazioni/funzionalità: configWrites, commands.native, slashCommand.*, actions.*, userToken, userTokenReadOnly

​

Risoluzione dei problemi

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

openclaw pairing list slack

​

Correlati

• Abbinamento
• Gruppi
• Sicurezza
• Instradamento dei canali
• Risoluzione dei problemi
• Configurazione
• Comandi slash