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.

Elegir Socket Mode o URL de solicitud HTTP

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

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},"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" },},},}JSON5openclaw config patch --file ./slack.socket.patch.json5 --dry-runopenclaw 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",},},}JSON5openclaw config patch --file ./slack.http.patch.json5 --dry-runopenclaw config patch --file ./slack.http.patch.json5

openclaw gateway

Ajuste del transporte en 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 de transporte solo cuando necesites ajustes específicos del espacio de trabajo o del host:

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

Úsalo solo para espacios de trabajo en Socket Mode que registren tiempos de espera de pong/ping de servidor de websocket de Slack o que se ejecuten en hosts con bloqueo conocido del bucle de eventos. clientPingTimeout es la espera del 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 app siguen siendo estado de la aplicación, no señales de actividad del transporte.

Lista de comprobación de manifiesto y alcances

El manifiesto base de la app de Slack es el mismo para Socket Mode y para las URL de solicitud HTTP. Solo difieren el bloque settings (y la url del comando de barra diagonal).

Manifiesto base (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    },    "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"      ]    }  }}

Para el modo de URL de solicitud HTTP, reemplaza settings por la variante HTTP y añade url a cada comando de barra diagonal. Se requiere una 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",        "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 útil de conversación ni configuración privada. La pestaña Messages permanece habilitada para los mensajes directos de 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"}]}

Modelo de tokens

• botToken + appToken son obligatorios para Socket Mode.
• El modo HTTP requiere botToken + signingSecret.
• botToken, appToken, signingSecret y userToken aceptan cadenas de texto sin formato u objetos SecretRef.
• Los tokens de configuración anulan el respaldo de env.
• El respaldo de env SLACK_BOT_TOKEN / SLACK_APP_TOKEN se aplica solo a la cuenta predeterminada.
• userToken (xoxp-...) solo se configura por configuración (sin respaldo de env) y usa de forma predeterminada un comportamiento de solo lectura (userTokenReadOnly: true).

Comportamiento de instantánea de estado:

• La inspección de cuenta 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 integrada en línea, 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 puertas

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

Grupos de acciones disponibles en las herramientas actuales de Slack:

Las acciones actuales de mensajes de Slack incluyen send, upload-file, download-file, read, edit, delete, pin, unpin, list-pins, member-info y emoji-list. download-file acepta IDs de archivo de Slack que se muestran en marcadores de posición de archivos entrantes y devuelve vistas previas de imágenes 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 DM se enrutan como direct; los canales como channel; los MPIM como group.
• Los vínculos de ruta de Slack aceptan IDs de par sin procesar además de formas de destino de Slack como channel:C12345678, user:U12345678 y <@U12345678>.
• Con session.dmScope=main predeterminado, los DM de Slack se contraen a la sesión principal del agente.
• Sesiones de canal: agent:<agentId>:slack:channel:<channelId>.
• Las respuestas de hilo pueden crear sufijos de sesión de hilo (:thread:<threadTs>) cuando corresponde.
• En canales donde OpenClaw maneja mensajes de nivel superior sin requerir una mención explícita, los replyToMode que no sean off enrutan cada raíz manejada a agent:<agentId>:slack:channel:<channelId>:thread:<rootTs> para que el hilo visible de Slack se asigne a una sesión de OpenClaw desde el primer turno.
• 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 de hilo existentes se recuperan cuando se inicia una nueva sesión de hilo (predeterminado 20; establece 0 para deshabilitarlo).
• channels.slack.thread.requireExplicitMention (predeterminado false): cuando es true, suprime las menciones implícitas de hilo para que el bot solo responda a menciones explícitas de @bot dentro de hilos, incluso cuando el bot ya participó en el hilo. Sin esto, las respuestas en un hilo en el que participó el bot omiten la puerta de requireMention.

Controles de hilos de respuesta:

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

Se admiten etiquetas de respuesta manuales:

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

Para respuestas explícitas de hilo 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 de hilo al canal principal. 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 a 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 principal. 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.

Orden de resolución:

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

Notas:

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

Streaming de texto

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

• off: deshabilitar el streaming de vista previa en vivo.
• partial (predeterminado): reemplazar el texto de vista previa por la salida parcial más reciente.
• block: anexar actualizaciones de vista previa por fragmentos.
• progress: mostrar texto de estado de progreso mientras se genera y luego enviar el texto final.
• streaming.preview.toolProgress: cuando la vista previa de borrador está activa, enrutar las actualizaciones de herramienta/progreso al mismo mensaje de vista previa editado (predeterminado: true). Establece false para mantener mensajes de herramienta/progreso separados.
• streaming.preview.commandText / streaming.progress.commandText: establece en status para conservar líneas compactas de progreso de herramientas mientras se oculta el texto sin procesar de command/exec (predeterminado: raw).

Ocultar texto sin procesar de command/exec mientras se conservan 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 (predeterminado: true).

• Debe haber un hilo de respuesta disponible para que aparezcan el streaming de texto nativo y el estado de hilo del asistente de Slack. La selección de hilo sigue obedeciendo replyToMode.
• Las raíces de canal, chat de grupo y DM de nivel superior pueden seguir usando la vista previa de borrador normal cuando el streaming nativo no está disponible o no existe ningún hilo de respuesta.
• Los DM de Slack de nivel superior permanecen fuera de hilo de forma predeterminada, por lo que no muestran la vista previa de streaming/estado nativa con 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 útiles que no son texto recurren a la entrega normal.
• Los finales de medios/errores cancelan las ediciones de vista previa pendientes; los finales de texto/bloque elegibles se vacían solo cuando pueden editar la vista previa en el mismo lugar.
• Si el streaming falla a mitad de respuesta, OpenClaw recurre a la entrega normal para las cargas útiles restantes.

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

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

Claves heredadas:

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

Alternativa de reacción de escritura

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

Orden de resolución:

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

Notas:

• Slack espera shortcodes (por ejemplo, "hourglass_flowing_sand").
• La reacción es de mejor esfuerzo y la limpieza se intenta automáticamente después de que se completa la respuesta o la ruta de fallo.

Medios, fragmentación y entrega

Comandos y comportamiento de barra diagonal

Los comandos de barra diagonal 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 de manifiesto adicionales 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 los comandos nativos de Slack.

/help

Los menús de argumentos nativos usan una estrategia de renderizado adaptable 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 excedidos: los valores de opción codificados recurren a botones

/think

Las sesiones de barra diagonal usan claves aisladas como agent:<agentId>:slack:slash:<userId> y siguen enrutando las ejecuciones de comandos a la sesión de conversación de destino mediante CommandTargetSessionKey.

Respuestas interactivas

Slack puede renderizar controles de respuesta interactiva creados por agentes, pero esta característica está deshabilitada de forma predeterminada.

Habilítala globalmente:

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

O habilítala solo para una cuenta de Slack:

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

Cuando está habilitada, los agentes pueden emitir directivas de respuesta solo para 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 los clics o selecciones de vuelta a través de la ruta existente de eventos de interacción de Slack.

Notas:

• Esta es una interfaz de usuario específica de Slack. Otros canales no traducen directivas de Slack Block Kit a sus propios sistemas de botones.
• Los valores de callback interactivos son tokens opacos generados por OpenClaw, no valores sin procesar creados por agentes.
• Si los bloques interactivos generados superaran los límites de Slack Block Kit, OpenClaw recurre a la respuesta de texto original en lugar de enviar una carga útil de bloques no válida.

Aprobaciones de exec en Slack

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

• Las aprobaciones de exec usan channels.slack.execApprovals.* para el enrutamiento nativo de DM/canal.
• Las aprobaciones de Plugin aún pueden resolverse mediante 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 de aprobadores se sigue aplicando: solo los usuarios identificados como aprobadores pueden aprobar o denegar solicitudes mediante Slack.

Esto usa la misma superficie compartida de botones de aprobación que otros canales. Cuando interactivity está habilitado en los ajustes de tu aplicación de Slack, los prompts de aprobación se renderizan como botones de Block Kit directamente en la conversación. Cuando esos botones están presentes, son la UX de aprobación principal; 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 sea posible)
• channels.slack.execApprovals.target (dm | channel | both, predeterminado: dm)
• agentFilter, sessionFilter

Slack habilita automáticamente las aprobaciones de exec nativas cuando enabled no está definido o es "auto" y se resuelve al menos un aprobador. Establece enabled: false para deshabilitar explícitamente Slack como cliente de aprobación nativo. Establece enabled: true para forzar las aprobaciones nativas cuando se resuelven aprobadores.

Comportamiento predeterminado sin configuración explícita de aprobación de exec de Slack:

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

La configuración nativa de Slack explícita solo es necesaria cuando quieres sobrescribir aprobadores, agregar filtros u 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 exec 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; los botones nativos de Slack aún pueden resolver aprobaciones de Plugin cuando esas solicitudes ya llegan a Slack.

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

Eventos y comportamiento operativo

• Las ediciones/eliminaciones de mensajes se asignan a eventos del sistema.
• Las difusiones de hilo (respuestas de hilo con "Also send to channel") se procesan como mensajes de usuario normales.
• 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 canal y agregar/eliminar fijación se asignan a eventos del 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 iniciador del hilo y la inicialización del contexto de historial inicial del hilo se filtran mediante listas de permitidos de remitentes configuradas cuando corresponda.
• Las acciones de bloque y las interacciones modales emiten eventos del sistema estructurados Slack interaction: ... con campos de carga útil enriquecidos:
  • acciones de bloque: valores seleccionados, etiquetas, valores de selector y metadatos workflow_*
  • eventos modales view_submission y view_closed con metadatos de canal enrutado y entradas de formulario

Referencia de configuración

Referencia principal: Referencia de configuración - Slack.

Solución de problemas

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 realizan correctamente y los límites de tamaño lo permiten. Los archivos de imagen pueden pasarse por la ruta de comprensión de medios o directamente a un modelo de respuesta compatible con 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 archivos adjuntos:

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

Herencia de adjuntos del mensaje raíz del hilo

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

• Si la respuesta en sí no tiene medios directos y el mensaje raíz incluido tiene archivos, Slack puede hidratar los archivos raíz como contexto del inicio 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 el mecanismo de respaldo aún pueda incluir sus archivos.

Manejo de varios adjuntos

Cuando un solo mensaje de Slack contiene varios archivos adjuntos:

• 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 útil 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 URLs expiradas, 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 notificarse 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
• Epic: #51349 — habilitación de visión para adjuntos de Slack
• Pruebas de regresión: #51353
• Verificación en vivo: #51354

Relacionado