​

Slack

​

Configuration rapide

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

openclaw gateway

​

Liste de vérification du manifeste et des portées

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

{
  "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,
        "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",
        "users:read"
      ]
    }
  },
  "settings": {
    "event_subscriptions": {
      "request_url": "https://gateway-host.example.com/slack/events",
      "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"
      ]
    },
    "interactivity": {
      "is_enabled": true,
      "request_url": "https://gateway-host.example.com/slack/events",
      "message_menu_options_url": "https://gateway-host.example.com/slack/events"
    }
  }
}

​

Modèle de jeton

• botToken + appToken sont requis pour Socket Mode.
• Le mode HTTP nécessite botToken + signingSecret.
• botToken, appToken, signingSecret et userToken acceptent des chaînes en clair ou des objets SecretRef.
• Les jetons de config remplacent la variable d’environnement de secours.
• La variable d’environnement de secours SLACK_BOT_TOKEN / SLACK_APP_TOKEN s’applique uniquement au compte par défaut.
• userToken (xoxp-...) est uniquement configurable dans la config (pas de variable d’environnement de secours) et adopte par défaut un comportement en lecture seule (userTokenReadOnly: true).

• L’inspection du compte Slack suit, pour chaque identifiant, les champs *Source et *Status (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 inline, mais que le chemin de commande ou 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 garde-fous

​

Contrôle d’accès et routage

​

Fils, sessions et balises de réponse

• Les messages privés sont routés comme direct ; les canaux comme channel ; les MPIM comme group.
• Avec la valeur par défaut session.dmScope=main, les messages privés Slack sont regroupés dans la session principale de l’agent.
• Sessions de canal : agent:<agentId>:slack:channel:<channelId>.
• Les réponses dans les fils peuvent créer des suffixes de session de fil (:thread:<threadTs>) lorsque c’est applicable.
• La valeur par défaut de channels.slack.thread.historyScope est thread ; celle de thread.inheritParent est false.
• channels.slack.thread.initialHistoryLimit contrôle le nombre de messages existants du fil récupérés au démarrage d’une nouvelle session de fil (valeur par défaut 20 ; définissez 0 pour désactiver).
• channels.slack.thread.requireExplicitMention (par défaut false) : quand 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 s’il a déjà participé au fil. Sans cela, les réponses dans un fil auquel le bot a participé contournent le garde-fou requireMention.

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

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

​

Réactions d’accusé de réception

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

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

​

Streaming de texte

• off : désactiver le streaming de l’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 blocs.
• progress : afficher un texte de progression pendant la génération, puis envoyer le texte final.

• Un fil de réponse doit être disponible pour que le streaming de texte natif et l’état du fil assistant Slack s’affichent. La sélection du fil continue toutefois de suivre replyToMode.
• Les racines de canaux et de discussions de groupe peuvent toujours utiliser l’aperçu brouillon normal lorsque le streaming natif n’est pas disponible.
• Les messages privés Slack de niveau supérieur restent hors fil par défaut, ils n’affichent donc pas l’aperçu de style fil ; utilisez des réponses en fil ou typingReaction si vous souhaitez y afficher une progression visible.
• Les médias et les charges utiles non textuelles reviennent à la livraison normale.
• Si le streaming échoue en cours de réponse, OpenClaw revient à la livraison normale pour les charges utiles restantes.

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

• channels.slack.streamMode (replace | status_final | append) est migré automatiquement vers channels.slack.streaming.mode.
• le booléen channels.slack.streaming est migré automatiquement vers channels.slack.streaming.mode et channels.slack.streaming.nativeTransport.
• la clé héritée channels.slack.nativeStreaming est migrée automatiquement vers channels.slack.streaming.nativeTransport.

​

Repli de réaction de saisie

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

• Slack attend des shortcodes (par exemple "hourglass_flowing_sand").
• La réaction est appliquée au mieux et son nettoyage est tenté automatiquement une fois la réponse ou le chemin d’échec terminé.

​

Médias, découpage et livraison

​

Commandes et comportement des slash commands

• Le mode automatique des commandes natives est désactivé pour Slack (commands.native: "auto" n’active pas les commandes natives Slack).
• Activez les gestionnaires de commandes Slack natives avec channels.slack.commands.native: true (ou globalement commands.native: true).
• Lorsque les commandes natives sont activées, enregistrez les slash commands correspondantes dans Slack (noms /<command>), avec une exception :
  • enregistrez /agentstatus pour la commande d’état (Slack réserve /status)
• Si les commandes natives ne sont pas activées, vous pouvez exécuter une seule slash command configurée via channels.slack.slashCommand.
• Les menus d’arguments natifs adaptent désormais leur stratégie de rendu :
  • 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 des gestionnaires d’options d’interactivité sont disponibles
  • si les valeurs d’option encodées dépassent les limites de Slack, le flux revient aux boutons
• Pour les longues charges utiles d’options, les menus d’arguments des slash commands utilisent une boîte de dialogue de confirmation avant d’envoyer une valeur sélectionnée.

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

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

​

Réponses interactives

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

• Il s’agit d’une UI spécifique à Slack. Les autres canaux ne traduisent pas les directives Slack Block Kit vers 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 revient à la réponse texte d’origine au lieu d’envoyer une charge utile de blocs invalide.

​

Approbations exec dans Slack

• Les approbations exec utilisent channels.slack.execApprovals.* pour le routage natif en message privé/canal.
• Les approbations de plugin peuvent toujours être résolues 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 des approbateurs reste appliquée : seuls les utilisateurs identifiés comme approbateurs peuvent approuver ou refuser des demandes via Slack.

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

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

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

​

Événements et comportement opérationnel

• Les modifications/suppressions de messages et les diffusions de fil sont mappées en événements système.
• 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/objectifs de canal sont traitées comme un contexte non fiable et peuvent être injectées dans le contexte de routage.
• Le message initial du fil et l’amorçage initial du contexte d’historique du fil sont filtrés selon les listes d’autorisation d’expéditeur configurées, lorsque applicable.
• Les actions de bloc et les interactions modales émettent des événements système structurés Slack interaction: ... avec des champs riches de charge utile :
  • actions de bloc : valeurs sélectionnées, libellés, valeurs du sélecteur et métadonnées workflow_*
  • événements modaux view_submission et view_closed avec métadonnées de canal routées et entrées de formulaire

​

Pointeurs vers la référence de configuration

• Référence de configuration - Slack Champs Slack à fort signal :
  • mode/auth : mode, botToken, appToken, signingSecret, webhookPath, accounts.*
  • accès aux messages privés : dm.enabled, dmPolicy, allowFrom (hérité : dm.policy, dm.allowFrom), dm.groupEnabled, dm.groupChannels
  • option de compatibilité : dangerouslyAllowNameMatching (dernier recours ; laissez-la désactivée sauf nécessité)
  • accès aux canaux : groupPolicy, channels.*, channels.*.users, channels.*.requireMention
  • fils/historique : replyToMode, replyToModeByChatType, thread.*, historyLimit, dmHistoryLimit, dms.*.historyLimit
  • livraison : textChunkLimit, chunkMode, mediaMaxMb, streaming, streaming.nativeTransport
  • opérations/fonctionnalités : configWrites, commands.native, slashCommand.*, actions.*, userToken, userTokenReadOnly

​

Dépannage

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

openclaw pairing list slack

​

Liens connexes

• Association
• Groupes
• Sécurité
• Routage des canaux
• Dépannage
• Configuration
• Commandes slash