​

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

​

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

​

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 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 dans la configuration (pas de repli env) et utilise par défaut un comportement en lecture seule (userTokenReadOnly: true).
• Facultatif : ajoutez chat:write.customize si vous souhaitez que les messages sortants utilisent l’identité active de l’agent (champ username et icône personnalisés). icon_emoji utilise la syntaxe :emoji_name:.

• L’inspection de compte Slack suit des champs *Source et *Status par identifiant (botToken, appToken, signingSecret, userToken).
• Le statut vaut available, configured_unavailable ou missing.
• configured_unavailable signifie que le compte est configuré via SecretRef ou une autre source secrète 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 Socket Mode, la paire requise est botTokenStatus + appTokenStatus.

​

Actions et contrôles

​

Contrôle d’accès et routage

​

Fils, sessions et balises de réponse

• Les DMs sont routés comme direct ; les canaux comme channel ; les MPIMs comme group.
• Avec la valeur par défaut session.dmScope=main, les DMs Slack se replient sur la session principale de l’agent.
• Sessions de canal : agent:<agentId>:slack:channel:<channelId>.
• Les réponses dans un fil 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 lorsqu’une nouvelle session de fil démarre (par défaut 20 ; définissez 0 pour désactiver).

• channels.slack.replyToMode: off|first|all (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 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 blocs.
• progress : afficher un texte d’état 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 apparaisse. La sélection du fil suit toujours replyToMode. Sans cela, l’aperçu de brouillon normal est utilisé.
• Les médias et 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: "partial",
      nativeStreaming: false,
    },
  },
}

• channels.slack.streamMode (replace | status_final | append) est migré automatiquement vers channels.slack.streaming.
• le booléen channels.slack.streaming est migré automatiquement vers channels.slack.nativeStreaming.

​

Repli par réaction de frappe

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

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

​

Médias, découpage et livraison

​

Commandes et comportement slash

• 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 commandes slash correspondantes dans Slack (noms /<command>), avec une exception :
  • enregistrez /agentstatus pour la commande de statut (Slack réserve /status)
• Si les commandes natives ne sont pas activées, vous pouvez exécuter une seule commande slash 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
  • de 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
  • si les valeurs d’option encodées dépassent les limites Slack, le flux revient aux boutons
• Pour les longues charges utiles d’option, les menus d’arguments des commandes slash 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 interface 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 DM/canal natif.
• 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 ; repli vers commands.ownerAllowFrom lorsque possible)
• channels.slack.execApprovals.target (dm | channel | both, 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 diffusions de fils sont mappées vers des événements système.
• 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 membres, de création/renommage de canal et d’ajout/suppression d’épingles 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/objectifs de canal sont traitées comme un contexte non fiable et peuvent être injectées dans le contexte de routage.
• Le message de départ d’un fil et l’initialisation du contexte d’historique de fil sont filtrés par les listes d’autorisation d’expéditeurs configurées lorsque cela s’applique.
• Les actions de bloc et interactions modales é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 modaux view_submission et view_closed avec métadonnées de canal routées et entrées de formulaire

​

Pointeurs de 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 DM : dm.enabled, dmPolicy, allowFrom (hérité : dm.policy, dm.allowFrom), dm.groupEnabled, dm.groupChannels
  • bascule de compatibilité : dangerouslyAllowNameMatching (à n’utiliser qu’en dernier recours ; laissez désactivé sauf nécessité)
  • accès canal : groupPolicy, channels.*, channels.*.users, channels.*.requireMention
  • fils/historique : replyToMode, replyToModeByChatType, thread.*, historyLimit, dmHistoryLimit, dms.*.historyLimit
  • livraison : textChunkLimit, chunkMode, mediaMaxMb, streaming, nativeStreaming
  • 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

​

Lié

• Pairing
• Groups
• Security
• Channel routing
• Troubleshooting
• Configuration
• Slash commands