Slack

Listo para producción para mensajes directos y canales mediante integraciones de apps de Slack. El modo predeterminado es Socket Mode; también se admiten URL de solicitud HTTP. El modo relay está pensado para despliegues gestionados donde un enrutador de confianza controla la entrada de Slack.

Elegir Socket Mode o URL de solicitud HTTP

Ambos transportes están listos para producción y alcanzan paridad de funciones para mensajería, slash commands, App Home e interactividad. Elige según la forma del despliegue, no según las funciones.

Modo relay

El modo relay separa la entrada de Slack del gateway de OpenClaw. Un enrutador de confianza controla la única conexión de Slack Socket Mode, elige un gateway de destino y reenvía un evento tipado por un websocket autenticado. El gateway sigue usando su token de bot para llamadas salientes a la API web de 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",      },    },  },}

La URL relay debe usar wss:// a menos que apunte a localhost. Trata el token bearer y la tabla de rutas del enrutador como parte del límite de autorización de Slack: los eventos enrutados entran en el manejador normal de mensajes de Slack como activaciones autorizadas. Un slack_identity proporcionado por el enrutador en el marco websocket hello puede establecer el nombre de usuario y el icono salientes predeterminados; una identidad explícita suministrada por el llamador sigue teniendo prioridad. La conexión relay se reconecta con el mismo tiempo de retroceso limitado usado por Socket Mode y borra la identidad proporcionada por el enrutador cada vez que se desconecta.

Instalación

Instala Slack antes de configurar el canal:

openclaw plugins install @openclaw/slack

plugins install registra y habilita el plugin. El plugin todavía no hace nada hasta que configures la app de Slack y los ajustes del canal a continuación. Consulta Plugins para conocer el comportamiento general de plugins y las reglas de instalación.

Configuración rápida

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

Ajuste del transporte de Socket Mode

OpenClaw establece de forma predeterminada el tiempo de espera de pong del cliente del SDK de Slack en 15 segundos para Socket Mode. Sobrescribe la configuración del transporte solo cuando necesites un ajuste específico del espacio de trabajo o del host:

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

Usa esto solo para espacios de trabajo con Socket Mode que registren tiempos de espera de pong de websocket o de ping del servidor de Slack, o que se ejecuten en hosts con inanición conocida del bucle de eventos. clientPingTimeout es la espera de pong después de que el SDK envía un ping de cliente; serverPingTimeout es la espera de pings del servidor de Slack. Los mensajes y eventos de la aplicación siguen siendo estado de la aplicación, no señales de actividad del transporte.

Notas:

• socketMode se ignora en el modo HTTP Request URL.
• La configuración base de channels.slack.socketMode se aplica a todas las cuentas de Slack salvo que se sobrescriba. Las sobrescrituras por cuenta usan channels.slack.accounts.<accountId>.socketMode; como se trata de una sobrescritura de objeto, incluye todos los campos de ajuste de socket que quieras para esa cuenta.
• Solo clientPingTimeout tiene un valor predeterminado de OpenClaw (15000). serverPingTimeout y pingPongLoggingEnabled se pasan al SDK de Slack solo cuando están configurados.
• El retroceso de reinicio de Socket Mode comienza alrededor de 2 segundos y tiene un límite aproximado de 30 segundos. Los fallos recuperables de inicio, espera de inicio y desconexión se reintentan hasta que el canal se detiene. Los errores permanentes de cuenta y credenciales, como autenticación no válida, tokens revocados o alcances faltantes, fallan rápido en lugar de reintentarse indefinidamente.

Lista de comprobación de manifiesto y alcances

El manifiesto base de la aplicación de Slack es el mismo para Socket Mode y HTTP Request URLs. Solo difiere el bloque settings (y la url del comando de barra).

Manifiesto base (valor predeterminado de Socket Mode):

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

Para el modo HTTP Request URLs, reemplaza settings por la variante HTTP y agrega url a cada comando de barra. Se requiere URL pública:

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

Configuración adicional del manifiesto

Expón distintas funciones que amplían los valores predeterminados anteriores.

El manifiesto predeterminado habilita la pestaña Home de Slack App Home y se suscribe a app_home_opened. Cuando un miembro del espacio de trabajo abre la pestaña Home, OpenClaw publica una vista Home predeterminada segura con views.publish; no se incluye ninguna carga de conversación ni configuración privada. La pestaña Messages permanece habilitada para los DM de Slack. El manifiesto también habilita los hilos de asistente de Slack con features.assistant_view, assistant:write, assistant_thread_started y assistant_thread_context_changed; los hilos de asistente se enrutan a sus propias sesiones de hilo de OpenClaw y mantienen el contexto del hilo proporcionado por Slack disponible para el agente.

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

Modelo de tokens

• botToken + appToken son obligatorios para Socket Mode.
• El modo HTTP requiere botToken + signingSecret.
• El modo de relé requiere botToken más relay.url, relay.authToken y relay.gatewayId; no usa token de aplicación ni secreto de firma.
• botToken, appToken, signingSecret, relay.authToken y userToken aceptan cadenas de texto sin formato u objetos SecretRef.
• Los tokens de configuración anulan la alternativa de entorno.
• La alternativa de entorno SLACK_BOT_TOKEN / SLACK_APP_TOKEN se aplica solo a la cuenta predeterminada.
• userToken solo se configura por configuración (sin alternativa de entorno) y su comportamiento predeterminado es de solo lectura (userTokenReadOnly: true).

Comportamiento de la instantánea de estado:

• 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 de secreto no integrada, pero la ruta actual de comando/runtime no pudo resolver el valor real.
• En modo HTTP, se incluye signingSecretStatus; en Socket Mode, el par requerido es botTokenStatus + appTokenStatus.

Acciones y controles

Las acciones de Slack se controlan mediante channels.slack.actions.*.

Grupos de acciones disponibles en las herramientas actuales de Slack:

Las acciones de mensaje actuales de Slack incluyen send, upload-file, download-file, read, edit, delete, pin, unpin, list-pins, member-info y emoji-list. download-file acepta los ID de archivo de Slack mostrados en los marcadores de posición de archivos entrantes y devuelve vistas previas de imagen para imágenes o metadatos de archivo local para otros tipos de archivo.

Control de acceso y enrutamiento

Hilos, sesiones y etiquetas de respuesta

• Los DMs se enrutan como direct; los canales como channel; los MPIMs como group.
• Los enlaces de ruta de Slack aceptan IDs de pares sin procesar y formas de destino de Slack como channel:C12345678, user:U12345678 y <@U12345678>.
• Con el valor predeterminado session.dmScope=main, los DMs de Slack se agrupan en la sesión principal del agente.
• Sesiones de canal: agent:<agentId>:slack:channel:<channelId>.
• Los mensajes ordinarios de nivel superior en canales permanecen en la sesión por canal, incluso cuando replyToMode no es off.
• Las respuestas en hilos de Slack usan el thread_ts de Slack del mensaje padre para los sufijos de sesión (:thread:<threadTs>), incluso cuando los hilos de respuesta saliente están deshabilitados con replyToMode="off".
• OpenClaw inicializa una raíz de canal de nivel superior elegible en agent:<agentId>:slack:channel:<channelId>:thread:<rootTs> cuando se espera que esa raíz inicie un hilo visible de Slack, de modo que la raíz y las respuestas posteriores del hilo compartan una sesión de OpenClaw. Esto se aplica a eventos app_mention, coincidencias explícitas de bot o de patrones de mención configurados, y canales con requireMention: false y replyToMode distinto de off.
• El valor predeterminado de channels.slack.thread.historyScope es thread; el valor predeterminado de thread.inheritParent es false.
• channels.slack.thread.initialHistoryLimit controla cuántos mensajes existentes del hilo se recuperan cuando se inicia una nueva sesión de hilo (valor predeterminado 20; establece 0 para deshabilitarlo).
• channels.slack.thread.requireExplicitMention (valor predeterminado false): cuando es true, suprime las menciones implícitas del hilo para que el bot solo responda a menciones explícitas @bot dentro de hilos, incluso cuando el bot ya participó en el hilo. Sin esto, las respuestas en un hilo con participación del bot omiten la compuerta requireMention.

Controles de hilos de respuesta:

• channels.slack.replyToMode: off|first|all|batched (valor predeterminado off)
• channels.slack.replyToModeByChatType: por cada direct|group|channel
• alternativa heredada para chats directos: channels.slack.dm.replyToMode

Se admiten etiquetas de respuesta manuales:

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

Para respuestas explícitas en hilos de Slack desde la herramienta message, establece replyBroadcast: true con action: "send" y threadId o replyTo para pedir a Slack que también difunda la respuesta del hilo al canal padre. Esto se asigna al indicador reply_broadcast de chat.postMessage de Slack y solo se admite para envíos de texto o Block Kit, no para cargas de medios.

Cuando una llamada de la herramienta message se ejecuta dentro de un hilo de Slack y apunta al mismo canal, OpenClaw normalmente hereda el hilo actual de Slack según replyToMode. Establece topLevel: true en action: "send" o action: "upload-file" para forzar un nuevo mensaje en el canal padre. threadId: null se acepta como la misma exclusión de nivel superior.

Reacciones de confirmación

ackReaction envía un emoji de confirmación mientras OpenClaw procesa un mensaje entrante. ackReactionScope decide cuándo se envía realmente ese emoji.

Emoji (ackReaction)

Orden de resolución:

• channels.slack.accounts.<accountId>.ackReaction
• channels.slack.ackReaction
• messages.ackReaction
• alternativa de emoji de identidad del agente (agents.list[].identity.emoji; de lo contrario, "eyes" / 👀)

Notas:

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

Alcance (messages.ackReactionScope)

El proveedor de Slack lee el alcance desde messages.ackReactionScope (valor predeterminado "group-mentions"). Actualmente no hay sobrescritura por cuenta de Slack ni por canal de Slack; el valor es global para el Gateway.

Valores:

• "all": reaccionar en DMs y grupos.
• "direct": reaccionar solo en DMs.
• "group-all": reaccionar en cada mensaje de grupo (sin DMs).
• "group-mentions" (valor predeterminado): reaccionar en grupos, pero solo cuando se menciona al bot (o en mentionables de grupo que optaron por participar). Los DMs quedan excluidos.
• "off" / "none": no reaccionar nunca.

{  messages: {    ackReaction: "eyes",    ackReactionScope: "all", // react in DMs and groups  },}

Streaming de texto

channels.slack.streaming controla el comportamiento de vista previa en vivo:

• off: deshabilita el streaming de vista previa en vivo.
• partial (valor predeterminado): reemplaza el texto de vista previa por la salida parcial más reciente.
• block: añade actualizaciones de vista previa en fragmentos.
• progress: muestra texto de estado de progreso mientras se genera y luego envía el texto final.
• streaming.preview.toolProgress: cuando la vista previa de borrador está activa, enruta las actualizaciones de herramientas/progreso al mismo mensaje de vista previa editado (valor predeterminado: true). Establécelo en false para conservar mensajes de herramientas/progreso separados.
• streaming.preview.commandText / streaming.progress.commandText: establece en status para mantener líneas compactas de progreso de herramientas mientras se oculta el texto sin procesar de comandos/exec (valor predeterminado: raw).

Ocultar el texto sin procesar de comandos/exec y mantener líneas compactas de progreso:

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

channels.slack.streaming.nativeTransport controla el streaming de texto nativo de Slack cuando channels.slack.streaming.mode es partial (valor predeterminado: true).

Las tarjetas de tareas de progreso nativas de Slack son opcionales para el modo de progreso. Establece channels.slack.streaming.progress.nativeTaskCards en true con channels.slack.streaming.mode="progress" para enviar una tarjeta de plan/tarea nativa de Slack mientras el trabajo está en curso y luego actualizar la misma tarjeta de tarea al completarse. Sin este indicador, el modo de progreso conserva el comportamiento portátil de vista previa de borrador.

• Debe haber un hilo de respuesta disponible para que aparezcan el streaming de texto nativo y el estado de hilo de asistente de Slack. La selección de hilo aún sigue replyToMode.
• Los canales, chats grupales y raíces de DMs de nivel superior aún pueden usar la vista previa de borrador normal cuando el streaming nativo no está disponible o no existe un hilo de respuesta.
• Los DMs de Slack de nivel superior permanecen fuera de hilo de forma predeterminada, por lo que no muestran la vista previa nativa de streaming/estado al estilo de hilo de Slack; en su lugar, OpenClaw publica y edita una vista previa de borrador en el DM.
• Los medios y las cargas no textuales vuelven a la entrega normal.
• Los finales de medios/error cancelan las ediciones de vista previa pendientes; los finales de texto/bloque elegibles solo se vacían cuando pueden editar la vista previa en el lugar.
• Si el streaming falla a mitad de respuesta, OpenClaw vuelve a la entrega normal para las cargas restantes.

Usar vista previa de borrador en lugar de streaming de texto nativo de Slack:

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

Optar por tarjetas de tareas de progreso nativas de Slack:

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

Claves heredadas:

• channels.slack.streamMode (replace | status_final | append) es un alias de runtime heredado para channels.slack.streaming.mode.
• El booleano channels.slack.streaming es un alias de runtime heredado para channels.slack.streaming.mode y channels.slack.streaming.nativeTransport.
• La clave heredada channels.slack.nativeStreaming es un alias de runtime para channels.slack.streaming.nativeTransport.
• Ejecuta openclaw doctor --fix para reescribir la configuración persistida de streaming de Slack a las claves canónicas.

Alternativa de reacción de escritura

typingReaction añade una reacción temporal al mensaje entrante de Slack mientras OpenClaw procesa una respuesta y luego la elimina cuando finaliza la ejecución. Esto es más útil fuera de las respuestas en hilos, que usan un indicador de estado predeterminado "está escribiendo...".

Orden de resolución:

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

Notas:

• Slack espera códigos cortos (por ejemplo "hourglass_flowing_sand").
• La reacción se realiza con el mejor esfuerzo y se intenta limpiarla automáticamente después de que se complete la respuesta o la ruta de fallo.

Medios, fragmentación y entrega

Comandos y comportamiento slash

Los comandos slash aparecen en Slack como un único comando configurado o como varios comandos nativos. Configura channels.slack.slashCommand para cambiar los valores predeterminados del comando:

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

/openclaw /help

Los comandos nativos requieren ajustes adicionales del manifiesto en tu aplicación de Slack y se habilitan con channels.slack.commands.native: true o commands.native: true en configuraciones globales.

• El modo automático de comandos nativos está desactivado para Slack, por lo que commands.native: "auto" no habilita comandos nativos de Slack.

/help

Los menús de argumentos nativos usan una estrategia de renderizado adaptativa que muestra un modal de confirmación antes de despachar un valor de opción seleccionado:

• 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 hay manejadores de opciones de interactividad disponibles
• límites de Slack superados: los valores de opción codificados vuelven a botones

/think

Las sesiones slash usan claves aisladas como agent:<agentId>:slack:slash:<userId> y aun así enrutan las ejecuciones de comandos a la sesión de conversación de destino usando CommandTargetSessionKey.

Respuestas interactivas

Slack puede renderizar controles de respuesta interactiva creados por agentes, pero esta función está deshabilitada de forma predeterminada. Para salida nueva de agente, CLI y Plugin, prefiere los botones compartidos de presentation o bloques de selección. Usan la misma ruta de interacción de Slack y también se degradan en otros canales.

Habilítalo globalmente:

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

O habilítalo solo para una cuenta de Slack:

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

Cuando está habilitado, los agentes aún pueden emitir directivas de respuesta obsoletas exclusivas de Slack:

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

Estas directivas se compilan en Slack Block Kit y enrutan clics o selecciones de vuelta a través de la ruta existente de eventos de interacción de Slack. Consérvalas para prompts antiguos y vías de escape específicas de Slack; usa la presentación compartida para controles portables nuevos.

Las API del compilador de directivas también están obsoletas para nuevo código productor:

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

Usa cargas útiles de presentation y buildSlackPresentationBlocks(...) para nuevos controles renderizados por Slack.

Notas:

• Esta es una UI heredada específica de Slack. Otros canales no traducen 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 creados por el agente.
• Si los bloques interactivos generados excedieran los límites de Slack Block Kit, OpenClaw vuelve a la respuesta de texto original en lugar de enviar una carga útil de bloques no válida.

Envíos de modales propiedad del Plugin

Los plugins de Slack que registran un manejador interactivo también pueden recibir eventos de ciclo de vida de modal view_submission y view_closed antes de que OpenClaw compacte la carga útil para el evento de sistema visible para el agente. Usa uno de estos patrones de enrutamiento al abrir un modal de Slack:

• Establece callback_id en openclaw:<namespace>:<payload>.
• O conserva un callback_id existente y coloca pluginInteractiveData: "<namespace>:<payload>" en el private_metadata del modal.

El manejador recibe ctx.interaction.kind como view_submission o view_closed, inputs normalizados y el objeto completo sin procesar stateValues de Slack. El enrutamiento solo por callback-id basta para invocar el manejador del Plugin; incluye los campos existentes de enrutamiento de usuario/sesión de private_metadata del modal cuando el modal también deba producir un evento de sistema visible para el agente. El agente recibe un evento de sistema compacto y redactado Slack interaction: .... Si el manejador devuelve systemEvent.summary, systemEvent.reference o systemEvent.data, esos campos se incluyen en ese evento compacto para que el agente pueda referenciar almacenamiento propiedad del Plugin sin ver la carga útil completa del formulario.

Aprobaciones nativas en Slack

Slack puede actuar como cliente de aprobación nativo con botones e interacciones interactivas, en lugar de recurrir a la UI web o la terminal.

• Las aprobaciones de ejecución y Plugin pueden renderizarse como prompts Slack-native Block Kit.
• channels.slack.execApprovals.* sigue siendo la configuración de habilitación del cliente nativo de aprobación de ejecuciones y de enrutamiento a DM/canal.
• Los DM de aprobación de ejecución usan channels.slack.execApprovals.approvers o commands.ownerAllowFrom.
• Las aprobaciones de Plugin usan botones nativos de Slack cuando Slack está habilitado como cliente de aprobación nativo para la sesión de origen, o cuando approvals.plugin enruta a la sesión de Slack de origen o a un destino de Slack.
• Los DM de aprobación de Plugin usan aprobadores del Plugin de Slack de channels.slack.allowFrom, allowFrom de cuenta con nombre o la ruta predeterminada de la cuenta.
• La autorización del aprobador sigue aplicándose: los aprobadores solo de ejecución no pueden aprobar solicitudes de Plugin a menos que también sean aprobadores de Plugin.

Esto usa la misma superficie compartida de botones de aprobación que otros canales. Cuando interactivity está habilitado en la configuración de tu app de Slack, los prompts de aprobación se renderizan como botones Block Kit directamente en la conversación. Cuando esos botones están presentes, son la UX principal de aprobación; OpenClaw solo debe incluir un comando manual /approve cuando el resultado de la herramienta indique que las aprobaciones por chat no están disponibles o que la aprobación manual es la única ruta.

Ruta de configuración:

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

Slack habilita automáticamente las aprobaciones nativas de ejecución cuando enabled no está definido o es "auto" y se resuelve al menos un aprobador de ejecución. Slack también puede manejar aprobaciones nativas de Plugin a través de esta ruta de cliente nativo cuando se resuelven aprobadores del Plugin de Slack y la solicitud coincide con los filtros de cliente nativo. Establece enabled: false para deshabilitar explícitamente Slack como cliente de aprobación nativo. Establece enabled: true para forzar las aprobaciones nativas cuando se resuelvan aprobadores. Deshabilitar las aprobaciones de ejecución de Slack no deshabilita la entrega de aprobaciones nativas de Plugin en Slack habilitada mediante approvals.plugin; la entrega de aprobaciones de Plugin usa aprobadores del Plugin de Slack en su lugar.

Comportamiento predeterminado sin configuración explícita de aprobaciones de ejecución de Slack:

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

La configuración explícita nativa de Slack solo es necesaria cuando quieres anular aprobadores, añadir filtros o optar por la entrega en el chat de origen:

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

El reenvío compartido de approvals.exec es independiente. Úsalo solo cuando los prompts de aprobación de ejecución también deban enrutarse a otros chats o destinos explícitos fuera de banda. El reenvío compartido de approvals.plugin también es independiente; la entrega nativa de Slack suprime ese fallback solo cuando Slack puede manejar la solicitud de aprobación de Plugin de forma nativa.

/approve en el mismo chat también funciona en canales de Slack y DM que ya admiten comandos. Consulta Aprobaciones de ejecución para ver el modelo completo de reenvío de aprobaciones.

Eventos y comportamiento operativo

• Las ediciones/eliminaciones de mensajes se asignan a eventos de sistema.
• Las difusiones de hilos (respuestas de hilo con "Also send to channel") se procesan como mensajes de usuario normales.
• Los eventos de añadir/quitar reacciones se asignan a eventos de sistema.
• Los eventos de incorporación/salida de miembros, canal creado/renombrado y añadir/quitar pin se asignan a eventos de sistema.
• channel_id_changed puede migrar claves de configuración de canal 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 inicio del hilo y la siembra de contexto del historial inicial del hilo se filtran por las listas de permitidos de remitentes configuradas cuando corresponde.
• Las acciones de bloque, atajos e interacciones de modal emiten eventos de sistema estructurados Slack interaction: ... con campos de carga útil enriquecidos:
  • acciones de bloque: valores seleccionados, etiquetas, valores de selectores y metadatos workflow_*
  • atajos globales: metadatos de callback y actor, enrutados a la sesión directa del actor
  • atajos de mensaje: callback, actor, canal, hilo y contexto del mensaje seleccionado
  • eventos de modal view_submission y view_closed con metadatos de canal enrutado y entradas de formulario

Define atajos globales o de mensaje en la configuración de tu app de Slack y usa cualquier ID de callback no vacío. OpenClaw reconoce las cargas útiles de atajos coincidentes, aplica la misma política de remitente de DM/canal que otras interacciones de Slack y encola el evento saneado para la sesión de agente enrutada. Los ID de disparador y las URL de respuesta se redactan del contexto del agente.

Referencia de configuración

Referencia principal: Referencia de configuración - Slack.

Solución de problemas

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

openclaw channels status --probeopenclaw logs --followopenclaw doctor

openclaw pairing list slack

Referencia de visión para adjuntos

Slack puede adjuntar medios descargados al turno del agente cuando las descargas de archivos de Slack se completan correctamente y los límites de tamaño lo permiten. Los archivos de imagen pueden pasar por la ruta de comprensión de medios o directamente a un modelo de respuesta con capacidad de visión; otros archivos se conservan como contexto de archivo descargable en lugar de tratarse como entrada de imagen.

Tipos de medios compatibles

Canalización de entrada

Cuando llega un mensaje de Slack con adjuntos de archivo:

1. OpenClaw descarga el archivo desde la URL privada de Slack usando el token del bot.
2. El archivo se escribe en el almacén de medios si la operación se completa correctamente.
3. Las rutas de medios descargados y los tipos de contenido se agregan al contexto de entrada.
4. Las rutas de modelo/herramienta con capacidad de imagen pueden usar adjuntos de imagen de ese contexto.
5. Los archivos que no son imágenes siguen disponibles como metadatos de archivo o referencias de medios para herramientas que pueden manejarlos.

Herencia de adjuntos de la raíz del hilo

Cuando llega un mensaje en un hilo (tiene un padre thread_ts):

• Si la respuesta no tiene medios directos y el mensaje raíz incluido tiene archivos, Slack puede hidratar los archivos raíz como contexto del iniciador del hilo.
• Los adjuntos directos de la respuesta tienen prioridad sobre los adjuntos del mensaje raíz.
• Un mensaje raíz que solo tiene archivos y no texto se representa con un marcador de posición de adjunto para que la alternativa aún pueda incluir sus archivos.

Manejo de varios adjuntos

Cuando un solo mensaje de Slack contiene varios adjuntos de archivo:

• Cada adjunto se procesa de forma independiente mediante la canalización de medios.
• Las referencias de medios descargados se agregan al contexto del mensaje.
• El orden de procesamiento sigue el orden de archivos de Slack en la carga del evento.
• Un fallo en la descarga de un adjunto no bloquea los demás.

Límites de tamaño, descarga y modelo

• Límite de tamaño: predeterminado de 20 MB por archivo. Configurable mediante channels.slack.mediaMaxMb.
• Fallos de descarga: los archivos que Slack no puede servir, las URL vencidas, los archivos inaccesibles, los archivos demasiado grandes y las respuestas HTML de autenticación/inicio de sesión de Slack se omiten en lugar de reportarse como formatos no compatibles.
• Modelo de visión: el análisis de imágenes usa el modelo de respuesta activo cuando admite visión, o el modelo de imagen configurado en agents.defaults.imageModel.

Límites conocidos

Documentación relacionada

• Canalización de comprensión de medios
• Herramienta PDF
• Épica: #51349 — habilitación de visión para adjuntos de Slack
• Pruebas de regresión: #51353
• Verificación en vivo: #51354

Relacionado