Slack

Prêt pour la production pour les messages directs et les canaux via les intégrations d’application Slack. Le mode par défaut est Socket Mode ; les URLs de requête HTTP sont également prises en charge. Le mode relais est destiné aux déploiements gérés où un routeur de confiance possède l’entrée Slack.

Choisir Socket Mode ou les URLs de requête HTTP

Les deux transports sont prêts pour la production et atteignent la parité fonctionnelle pour la messagerie, les commandes slash, App Home et l’interactivité. Choisissez en fonction de la forme du déploiement, pas des fonctionnalités.

Mode relais

Le mode relais sépare l’entrée Slack du gateway OpenClaw. Un routeur de confiance possède la connexion Slack Socket Mode unique, choisit un gateway de destination et transmet un événement typé via un websocket authentifié. Le gateway continue d’utiliser son jeton de bot pour les appels sortants à l’API Web Slack.

{  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 du relais doit utiliser wss:// sauf si elle cible localhost. Traitez le jeton bearer et la table de routage du routeur comme faisant partie de la frontière d’autorisation Slack : les événements routés entrent dans le gestionnaire normal des messages Slack comme des activations autorisées. Une slack_identity fournie par le routeur dans la trame websocket hello peut définir le nom d’utilisateur et l’icône sortants par défaut ; une identité explicite fournie par l’appelant reste prioritaire. La connexion relais se reconnecte avec le même délai de backoff borné que Socket Mode et efface l’identité fournie par le routeur chaque fois qu’elle se déconnecte.

Installation

Installez Slack avant de configurer le canal :

openclaw plugins install @openclaw/slack

plugins install enregistre et active le plugin. Le plugin ne fait toujours rien tant que vous n’avez pas configuré l’application Slack et les paramètres de canal ci-dessous. Consultez Plugins pour le comportement général des plugins et les règles d’installation.

Configuration rapide

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

Réglage du transport en mode Socket

OpenClaw définit par défaut le délai d’attente pong du client SDK Slack à 15 secondes pour le mode Socket. Remplacez les paramètres de transport uniquement lorsque vous avez besoin d’un réglage propre à un espace de travail ou à un hôte :

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

Utilisez ceci uniquement pour les espaces de travail en mode Socket qui consignent des délais d’attente websocket pong/server-ping de Slack ou qui s’exécutent sur des hôtes présentant une famine connue de la boucle d’événements. clientPingTimeout est l’attente du pong après l’envoi d’un ping client par le SDK ; serverPingTimeout est l’attente des pings serveur Slack. Les messages et événements de l’application restent de l’état applicatif, pas des signaux de vivacité du transport.

Remarques :

• socketMode est ignoré en mode HTTP Request URL.
• Les paramètres de base channels.slack.socketMode s’appliquent à tous les comptes Slack sauf remplacement. Les remplacements par compte utilisent channels.slack.accounts.<accountId>.socketMode ; comme il s’agit d’un remplacement d’objet, incluez chaque champ de réglage de socket souhaité pour ce compte.
• Seul clientPingTimeout possède une valeur par défaut OpenClaw (15000). serverPingTimeout et pingPongLoggingEnabled ne sont transmis au SDK Slack que lorsqu’ils sont configurés.
• Le délai de reprise au redémarrage du mode Socket commence autour de 2 secondes et plafonne autour de 30 secondes. Les échecs récupérables de démarrage, d’attente de démarrage et de déconnexion réessaient jusqu’à l’arrêt du canal. Les erreurs permanentes de compte et d’identifiants, comme une authentification invalide, des jetons révoqués ou des portées manquantes, échouent rapidement au lieu de réessayer indéfiniment.

Liste de contrôle du manifeste et des portées

Le manifeste de base de l’application Slack est le même pour le mode Socket et les HTTP Request URLs. Seul le bloc settings (et l’url de commande slash) diffère.

Manifeste de base (mode Socket par défaut) :

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

Pour le mode HTTP Request URLs, remplacez settings par la variante HTTP et ajoutez url à chaque commande slash. URL publique requise :

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

Paramètres de manifeste supplémentaires

Exposez différentes fonctionnalités qui étendent les valeurs par défaut ci-dessus.

Le manifeste par défaut active l’onglet Accueil de Slack App Home et s’abonne à app_home_opened. Lorsqu’un membre de l’espace de travail ouvre l’onglet Accueil, OpenClaw publie une vue d’accueil par défaut sûre avec views.publish ; aucune charge utile de conversation ni configuration privée n’est incluse. L’onglet Messages reste activé pour les messages directs Slack. Le manifeste active également les fils d’assistant Slack avec features.assistant_view, assistant:write, assistant_thread_started et assistant_thread_context_changed ; les fils d’assistant sont routés vers leurs propres sessions de fil OpenClaw et gardent le contexte de fil fourni par Slack disponible pour l’agent.

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

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

Modèle de jetons

• botToken + appToken sont requis pour le mode Socket.
• Le mode HTTP nécessite botToken + signingSecret.
• Le mode relais nécessite botToken ainsi que relay.url, relay.authToken et relay.gatewayId ; il n’utilise pas de jeton d’application ni de secret de signature.
• botToken, appToken, signingSecret, relay.authToken et userToken acceptent des chaînes en texte brut ou des objets SecretRef.
• Les jetons de configuration remplacent le repli env.
• Le repli env SLACK_BOT_TOKEN / SLACK_APP_TOKEN s’applique uniquement au compte par défaut.
• userToken est uniquement configurable (pas de repli env) et utilise par défaut un comportement en lecture seule (userTokenReadOnly: true).

Comportement de l’instantané de statut :

• L’inspection de compte Slack suit les champs *Source et *Status par identifiant (botToken, appToken, signingSecret, userToken).
• Le statut est available, configured_unavailable ou missing.
• configured_unavailable signifie que le compte est configuré via SecretRef ou une autre source de secret non inline, mais que le chemin de commande/runtime actuel n’a pas pu résoudre la valeur réelle.
• En mode HTTP, signingSecretStatus est inclus ; en mode Socket, la paire requise est botTokenStatus + appTokenStatus.

Actions et garde-fous

Les actions Slack sont contrôlées par channels.slack.actions.*.

Groupes d’actions disponibles dans l’outillage Slack actuel :

Les actions de message Slack actuelles incluent send, upload-file, download-file, read, edit, delete, pin, unpin, list-pins, member-info et emoji-list. download-file accepte les ID de fichiers Slack affichés dans les placeholders de fichiers entrants et renvoie des aperçus d’image pour les images ou des métadonnées de fichier local pour les autres types de fichiers.

Contrôle d’accès et routage

Fils de discussion, sessions et balises de réponse

• Les MP sont routés comme direct ; les canaux comme channel ; les MPIM comme group.
• Les liaisons de route Slack acceptent les ID de pairs bruts ainsi que les formes de cible Slack comme channel:C12345678, user:U12345678 et <@U12345678>.
• Avec la valeur par défaut session.dmScope=main, les MP Slack sont regroupés dans la session principale de l'agent.
• Sessions de canal : agent:<agentId>:slack:channel:<channelId>.
• Les messages ordinaires de niveau supérieur dans un canal restent sur la session par canal, même lorsque replyToMode n'est pas off.
• Les réponses dans un fil Slack utilisent le thread_ts Slack parent pour les suffixes de session (:thread:<threadTs>), même lorsque le filage des réponses sortantes est désactivé avec replyToMode="off".
• OpenClaw amorce une racine de canal de niveau supérieur éligible dans agent:<agentId>:slack:channel:<channelId>:thread:<rootTs> lorsque cette racine devrait démarrer un fil Slack visible, afin que la racine et les réponses ultérieures du fil partagent une seule session OpenClaw. Cela s'applique aux événements app_mention, aux correspondances explicites de bot ou de motif de mention configuré, ainsi qu'aux canaux requireMention: false avec un replyToMode différent de off.
• La valeur par défaut de channels.slack.thread.historyScope est thread ; celle de thread.inheritParent est false.
• channels.slack.thread.initialHistoryLimit contrôle combien de messages existants du fil sont récupérés lorsqu'une nouvelle session de fil démarre (par défaut 20 ; définissez 0 pour désactiver).
• channels.slack.thread.requireExplicitMention (par défaut false) : lorsque la valeur est true, supprime les mentions implicites dans les fils afin que le bot ne réponde qu'aux mentions explicites @bot dans les fils, même lorsque le bot a déjà participé au fil. Sans cela, les réponses dans un fil auquel le bot a participé contournent le filtrage requireMention.

Contrôles du filage des réponses :

• channels.slack.replyToMode : off|first|all|batched (par défaut off)
• channels.slack.replyToModeByChatType : par direct|group|channel
• solution de repli héritée pour les conversations directes : channels.slack.dm.replyToMode

Les balises de réponse manuelles sont prises en charge :

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

Pour les réponses explicites dans un fil Slack depuis l'outil message, définissez replyBroadcast: true avec action: "send" et threadId ou replyTo afin de demander à Slack de diffuser également la réponse du fil dans le canal parent. Cela correspond au drapeau reply_broadcast de chat.postMessage de Slack et n'est pris en charge que pour les envois de texte ou Block Kit, pas pour les téléversements de médias.

Lorsqu'un appel à l'outil message s'exécute dans un fil Slack et cible le même canal, OpenClaw hérite normalement du fil Slack actuel conformément à replyToMode. Définissez topLevel: true sur action: "send" ou action: "upload-file" pour forcer à la place un nouveau message dans le canal parent. threadId: null est accepté comme la même désactivation de niveau supérieur.

Réactions d'accusé de réception

ackReaction envoie un emoji d'accusé de réception pendant qu'OpenClaw traite un message entrant. ackReactionScope décide quand cet emoji est réellement envoyé.

Emoji (ackReaction)

Ordre de résolution :

• channels.slack.accounts.<accountId>.ackReaction
• channels.slack.ackReaction
• messages.ackReaction
• emoji de l'identité de l'agent en solution de repli (agents.list[].identity.emoji, sinon "eyes" / 👀)

Notes :

• Slack attend des codes courts (par exemple "eyes").
• Utilisez "" pour désactiver la réaction pour le compte Slack ou globalement.

Portée (messages.ackReactionScope)

Le fournisseur Slack lit la portée depuis messages.ackReactionScope (par défaut "group-mentions"). Il n'existe aujourd'hui aucun remplacement au niveau du compte Slack ou du canal Slack ; la valeur est globale au Gateway.

Valeurs :

• "all" : réagir dans les MP et les groupes.
• "direct" : réagir uniquement dans les MP.
• "group-all" : réagir à chaque message de groupe (pas dans les MP).
• "group-mentions" (par défaut) : réagir dans les groupes, mais seulement lorsque le bot est mentionné (ou dans les éléments mentionnables de groupe qui ont opté pour cela). Les MP sont exclus.
• "off" / "none" : ne jamais réagir.

{  messages: {    ackReaction: "eyes",    ackReactionScope: "all", // réagir dans les MP et les groupes  },}

Diffusion de texte en streaming

channels.slack.streaming contrôle le comportement de l'aperçu en direct :

• off : désactiver la diffusion de l'aperçu en direct.
• partial (par défaut) : remplacer le texte de l'aperçu par la dernière sortie partielle.
• block : ajouter des mises à jour d'aperçu fragmentées.
• progress : afficher le texte d'état de progression pendant la génération, puis envoyer le texte final.
• streaming.preview.toolProgress : lorsque l'aperçu de brouillon est actif, router les mises à jour d'outil/de progression vers le même message d'aperçu modifié (par défaut : true). Définissez false pour conserver des messages d'outil/de progression séparés.
• streaming.preview.commandText / streaming.progress.commandText : définissez sur status pour conserver des lignes de progression d'outil compactes tout en masquant le texte brut de commande/d'exécution (par défaut : raw).

Masquer le texte brut de commande/d'exécution tout en conservant des lignes de progression compactes :

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

channels.slack.streaming.nativeTransport contrôle la diffusion de texte native Slack lorsque channels.slack.streaming.mode vaut partial (par défaut : true).

Les cartes de tâches de progression natives Slack sont optionnelles pour le mode progression. Définissez channels.slack.streaming.progress.nativeTaskCards sur true avec channels.slack.streaming.mode="progress" pour envoyer une carte de plan/tâche native Slack pendant l'exécution du travail, puis mettre à jour la même carte de tâche à la fin. Sans ce drapeau, le mode progression conserve le comportement portable d'aperçu de brouillon.

• Un fil de réponse doit être disponible pour que la diffusion de texte native et l'état de fil de l'assistant Slack apparaissent. La sélection du fil suit toujours replyToMode.
• Les racines de canal, de conversation de groupe et de MP de niveau supérieur peuvent toujours utiliser l'aperçu de brouillon normal lorsque la diffusion native est indisponible ou qu'aucun fil de réponse n'existe.
• Les MP Slack de niveau supérieur restent sans fil par défaut ; ils n'affichent donc pas l'aperçu de diffusion/d'état natif de style fil de Slack. OpenClaw publie et modifie plutôt un aperçu de brouillon dans le MP.
• Les médias et charges utiles non textuelles reviennent à la livraison normale.
• Les finaux de média/erreur annulent les modifications d'aperçu en attente ; les finaux texte/bloc éligibles ne sont vidés que lorsqu'ils peuvent modifier l'aperçu sur place.
• Si la diffusion échoue au milieu d'une réponse, OpenClaw revient à la livraison normale pour les charges utiles restantes.

Utiliser l'aperçu de brouillon au lieu de la diffusion de texte native Slack :

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

Activer les cartes de tâches de progression natives Slack :

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

Clés héritées :

• channels.slack.streamMode (replace | status_final | append) est un alias d'exécution hérité pour channels.slack.streaming.mode.
• le booléen channels.slack.streaming est un alias d'exécution hérité pour channels.slack.streaming.mode et channels.slack.streaming.nativeTransport.
• l'ancien channels.slack.nativeStreaming est un alias d'exécution pour channels.slack.streaming.nativeTransport.
• Exécutez openclaw doctor --fix pour réécrire la configuration de streaming Slack persistée avec les clés canoniques.

Solution de repli de réaction de saisie

typingReaction ajoute une réaction temporaire au message Slack entrant pendant qu'OpenClaw traite une réponse, puis la supprime lorsque l'exécution se termine. C'est surtout utile en dehors des réponses dans un fil, qui utilisent un indicateur d'état par défaut "est en train d'écrire...".

Ordre de résolution :

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

Notes :

• Slack attend des codes courts (par exemple "hourglass_flowing_sand").
• La réaction est effectuée au mieux et le nettoyage est tenté automatiquement une fois le chemin de réponse ou d'échec terminé.

Médias, découpage et livraison

Commandes et comportement slash

Les commandes slash apparaissent dans Slack soit comme une seule commande configurée, soit comme plusieurs commandes natives. Configurez channels.slack.slashCommand pour modifier les valeurs par défaut des commandes :

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

/openclaw /help

Les commandes natives nécessitent des paramètres de manifeste supplémentaires dans votre application Slack et sont activées avec channels.slack.commands.native: true ou commands.native: true dans les configurations globales à la place.

• Le mode automatique des commandes natives est désactivé pour Slack, donc commands.native: "auto" n'active pas les commandes natives Slack.

/help

Les menus d'arguments natifs utilisent une stratégie de rendu adaptative qui affiche une fenêtre modale de confirmation avant de distribuer une valeur d'option sélectionnée :

• jusqu'à 5 options : blocs de boutons
• 6 à 100 options : menu de sélection statique
• plus de 100 options : sélection externe avec filtrage asynchrone des options lorsque les gestionnaires d'options d'interactivité sont disponibles
• limites Slack dépassées : les valeurs d'option encodées reviennent à des boutons

/think

Les sessions slash utilisent des clés isolées comme agent:<agentId>:slack:slash:<userId> et acheminent toujours les exécutions de commandes vers la session de conversation cible avec CommandTargetSessionKey.

Réponses interactives

Slack peut afficher des contrôles de réponse interactive rédigés par l’agent, mais cette fonctionnalité est désactivée par défaut. Pour les nouvelles sorties d’agent, de CLI et de Plugin, privilégiez les boutons ou blocs de sélection partagés presentation. Ils utilisent le même chemin d’interaction Slack tout en se dégradant aussi sur les autres canaux.

Activez-la globalement :

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

Ou activez-la pour un seul compte Slack :

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

Une fois activée, les agents peuvent toujours émettre des directives de réponse obsolètes propres à Slack :

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

Ces directives sont compilées en Slack Block Kit et acheminent les clics ou sélections via le chemin d’événement d’interaction Slack existant. Conservez-les pour les anciens prompts et les solutions de secours propres à Slack ; utilisez la présentation partagée pour les nouveaux contrôles portables.

Les API du compilateur de directives sont également obsolètes pour le nouveau code producteur :

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

Utilisez les charges utiles presentation et buildSlackPresentationBlocks(...) pour les nouveaux contrôles affichés dans Slack.

Remarques :

• Il s’agit d’une interface utilisateur héritée propre à Slack. Les autres canaux ne traduisent pas les directives Slack Block Kit dans leurs propres systèmes de boutons.
• Les valeurs de rappel interactif sont des jetons opaques générés par OpenClaw, et non des valeurs brutes rédigées par l’agent.
• Si les blocs interactifs générés dépassaient les limites de Slack Block Kit, OpenClaw revient à la réponse textuelle d’origine au lieu d’envoyer une charge utile de blocs invalide.

Soumissions de modales appartenant aux Plugins

Les plugins Slack qui enregistrent un gestionnaire interactif peuvent aussi recevoir les événements de cycle de vie de modale view_submission et view_closed avant qu’OpenClaw compacte la charge utile pour l’événement système visible par l’agent. Utilisez l’un de ces modèles de routage lors de l’ouverture d’une modale Slack :

• Définissez callback_id sur openclaw:<namespace>:<payload>.
• Ou conservez un callback_id existant et placez pluginInteractiveData: "<namespace>:<payload>" dans le private_metadata de la modale.

Le gestionnaire reçoit ctx.interaction.kind sous la forme view_submission ou view_closed, les inputs normalisées, et l’objet brut complet stateValues provenant de Slack. Le routage par callback-id seul suffit à invoquer le gestionnaire du Plugin ; incluez les champs de routage utilisateur/session private_metadata existants de la modale lorsque celle-ci doit aussi produire un événement système visible par l’agent. L’agent reçoit un événement système compact et expurgé Slack interaction: .... Si le gestionnaire renvoie systemEvent.summary, systemEvent.reference ou systemEvent.data, ces champs sont inclus dans cet événement compact afin que l’agent puisse référencer le stockage appartenant au Plugin sans voir la charge utile complète du formulaire.

Approbations natives dans Slack

Slack peut agir comme client d’approbation natif avec des boutons et interactions interactifs, au lieu de revenir à l’interface Web ou au terminal.

• Les approbations d’exécution et de Plugin peuvent s’afficher comme des prompts Slack-native Block Kit.
• channels.slack.execApprovals.* reste la configuration d’activation du client d’approbation d’exécution natif et de routage DM/canal.
• Les DM d’approbation d’exécution utilisent channels.slack.execApprovals.approvers ou commands.ownerAllowFrom.
• Les approbations de Plugin utilisent des boutons Slack-native lorsque Slack est activé comme client d’approbation natif pour la session d’origine, ou lorsque approvals.plugin route vers la session Slack d’origine ou vers une cible Slack.
• Les DM d’approbation de Plugin utilisent les approbateurs de Plugin Slack provenant de channels.slack.allowFrom, de allowFrom de compte nommé, ou de la route par défaut du compte.
• L’autorisation des approbateurs reste appliquée : les approbateurs d’exécution uniquement ne peuvent pas approuver les requêtes de Plugin sauf s’ils sont aussi approbateurs de Plugin.

Cela utilise la même surface partagée de bouton d’approbation que les autres canaux. Lorsque interactivity est activé dans les paramètres de votre application Slack, les prompts d’approbation s’affichent comme des boutons Block Kit directement dans la conversation. Lorsque ces boutons sont présents, ils constituent l’expérience d’approbation principale ; OpenClaw ne doit inclure une commande manuelle /approve que lorsque le résultat de l’outil indique que les approbations par chat ne sont pas disponibles ou que l’approbation manuelle est le seul chemin.

Chemin de configuration :

• channels.slack.execApprovals.enabled
• channels.slack.execApprovals.approvers (facultatif ; revient à commands.ownerAllowFrom lorsque possible)
• channels.slack.execApprovals.target (dm | channel | both, par défaut : dm)
• agentFilter, sessionFilter

Slack active automatiquement les approbations d’exécution natives lorsque enabled n’est pas défini ou vaut "auto" et qu’au moins un approbateur d’exécution est résolu. Slack peut aussi gérer les approbations de Plugin natives via ce chemin de client natif lorsque les approbateurs de Plugin Slack sont résolus et que la requête correspond aux filtres du client natif. Définissez enabled: false pour désactiver explicitement Slack comme client d’approbation natif. Définissez enabled: true pour forcer l’activation des approbations natives lorsque les approbateurs sont résolus. Désactiver les approbations d’exécution Slack ne désactive pas la livraison native des approbations de Plugin Slack activée via approvals.plugin ; la livraison des approbations de Plugin utilise plutôt les approbateurs de Plugin Slack.

Comportement par défaut sans configuration explicite d’approbation d’exécution Slack :

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

La configuration explicite Slack-native n’est nécessaire que lorsque vous voulez remplacer les approbateurs, ajouter des filtres ou opter pour la livraison dans le chat d’origine :

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

Le transfert partagé approvals.exec est distinct. Utilisez-le uniquement lorsque les prompts d’approbation d’exécution doivent aussi être routés vers d’autres chats ou vers des cibles hors bande explicites. Le transfert partagé approvals.plugin est également distinct ; la livraison native Slack supprime ce repli uniquement lorsque Slack peut gérer la requête d’approbation de Plugin nativement.

/approve dans le même chat fonctionne aussi dans les canaux Slack et les DM qui prennent déjà en charge les commandes. Consultez Approbations d’exécution pour le modèle complet de transfert des approbations.

Événements et comportement opérationnel

• Les modifications/suppressions de messages sont mappées en événements système.
• Les diffusions de fil (« Envoyer également au canal » pour les réponses de fil) sont traitées comme des messages utilisateur normaux.
• Les événements d’ajout/suppression de réaction sont mappés en événements système.
• Les événements d’arrivée/départ de membre, de création/renommage de canal et d’ajout/suppression d’épingle sont mappés en événements système.
• channel_id_changed peut migrer les clés de configuration de canal lorsque configWrites est activé.
• Les métadonnées de sujet/objectif de canal sont traitées comme un contexte non fiable et peuvent être injectées dans le contexte de routage.
• Le message initial de fil et l’amorçage du contexte d’historique initial du fil sont filtrés par les listes d’autorisation d’expéditeurs configurées lorsque cela s’applique.
• Les actions de bloc, raccourcis et interactions de modale émettent des événements système structurés Slack interaction: ... avec des champs de charge utile riches :
  • actions de bloc : valeurs sélectionnées, libellés, valeurs de sélecteur et métadonnées workflow_*
  • raccourcis globaux : métadonnées de rappel et d’acteur, routées vers la session directe de l’acteur
  • raccourcis de message : contexte de rappel, d’acteur, de canal, de fil et de message sélectionné
  • événements de modale view_submission et view_closed avec métadonnées de canal routées et entrées de formulaire

Définissez des raccourcis globaux ou de message dans la configuration de votre application Slack et utilisez n’importe quel ID de rappel non vide. OpenClaw acquitte les charges utiles de raccourci correspondantes, applique la même politique d’expéditeur DM/canal que les autres interactions Slack, et met en file l’événement nettoyé pour la session d’agent routée. Les ID de déclenchement et les URL de réponse sont expurgés du contexte de l’agent.

Référence de configuration

Référence principale : Référence de configuration - Slack.

Dépannage

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

openclaw channels status --probeopenclaw logs --followopenclaw doctor

openclaw pairing list slack

Référence de vision des pièces jointes

Slack peut joindre des médias téléchargés au tour de l’agent lorsque les téléchargements de fichiers Slack réussissent et que les limites de taille le permettent. Les fichiers image peuvent passer par le chemin de compréhension multimédia ou directement vers un modèle de réponse compatible avec la vision ; les autres fichiers sont conservés comme contexte de fichier téléchargeable plutôt que traités comme entrée image.

Types de médias pris en charge

Pipeline entrant

Lorsqu’un message Slack avec des pièces jointes arrive :

1. OpenClaw télécharge le fichier depuis l’URL privée de Slack à l’aide du token du bot.
2. Le fichier est écrit dans le magasin de médias en cas de réussite.
3. Les chemins des médias téléchargés et les types de contenu sont ajoutés au contexte entrant.
4. Les chemins de modèles/outils capables de traiter les images peuvent utiliser les pièces jointes image depuis ce contexte.
5. Les fichiers non image restent disponibles comme métadonnées de fichier ou références média pour les outils qui peuvent les gérer.

Héritage des pièces jointes de la racine du fil

Lorsqu’un message arrive dans un fil (avec un parent thread_ts) :

• Si la réponse elle-même n’a pas de média direct et que le message racine inclus contient des fichiers, Slack peut hydrater les fichiers racine comme contexte de départ du fil.
• Les pièces jointes directes de la réponse ont priorité sur les pièces jointes du message racine.
• Un message racine qui contient uniquement des fichiers et aucun texte est représenté par un placeholder de pièce jointe afin que le repli puisse toujours inclure ses fichiers.

Gestion de plusieurs pièces jointes

Lorsqu’un seul message Slack contient plusieurs pièces jointes de fichier :

• Chaque pièce jointe est traitée indépendamment par le pipeline multimédia.
• Les références média téléchargées sont agrégées dans le contexte du message.
• L’ordre de traitement suit l’ordre des fichiers Slack dans la charge utile de l’événement.
• L’échec du téléchargement d’une pièce jointe ne bloque pas les autres.

Limites de taille, de téléchargement et de modèle

• Limite de taille : 20 MB par fichier par défaut. Configurable via channels.slack.mediaMaxMb.
• Échecs de téléchargement : Les fichiers que Slack ne peut pas servir, les URL expirées, les fichiers inaccessibles, les fichiers trop volumineux et les réponses HTML d’authentification/connexion Slack sont ignorés au lieu d’être signalés comme formats non pris en charge.
• Modèle de vision : L’analyse d’image utilise le modèle de réponse actif lorsqu’il prend en charge la vision, ou le modèle d’image configuré dans agents.defaults.imageModel.

Limites connues

Documentation associée

• Pipeline de compréhension multimédia
• Outil PDF
• Epic : #51349 — activation de la vision pour les pièces jointes Slack
• Tests de régression : #51353
• Vérification en direct : #51354

Associé