Slack

Prêt pour la production pour les messages privés et les canaux via les intégrations d’app Slack. Le mode par défaut est Socket Mode ; les URL de requête HTTP sont également prises en charge.

# Choisir Socket Mode ou les URL de requête HTTP

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

# 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
},
"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

# Réglage du transport en mode Socket

OpenClaw définit par défaut le délai d’expiration du pong du client du SDK Slack à 15 secondes pour le mode Socket. Ne remplacez les paramètres de transport que lorsque vous avez besoin d’un réglage propre à l’espace de travail ou à l’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 journalisent des délais d’expiration pong/server-ping du WebSocket Slack ou qui s’exécutent sur des hôtes présentant une privation 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 un état applicatif, pas des signaux de disponibilité du transport.

# 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 URL de requête HTTP. Seul le bloc settings (et l’url de la 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
    },
    "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"
      ]
    }
  }
}

Pour le mode URL de requête HTTP, 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",
        "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 l’accueil de l’application Slack et s’abonne à app_home_opened. Lorsqu’un membre de l’espace de travail ouvre l’onglet Accueil, OpenClaw publie une vue 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.

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

# Modèle de jetons

• botToken + appToken sont requis pour Socket Mode.
• Le mode HTTP nécessite botToken + signingSecret.
• botToken, appToken, signingSecret et userToken acceptent les chaînes en texte clair ou les 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 (xoxp-...) est uniquement configurable (pas de repli env) et utilise par défaut un comportement en lecture seule (userTokenReadOnly: true).

Comportement de l’instantané d’état :

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

# Actions et barrières

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 espaces réservés de fichiers entrants et renvoie des aperçus d’images 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, sessions et balises de réponse

• Les DM 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 telles que channel:C12345678, user:U12345678 et <@U12345678>.
• Avec session.dmScope=main par défaut, les DM Slack se replient sur la session principale de l’agent.
• Sessions de canal : agent:<agentId>:slack:channel:<channelId>.
• Les réponses de fil peuvent créer des suffixes de session de fil (:thread:<threadTs>) le cas échéant.
• La valeur par défaut de channels.slack.thread.historyScope est thread ; la valeur par défaut de thread.inheritParent est false.
• channels.slack.thread.initialHistoryLimit contrôle combien de messages de fil existants 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 (false par défaut) : lorsque true, supprime les mentions implicites dans les fils afin que le bot ne réponde qu’aux mentions @bot explicites 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 la barrière requireMention.

Contrôles de fil de réponse :

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

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

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

# Réactions d’accusé de réception

ackReaction envoie un emoji d’accusé de réception pendant qu’OpenClaw traite un message entrant.

Ordre de résolution :

• channels.slack.accounts.<accountId>.ackReaction
• channels.slack.ackReaction
• messages.ackReaction
• repli sur l’emoji d’identité de l’agent (agents.list[].identity.emoji, sinon "👀")

Notes :

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

# Diffusion de texte en continu

channels.slack.streaming contrôle le comportement d’aperçu en direct :

• off : désactiver la diffusion d’aperçu en direct.
• partial (par défaut) : remplacer le texte d’aperçu par la dernière sortie partielle.
• block : ajouter des mises à jour d’aperçu par fragments.
• 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, route 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 compactes de progression d’outil tout en masquant le texte brut de commande/exec (par défaut : raw).

Masquer le texte brut de commande/exec 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 est partial (par défaut : true).

• Un fil de réponse doit être disponible pour que la diffusion de texte native et l’état de fil d’assistant Slack apparaissent. La sélection du fil suit toujours replyToMode.
• Les racines de canal, de discussion de groupe et de DM de premier niveau 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 DM Slack de premier niveau restent hors fil par défaut, donc ils n’affichent pas l’aperçu de flux/état natif de style fil de Slack ; OpenClaw publie et modifie plutôt un aperçu de brouillon dans le DM.
• Les médias et charges utiles non textuelles se replient sur la livraison normale.
• Les finaux de média/erreur annulent les modifications d’aperçu en attente ; les finaux de texte/bloc éligibles ne sont vidés que lorsqu’ils peuvent modifier l’aperçu sur place.
• Si la diffusion échoue au milieu de la réponse, OpenClaw se replie sur 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,
      },
    },
  },
}

Anciennes clés :

• 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 vers les clés canoniques.

# Repli de la 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 « is typing... » par défaut.

Ordre de résolution :

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

Notes :

• Slack attend des shortcodes (par exemple "hourglass_flowing_sand").
• La réaction est fournie 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 modale de confirmation avant d’envoyer 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 se rabattent sur 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 interactifs rédigés par l’agent, mais cette fonctionnalité est désactivée par défaut.

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 l’option activée, les agents peuvent émettre des directives de réponse 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 les sélections via le chemin d’événements d’interaction Slack existant.

Notes :

• Il s’agit d’une interface utilisateur 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épassent les limites de Slack Block Kit, OpenClaw se rabat sur la réponse textuelle originale au lieu d’envoyer une charge utile de blocs invalide.

# Approbations exec dans Slack

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

• Les approbations exec utilisent channels.slack.execApprovals.* pour le routage natif des messages directs/canaux.
• Les approbations de Plugin peuvent toujours se résoudre via la même surface de boutons native Slack lorsque la demande arrive déjà dans Slack et que le type d’ID d’approbation est plugin:.
• L’autorisation de l’approbateur reste appliquée : seuls les utilisateurs identifiés comme approbateurs peuvent approuver ou refuser des demandes via Slack.

Cela utilise la même surface partagée de boutons d’approbation que les autres canaux. Lorsque interactivity est activé dans les paramètres de votre application Slack, les invites d’approbation s’affichent sous forme de 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 sont indisponibles ou que l’approbation manuelle est le seul chemin.

Chemin de configuration :

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

Slack active automatiquement les approbations exec natives lorsque enabled n’est pas défini ou vaut "auto" et qu’au moins un approbateur est résolu. Définissez enabled: false pour désactiver explicitement Slack comme client d’approbation natif. Définissez enabled: true pour forcer les approbations natives lorsque des approbateurs sont résolus.

Comportement par défaut sans configuration explicite des approbations exec Slack :

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

Une configuration native Slack explicite n’est nécessaire que lorsque vous souhaitez 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 invites d’approbation exec doivent également être acheminées vers d’autres chats ou des cibles hors bande explicites. Le transfert partagé approvals.plugin est également distinct ; les boutons natifs Slack peuvent toujours résoudre les approbations de Plugin lorsque ces demandes arrivent déjà dans Slack.

La commande /approve dans le même chat fonctionne aussi dans les canaux Slack et les messages directs qui prennent déjà en charge les commandes. Voir Approbations exec pour le modèle complet de transfert d’approbations.

# Événements et comportement opérationnel

• Les modifications/suppressions de messages sont mappées vers des événements système.
• Les diffusions de fil (« Also send to channel » pour les réponses dans un fil) sont traitées comme des messages utilisateur normaux.
• Les événements d’ajout/suppression de réactions sont mappés vers des é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 vers des é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.
• L’amorçage du démarreur de fil et du contexte initial d’historique de fil est filtré par les listes d’autorisation d’expéditeurs configurées, le cas échéant.
• Les actions de bloc et les 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_*
  • événements de modale view_submission et view_closed avec métadonnées de canal routé et entrées de formulaire

# Référence de configuration

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

# Dépannage

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

openclaw pairing list slack

# Référence de vision pour les pièces jointes

Slack peut joindre les 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 des médias ou être transmis directement à 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 de fichier arrive :

1. OpenClaw télécharge le fichier depuis l’URL privée de Slack à l’aide du jeton du bot (xoxb-...).
2. Le fichier est écrit dans le magasin de médias en cas de succès.
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èle/outil compatibles avec 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 de média pour les outils qui peuvent les traiter.

# 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 du message initial 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 ne contient que des fichiers et pas de texte est représenté avec un placeholder de pièce jointe afin que le fallback puisse tout de même 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 de médias.
• Les références de médias téléchargés 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 Mo 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 des médias
• 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é