​

Slack

​

Configuración rápida

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

​

Lista de verificación de manifiesto y scopes

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

​

Modelo de tokens

• botToken + appToken son obligatorios para Socket Mode.
• El modo HTTP requiere botToken + signingSecret.
• botToken, appToken, signingSecret y userToken aceptan cadenas en texto sin formato u objetos SecretRef.
• Los tokens de configuración reemplazan el respaldo por variables de entorno.
• El respaldo por variables de entorno SLACK_BOT_TOKEN / SLACK_APP_TOKEN se aplica solo a la cuenta predeterminada.
• userToken (xoxp-...) es solo de configuración (sin respaldo por variables de entorno) y usa de forma predeterminada comportamiento de solo lectura (userTokenReadOnly: true).
• Opcional: agrega chat:write.customize si quieres que los mensajes salientes usen la identidad del agente activo (username e icono personalizados). icon_emoji usa la sintaxis :emoji_name:.

• La inspección de cuentas de Slack rastrea campos *Source y *Status por credencial (botToken, appToken, signingSecret, userToken).
• El estado es available, configured_unavailable o missing.
• configured_unavailable significa que la cuenta está configurada mediante SecretRef u otra fuente secreta no inline, pero la ruta actual del comando/tiempo de ejecución no pudo resolver el valor real.
• En modo HTTP, se incluye signingSecretStatus; en Socket Mode, el par requerido es botTokenStatus + appTokenStatus.

​

Acciones y controles

​

Control de acceso y enrutamiento

​

Hilos, sesiones y etiquetas de respuesta

• Los mensajes directos se enrutan como direct; los canales como channel; los MPIM como group.
• Con el valor predeterminado session.dmScope=main, los mensajes directos de Slack se agrupan en la sesión principal del agente.
• Sesiones de canal: agent:<agentId>:slack:channel:<channelId>.
• Las respuestas en hilo pueden crear sufijos de sesión de hilo (:thread:<threadTs>) cuando corresponde.
• channels.slack.thread.historyScope usa thread de forma predeterminada; thread.inheritParent usa false de forma predeterminada.
• channels.slack.thread.initialHistoryLimit controla cuántos mensajes existentes del hilo se recuperan cuando comienza una nueva sesión de hilo (predeterminado 20; establece 0 para deshabilitarlo).

• channels.slack.replyToMode: off|first|all (predeterminado off)
• channels.slack.replyToModeByChatType: por direct|group|channel
• respaldo heredado para chats directos: channels.slack.dm.replyToMode

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

​

Reacciones de acuse

• channels.slack.accounts.<accountId>.ackReaction
• channels.slack.ackReaction
• messages.ackReaction
• respaldo con el emoji de identidad del agente (agents.list[].identity.emoji, si no "👀")

• Slack espera shortcodes (por ejemplo "eyes").
• Usa "" para deshabilitar la reacción para la cuenta de Slack o globalmente.

​

Streaming de texto

• off: deshabilita el streaming de vista previa en vivo.
• partial (predeterminado): reemplaza el texto de vista previa con la salida parcial más reciente.
• block: agrega actualizaciones de vista previa fragmentadas.
• progress: muestra texto de estado de progreso mientras se genera y luego envía el texto final.

• Debe haber un hilo de respuesta disponible para que aparezca el streaming nativo de texto. La selección del hilo sigue usando replyToMode. Sin uno, se usa la vista previa normal del borrador.
• Los medios y las cargas no textuales recurren a la entrega normal.
• Si el streaming falla a mitad de la respuesta, OpenClaw recurre a la entrega normal para las cargas restantes.

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

• channels.slack.streamMode (replace | status_final | append) se migra automáticamente a channels.slack.streaming.
• el booleano channels.slack.streaming se migra automáticamente a channels.slack.nativeStreaming.

​

Respaldo de reacción de escritura

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

• Slack espera shortcodes (por ejemplo "hourglass_flowing_sand").
• La reacción es best-effort y se intenta limpiar automáticamente después de la respuesta o cuando se completa la ruta de error.

​

Multimedia, fragmentación y entrega

​

Comandos y comportamiento slash

• El modo automático de comandos nativos está desactivado para Slack (commands.native: "auto" no habilita los comandos nativos de Slack).
• Habilita los manejadores de comandos nativos de Slack con channels.slack.commands.native: true (o global commands.native: true).
• Cuando los comandos nativos están habilitados, registra comandos slash coincidentes en Slack (nombres /<command>), con una excepción:
  • registra /agentstatus para el comando de estado (Slack reserva /status)
• Si los comandos nativos no están habilitados, puedes ejecutar un único comando slash configurado mediante channels.slack.slashCommand.
• Los menús nativos de argumentos ahora adaptan su estrategia de renderizado:
  • hasta 5 opciones: bloques de botones
  • 6-100 opciones: menú de selección estática
  • más de 100 opciones: selección externa con filtrado asíncrono de opciones cuando están disponibles los manejadores de opciones de interactividad
  • si los valores de opción codificados superan los límites de Slack, el flujo recurre a botones
• Para cargas largas de opciones, los menús de argumentos de comandos slash usan un diálogo de confirmación antes de despachar un valor seleccionado.

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

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

​

Respuestas interactivas

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

• Esta es una UI específica de Slack. Los demás canales no traducen las directivas de Slack Block Kit a sus propios sistemas de botones.
• Los valores de callback interactivo son tokens opacos generados por OpenClaw, no valores sin procesar escritos por el agente.
• Si los bloques interactivos generados superan los límites de Slack Block Kit, OpenClaw recurre a la respuesta de texto original en lugar de enviar una carga de bloques no válida.

​

Aprobaciones de exec en Slack

• Las aprobaciones de exec usan channels.slack.execApprovals.* para el enrutamiento nativo de mensajes directos/canales.
• Las aprobaciones de plugins aún pueden resolverse a través de la misma superficie de botones nativa de Slack cuando la solicitud ya llega a Slack y el tipo de ID de aprobación es plugin:.
• La autorización del aprobador sigue aplicándose: solo los usuarios identificados como aprobadores pueden aprobar o denegar solicitudes a través de Slack.

• channels.slack.execApprovals.enabled
• channels.slack.execApprovals.approvers (opcional; usa como respaldo commands.ownerAllowFrom cuando es posible)
• channels.slack.execApprovals.target (dm | channel | both, predeterminado: dm)
• agentFilter, sessionFilter

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

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

​

Eventos y comportamiento operativo

• Las ediciones/eliminaciones de mensajes y las difusiones de hilos se asignan a eventos del sistema.
• Los eventos de agregar/eliminar reacción se asignan a eventos del sistema.
• Los eventos de unión/salida de miembros, creación/cambio de nombre de canales y agregar/eliminar fijados se asignan a eventos del sistema.
• channel_id_changed puede migrar claves de configuración de canales cuando configWrites está habilitado.
• Los metadatos de tema/propósito del canal se tratan como contexto no confiable y pueden inyectarse en el contexto de enrutamiento.
• El iniciador del hilo y la siembra inicial del contexto del historial del hilo se filtran mediante las allowlists configuradas de remitentes cuando corresponde.
• Las acciones de bloques e interacciones modales emiten eventos estructurados del sistema Slack interaction: ... con campos de carga enriquecidos:
  • acciones de bloques: valores seleccionados, etiquetas, valores de selector y metadatos workflow_*
  • eventos modales view_submission y view_closed con metadatos de canal enrutados e inputs de formularios

​

Punteros a la referencia de configuración

• Referencia de configuración - Slack Campos de Slack de alta relevancia:
  • modo/autenticación: mode, botToken, appToken, signingSecret, webhookPath, accounts.*
  • acceso a mensajes directos: dm.enabled, dmPolicy, allowFrom (heredado: dm.policy, dm.allowFrom), dm.groupEnabled, dm.groupChannels
  • interruptor de compatibilidad: dangerouslyAllowNameMatching (último recurso; mantenlo desactivado salvo que sea necesario)
  • acceso a canales: groupPolicy, channels.*, channels.*.users, channels.*.requireMention
  • hilos/historial: replyToMode, replyToModeByChatType, thread.*, historyLimit, dmHistoryLimit, dms.*.historyLimit
  • entrega: textChunkLimit, chunkMode, mediaMaxMb, streaming, nativeStreaming
  • operaciones/funciones: configWrites, commands.native, slashCommand.*, actions.*, userToken, userTokenReadOnly

​

Solución de problemas

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

openclaw pairing list slack

​

Relacionado

• Emparejamiento
• Grupos
• Seguridad
• Enrutamiento de canales
• Solución de problemas
• Configuración
• Comandos slash