Slack

La compatibilidad con Slack abarca los mensajes directos y los canales mediante integraciones de aplicaciones de Slack. El transporte predeterminado es Socket Mode; también se admiten las URL de solicitud HTTP. El modo de retransmisión está destinado a despliegues administrados en los que un enrutador de confianza controla la entrada de Slack.

Elección de un transporte

Socket Mode y las URL de solicitud HTTP ofrecen las mismas funciones de mensajería, comandos con barra diagonal, App Home e interactividad. Elija según la arquitectura del despliegue, no según las funciones.

Modo de retransmisión

El modo de retransmisión separa la entrada de Slack del Gateway de OpenClaw. Un enrutador de confianza controla la única conexión de Socket Mode de Slack, elige un Gateway de destino y reenvía un evento tipado mediante un websocket autenticado. El Gateway sigue utilizando su propio token de bot para las 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 de retransmisión debe usar wss://, salvo que apunte a localhost. Considere el token de portador y la tabla de rutas del enrutador como parte del límite de autorización de Slack: los eventos enrutados entran en el controlador normal de mensajes de Slack como activaciones autorizadas. Un slack_identity proporcionado por el enrutador en la trama hello del websocket puede establecer el nombre de usuario y el icono salientes predeterminados; una identidad explícita proporcionada por quien realiza la llamada sigue teniendo prioridad. La conexión de retransmisión vuelve a conectarse con la misma temporización de espera progresiva limitada que Socket Mode y borra la identidad proporcionada por el enrutador cada vez que se desconecta.

Instalaciones en toda la organización de Enterprise Grid

Una cuenta de Slack puede recibir mensajes de todos los espacios de trabajo cubiertos por una instalación de Enterprise Grid en toda la organización. Elija Socket Mode directo o URL de solicitud HTTP; el modo de retransmisión no es compatible con las cuentas empresariales. Ambos manifiestos de privilegios mínimos que aparecen a continuación habilitan únicamente la ruta de eventos V1 message y app_mention, las respuestas inmediatas y las reacciones de estado controladas por el listener.

Socket Mode

{  "display_information": {    "name": "OpenClaw",    "description": "Slack connector for OpenClaw"  },  "features": {    "bot_user": { "display_name": "OpenClaw", "always_online": true }  },  "oauth_config": {    "scopes": {      "bot": [        "app_mentions:read",        "channels:history",        "channels:read",        "chat:write",        "files:read",        "files:write",        "groups:history",        "groups:read",        "im:history",        "im:read",        "mpim:history",        "mpim:read",        "reactions:write",        "users:read"      ]    }  },  "settings": {    "org_deploy_enabled": true,    "socket_mode_enabled": true,    "event_subscriptions": {      "bot_events": [        "app_mention",        "message.channels",        "message.groups",        "message.im",        "message.mpim"      ]    }  }}

Solicite a un Enterprise Grid Org Admin u Org Owner que apruebe la aplicación, la instale en el ámbito de la organización y elija los espacios de trabajo que cubre la instalación. Confirme que la aplicación esté disponible en todos los espacios de trabajo previstos antes de iniciar OpenClaw. Genere un token de nivel de aplicación con connections:write para Socket Mode y, a continuación, copie el token del bot de la instalación de la organización. Configure la cuenta que utiliza el token del bot instalado en la organización:

{  channels: {    slack: {      enabled: true,      mode: "socket",      enterpriseOrgInstall: true,      appToken: { source: "env", provider: "default", id: "SLACK_APP_TOKEN" },      botToken: { source: "env", provider: "default", id: "SLACK_BOT_TOKEN" },      dmPolicy: "open",      allowFrom: ["*"],      groupPolicy: "allowlist",      channels: {        C0123456789: { requireMention: true },      },    },  },}

URL de solicitud HTTP

Use el modo HTTP cuando el Gateway tenga un punto de conexión HTTPS público y no abra una conexión de Socket Mode. Sustituya la URL del ejemplo por la URL pública de webhookPath del Gateway (predeterminada: /slack/events):

{  "display_information": {    "name": "OpenClaw",    "description": "Slack connector for OpenClaw"  },  "features": {    "bot_user": { "display_name": "OpenClaw", "always_online": true }  },  "oauth_config": {    "scopes": {      "bot": [        "app_mentions:read",        "channels:history",        "channels:read",        "chat:write",        "files:read",        "files:write",        "groups:history",        "groups:read",        "im:history",        "im:read",        "mpim:history",        "mpim:read",        "reactions:write",        "users:read"      ]    }  },  "settings": {    "org_deploy_enabled": true,    "event_subscriptions": {      "request_url": "https://gateway-host.example.com/slack/events",      "bot_events": [        "app_mention",        "message.channels",        "message.groups",        "message.im",        "message.mpim"      ]    }  }}

Solicite a un Enterprise Grid Org Admin u Org Owner que apruebe la aplicación, la instale en el ámbito de la organización y elija los espacios de trabajo que cubre la instalación. Después de que Slack verifique la Request URL, copie el token del bot de la instalación de la organización y el Basic Information -> App Credentials -> Signing Secret de la aplicación. Configure la cuenta empresarial con la misma ruta de Request URL:

{  channels: {    slack: {      enabled: true,      mode: "http",      enterpriseOrgInstall: true,      botToken: { source: "env", provider: "default", id: "SLACK_BOT_TOKEN" },      signingSecret: {        source: "env",        provider: "default",        id: "SLACK_SIGNING_SECRET",      },      webhookPath: "/slack/events",      dmPolicy: "open",      allowFrom: ["*"],      groupPolicy: "allowlist",      channels: {        C0123456789: { requireMention: true },      },    },  },}

Al iniciarse, OpenClaw verifica enterpriseOrgInstall con auth.test de Slack. Un token instalado en la organización sin la marca, o un token de espacio de trabajo con la marca, provoca un error de inicio. Slack sigue siendo la fuente de información autoritativa sobre los espacios de trabajo que han autorizado la instalación; OpenClaw aplica después las políticas configuradas de canales, usuarios, mensajes directos y menciones a cada evento entregado. Enterprise V1 rechaza todos los eventos message y app_mention creados por bots antes de su despacho, independientemente de allowBots, porque las instalaciones de organización no proporcionan una identidad de bot estable y cualificada por espacio de trabajo para evitar bucles.

La compatibilidad empresarial se limita intencionadamente a eventos directos message y app_mention mediante Socket Mode o HTTP y a sus respuestas inmediatas. No están disponibles para una cuenta empresarial el modo de retransmisión, los comandos con barra diagonal, las interacciones, App Home, los listeners de eventos de reacciones, los elementos fijados, las herramientas de acciones de Slack, las aprobaciones nativas de Slack, las vinculaciones, la entrega en cola o programada ni los envíos proactivos. Las reacciones salientes de confirmación, escritura y estado se admiten mediante el cliente de Slack controlado por el listener y requieren reactions:write; las notificaciones entrantes de reacciones y las herramientas de acciones de reacciones siguen sin estar disponibles.

Las respuestas inmediatas reutilizan el comportamiento estándar de entrega de Slack para fragmentos, contenido multimedia, metadatos, identidad alternativa, vistas previas enriquecidas y confirmaciones, pero solo mientras el cliente validado controlado por el listener permanezca en el turno de evento activo. La cola de envío en memoria y los registros de participación en hilos se particionan según el espacio de trabajo de ese evento; el propio cliente nunca se serializa ni se conserva.

Las claves de política de canales y las entradas de dm.groupChannels deben usar identificadores de canal estables sin procesar de Slack o el formato channel:<id>. OpenClaw normaliza ambos formatos al identificador de canal sin procesar para la coincidencia en tiempo de ejecución; los prefijos slack:, group: y mpim: impiden el inicio. Las entradas de política de usuarios deben usar identificadores de usuario estables de Slack; los nombres, slugs, nombres para mostrar y direcciones de correo electrónico impiden el inicio. Los identificadores deben usar el prefijo y el cuerpo canónicos en mayúsculas de Slack (por ejemplo, C0123456789 o U0123456789); las variantes en minúsculas y las imitaciones abreviadas impiden el inicio. Las cuentas empresariales no pueden habilitar dangerouslyAllowNameMatching. Las cuentas empresariales pueden establecer el valor global mentionPatterns.mode, pero mentionPatterns.allowIn y mentionPatterns.denyIn impiden el inicio porque los identificadores de canal de Slack sin calificar no están asociados a un espacio de trabajo y pueden reutilizarse entre espacios de trabajo. Las instalaciones en espacios de trabajo conservan el comportamiento existente de patrones de mención con ámbito. Cada espacio de trabajo aceptado obtiene identidades independientes de enrutamiento, sesión, transcripción, desduplicación, historial y caché, incluso cuando los identificadores de Slack coinciden. Dentro del flujo message, se admiten los mensajes ordinarios de usuarios y los eventos file_share creados por usuarios; los demás subtipos de mensajes se rechazan antes de la autorización o del procesamiento de eventos del sistema.

Los mensajes directos empresariales deben estar deshabilitados (dm.enabled=false o dmPolicy="disabled") o estar explícitamente abiertos con dmPolicy="open" y un valor efectivo de allowFrom para la cuenta que contenga el literal "*". Una lista de permitidos vacía o identificadores específicos de usuarios sin "*" impiden el inicio. Se rechazan el emparejamiento y las listas de permitidos de mensajes directos por usuario porque los identificadores de usuario de Slack no están asociados a un espacio de trabajo en esos almacenes de autorización. La política de canales y remitentes sigue aplicándose a los mensajes de canales.

Instalación

openclaw plugins install @openclaw/slack

plugins install registra y habilita el plugin. No hace nada hasta que se configuren la aplicación de Slack y los ajustes de canales que se indican a continuación. Consulte Plugins para conocer las reglas generales de instalación de plugins.

Configuración rápida

Los manifiestos de esta sección crean una instalación con ámbito de espacio de trabajo. Para una instalación en toda una organización de Enterprise Grid, use en su lugar el manifiesto y flujo de trabajo para toda la organización.

{"display_information": {"name": "OpenClaw","description": "Conector de Slack para 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 conecta los hilos del asistente de Slack con agentes de OpenClaw.","suggested_prompts": [{ "title": "¿Qué puede hacer?", "message": "¿En qué puede ayudarme?" },{"title": "Resumir este canal","message": "Resuma la actividad reciente de este canal."},{ "title": "Redactar una respuesta", "message": "Ayúdeme a redactar una respuesta." }]},"slash_commands": [{"command": "/openclaw","description": "Enviar un mensaje a 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": "Conector de Slack para 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 conecta los hilos del asistente de Slack con agentes de OpenClaw.","suggested_prompts": [{ "title": "¿Qué puede hacer?", "message": "¿En qué puede ayudarme?" },{"title": "Resumir este canal","message": "Resuma la actividad reciente de este canal."},{ "title": "Redactar una respuesta", "message": "Ayúdeme a redactar una respuesta." }]},"slash_commands": [{"command": "/openclaw","description": "Enviar un mensaje a 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": "Conector de Slack para 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 conecta los hilos del asistente de Slack con agentes de OpenClaw.","suggested_prompts": [{ "title": "¿Qué puede hacer?", "message": "¿En qué puede ayudarme?" },{"title": "Resumir este canal","message": "Resuma la actividad reciente de este canal."},{ "title": "Redactar una respuesta", "message": "Ayúdeme a redactar una respuesta." }]},"slash_commands": [{"command": "/openclaw","description": "Enviar un mensaje a 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": "Conector de Slack para 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 conecta los hilos del asistente de Slack con los agentes de OpenClaw.","suggested_prompts": [{ "title": "¿Qué puedes hacer?", "message": "¿En qué puedes ayudarme?" },{"title": "Resume este canal","message": "Resume la actividad reciente de este canal."},{ "title": "Redacta una respuesta", "message": "Ayúdame a redactar una respuesta." }]},"slash_commands": [{"command": "/openclaw","description": "Envía un mensaje a 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 en Socket Mode

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

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

Usa esta opción únicamente para espacios de trabajo en Socket Mode que registren tiempos de espera de pong/ping del servidor del websocket de Slack o que se ejecuten en hosts con saturación conocida del bucle de eventos. clientPingTimeout es el tiempo de espera del pong después de que el SDK envía un ping del cliente; serverPingTimeout es el tiempo de espera de los 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 de URL de solicitud HTTP.
• Los ajustes base de channels.slack.socketMode se aplican a todas las cuentas de Slack salvo que se sobrescriban. Las sobrescrituras por cuenta usan channels.slack.accounts.<accountId>.socketMode; como se trata de una sobrescritura de objeto, incluye todos los campos de ajuste del socket que quieras usar para esa cuenta.
• Solo clientPingTimeout tiene un valor predeterminado de OpenClaw (15000). serverPingTimeout y pingPongLoggingEnabled se pasan al SDK de Slack únicamente cuando están configurados.
• La espera incremental de reinicio de Socket Mode comienza alrededor de 2 segundos y alcanza un máximo aproximado de 30 segundos. Los errores 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 una autenticación no válida, tokens revocados o alcances ausentes, fallan inmediatamente en lugar de reintentarse indefinidamente.

Lista de comprobación del manifiesto y los alcances

El manifiesto base de la aplicación de Slack es el mismo para Socket Mode y las URL de solicitud HTTP. Solo difieren el bloque settings y la url del comando de barra.

Manifiesto base (Socket Mode predeterminado):

{  "display_information": {    "name": "OpenClaw",    "description": "Conector de Slack para 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 conecta los hilos del asistente de Slack con los agentes de OpenClaw.",      "suggested_prompts": [        { "title": "¿Qué puedes hacer?", "message": "¿En qué puedes ayudarme?" },        {          "title": "Resume este canal",          "message": "Resume la actividad reciente de este canal."        },        { "title": "Redacta una respuesta", "message": "Ayúdame a redactar una respuesta." }      ]    },    "slash_commands": [      {        "command": "/openclaw",        "description": "Envía un mensaje a 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 de URL de solicitud HTTP, sustituye settings por la variante HTTP y añade url a cada comando de barra. Se requiere una URL pública:

{  "features": {    "slash_commands": [      {        "command": "/openclaw",        "description": "Envía un mensaje a 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"    }  }}

Ajustes adicionales 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 de inicio predeterminada segura con views.publish; no se incluye ninguna carga útil de conversación ni configuración privada. Cuando está habilitado el modo de comando de barra único, la indicación del comando usa channels.slack.slashCommand.name; las instalaciones que usan comandos nativos o ningún comando de barra omiten esa indicación. La pestaña Messages permanece habilitada para los mensajes directos de Slack. El manifiesto también habilita los hilos del asistente de Slack mediante features.assistant_view, assistant:write, assistant_thread_started y assistant_thread_context_changed; los hilos del asistente se enrutan a sus propias sesiones de hilo de OpenClaw y mantienen disponible para el agente el contexto del hilo proporcionado por Slack.

{"slash_commands": [{"command": "/new","description": "Iniciar una nueva sesión","usage_hint": "[model]"},{"command": "/reset","description": "Restablecer la sesión actual"},{"command": "/compact","description": "Compactar el contexto de la sesión","usage_hint": "[instructions]"},{"command": "/stop","description": "Detener la ejecución actual"},{"command": "/session","description": "Gestionar la caducidad de la vinculación del hilo","usage_hint": "idle <duration|off> or max-age <duration|off>"},{"command": "/think","description": "Establecer el nivel de razonamiento","usage_hint": "<level>"},{"command": "/verbose","description": "Alternar la salida detallada","usage_hint": "on|off|full"},{"command": "/fast","description": "Mostrar o establecer el modo rápido","usage_hint": "[status|on|off]"},{"command": "/reasoning","description": "Alternar la visibilidad del razonamiento","usage_hint": "[on|off|stream]"},{"command": "/elevated","description": "Alternar el modo elevado","usage_hint": "[on|off|ask|full]"},{"command": "/exec","description": "Mostrar o establecer los valores predeterminados de ejecución","usage_hint": "host=<auto|sandbox|gateway|node> security=<deny|allowlist|full> ask=<off|on-miss|always> node=<id>"},{"command": "/approve","description": "Aprobar o denegar solicitudes de aprobación pendientes","usage_hint": "<id> <decision>"},{"command": "/model","description": "Mostrar o establecer el modelo","usage_hint": "[name|#|status]"},{"command": "/models","description": "Enumerar proveedores/modelos","usage_hint": "[provider] [page] [limit=<n>|size=<n>|all]"},{"command": "/help","description": "Mostrar el resumen breve de ayuda"},{"command": "/commands","description": "Mostrar el catálogo de comandos generado"},{"command": "/tools","description": "Mostrar lo que el agente actual puede usar en este momento","usage_hint": "[compact|verbose]"},{"command": "/agentstatus","description": "Mostrar el estado del entorno de ejecución, incluido el uso o la cuota del proveedor cuando estén disponibles"},{"command": "/tasks","description": "Enumerar las tareas en segundo plano activas o recientes de la sesión actual"},{"command": "/context","description": "Explicar cómo se compone el contexto","usage_hint": "[list|detail|json]"},{"command": "/whoami","description": "Mostrar la identidad del remitente"},{"command": "/skill","description": "Ejecutar una skill por nombre","usage_hint": "<name> [input]"},{"command": "/btw","description": "Hacer una pregunta aparte sin cambiar el contexto de la sesión","usage_hint": "<question>"},{"command": "/side","description": "Hacer una pregunta aparte sin cambiar el contexto de la sesión","usage_hint": "<question>"},{"command": "/usage","description": "Controlar el pie de uso o mostrar el resumen de costes","usage_hint": "off|tokens|full|cost"}]}

{"slash_commands": [{"command": "/new","description": "Iniciar una nueva sesión","usage_hint": "[model]","url": "https://gateway-host.example.com/slack/events"},{"command": "/help","description": "Mostrar el resumen breve de ayuda","url": "https://gateway-host.example.com/slack/events"}]}

Modelo de tokens

• botToken + appToken son obligatorios para el modo Socket.
• El modo HTTP requiere botToken + signingSecret.
• El modo de retransmisión requiere botToken además de relay.url, relay.authToken y relay.gatewayId; no utiliza un token de aplicación ni un secreto de firma.
• botToken, appToken, signingSecret, relay.authToken y userToken aceptan cadenas de texto sin formato u objetos SecretRef.
• Los tokens de configuración prevalecen sobre los valores de reserva del entorno.
• Los valores de reserva del entorno SLACK_BOT_TOKEN, SLACK_APP_TOKEN y SLACK_USER_TOKEN se aplican únicamente a la cuenta predeterminada.
• El comportamiento predeterminado de userToken es de solo lectura (userTokenReadOnly: true).

Comportamiento de la instantánea de estado:

• La inspección de cuentas de Slack realiza el seguimiento de los campos *Source y *Status de cada 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 secretos no insertada directamente, pero la ruta actual del comando o del entorno de ejecución no pudo resolver el valor real.
• En el modo HTTP, se incluye signingSecretStatus; en el modo Socket, el par obligatorio 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 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 los identificadores de archivos de Slack que se muestran en los marcadores de posición de archivos entrantes y devuelve vistas previas para las imágenes o metadatos del archivo local para otros tipos de archivo.

Control de acceso y enrutamiento

Hilos, sesiones y etiquetas de respuesta

• Los mensajes directos se enrutan como direct; los canales, como channel; y los MPIM, como group.
• Las vinculaciones de rutas de Slack aceptan identificadores de pares sin procesar, además de formas de destino de Slack como channel:C12345678, user:U12345678 y <@U12345678>.
• 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>.
• Los mensajes ordinarios de nivel superior del canal permanecen en la sesión por canal, incluso cuando replyToMode no es off.
• Las respuestas en hilos de Slack usan el thread_ts principal de Slack para los sufijos de sesión (:thread:<threadTs>), incluso cuando los hilos de respuestas salientes están desactivados con replyToMode="off".
• OpenClaw incorpora una raíz de canal de nivel superior apta 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 los eventos app_mention, las coincidencias explícitas con el bot o con patrones de mención configurados, y los canales con requireMention: false y un replyToMode distinto de off.
• El valor predeterminado de channels.slack.thread.historyScope es thread; el 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; establezca 0 para desactivarlo).
• 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 de @bot dentro de los hilos, incluso cuando el bot ya haya participado en el hilo. Sin esta opción, las respuestas en un hilo en el que haya participado el bot eluden el control de requireMention.

Controles de hilos de respuesta:

• channels.slack.channels.<id>.replyToMode: sobrescritura por canal para mensajes de canales y canales privados de Slack
• channels.slack.replyToMode: off|first|all|batched (valor predeterminado: off)
• channels.slack.replyToModeByChatType: por 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 enviar respuestas explícitas en hilos de Slack desde la herramienta message, establezca replyBroadcast: true con action: "send" y threadId o replyTo para solicitar que Slack también difunda la respuesta del hilo en el 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 contenido multimedia.

Cuando una llamada a la herramienta message se ejecuta dentro de un hilo de Slack y se dirige al mismo canal, OpenClaw normalmente hereda el hilo actual de Slack según el replyToMode efectivo de la cuenta, del tipo de chat o del canal. Las respuestas automáticas y las llamadas send o upload-file al mismo canal usan la misma sobrescritura por canal. Establezca topLevel: true en action: "send" o action: "upload-file" para forzar un nuevo mensaje en el canal principal. También se acepta threadId: null como la misma exclusión voluntaria del hilo.

Reacciones de confirmación

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

De forma predeterminada, la confirmación permanece estática mientras el estado nativo del hilo del asistente de Slack muestra el progreso mediante mensajes de carga rotativos. Establezca messages.statusReactions.enabled: true para habilitar voluntariamente el ciclo de vida de reacciones de en cola/procesando/herramienta/finalizado/error.

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").
• Use "" para desactivar la reacción para la cuenta de Slack o de forma global.

Ámbito (messages.ackReactionScope)

El proveedor de Slack lee el ámbito de messages.ackReactionScope (valor predeterminado: "group-mentions"). Actualmente no existe ninguna sobrescritura a nivel de cuenta ni de canal de Slack; el valor es global para el Gateway.

Valores:

• "all": reaccionar en mensajes directos y grupos, incluidos los eventos ambientales de sala.
• "direct": reaccionar solo en mensajes directos.
• "group-all": reaccionar a todos los mensajes de grupo, excepto los eventos ambientales de sala (sin mensajes directos).
• "group-mentions" (valor predeterminado): reaccionar en grupos, pero solo cuando se menciona al bot (o en elementos mencionables del grupo que lo hayan habilitado). Se excluyen los mensajes directos.
• "off" / "none": no reaccionar nunca.

{  messages: {    ackReaction: "eyes",    ackReactionScope: "all", // reaccionar en mensajes directos y grupos  },}

Transmisión de texto

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

• off: desactivar la transmisión de la vista previa en vivo.
• partial (valor predeterminado): reemplazar el texto de la vista previa con la salida parcial más reciente.
• block: anexar actualizaciones fragmentadas de la vista previa.
• progress: mostrar texto de estado de progreso durante la generación y, después, enviar el texto final.
• streaming.preview.toolProgress: cuando la vista previa del borrador está activa, enrutar las actualizaciones de herramientas/progreso al mismo mensaje de vista previa editado (valor predeterminado: true). Establezca false para mantener separados los mensajes de herramientas/progreso.
• streaming.preview.commandText / streaming.progress.commandText: establecer en status para mantener líneas compactas de progreso de herramientas y ocultar el texto sin procesar de comandos/ejecución (valor predeterminado: raw).

Oculte el texto sin procesar de comandos/ejecución y conserve las líneas compactas de progreso:

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

channels.slack.streaming.nativeTransport controla la transmisión nativa de texto de Slack cuando channels.slack.streaming.mode es partial (valor predeterminado: true).

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

• Debe haber un hilo de respuesta disponible para que aparezcan la transmisión nativa de texto y el estado del hilo del asistente de Slack. La selección del hilo sigue rigiéndose por replyToMode.
• Las raíces de canales, chats de grupo y mensajes directos de nivel superior pueden seguir usando la vista previa normal del borrador cuando la transmisión nativa no esté disponible o no exista un hilo de respuesta.
• Los mensajes directos de nivel superior de Slack permanecen fuera de los hilos de forma predeterminada, por lo que no muestran la vista previa nativa de transmisión/estado con formato de hilo de Slack; en su lugar, OpenClaw publica y edita una vista previa del borrador en el mensaje directo.
• El contenido multimedia y las cargas útiles que no sean de texto recurren a la entrega normal.
• Los resultados finales de contenido multimedia/error cancelan las ediciones pendientes de la vista previa; los resultados finales de texto/bloques aptos solo se vacían cuando pueden editar la vista previa en el mismo lugar.
• Si la transmisión falla a mitad de una respuesta, OpenClaw recurre a la entrega normal para las cargas útiles restantes.

Use la vista previa del borrador en lugar de la transmisión nativa de texto de Slack:

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

Habilite voluntariamente las 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 heredado de channels.slack.streaming.mode.
• El valor booleano channels.slack.streaming es un alias heredado de channels.slack.streaming.mode y channels.slack.streaming.nativeTransport.
• Las claves de nivel superior channels.slack.chunkMode y channels.slack.nativeStreaming son alias heredados de channels.slack.streaming.chunkMode y channels.slack.streaming.nativeTransport.
• Los alias heredados no se leen durante la ejecución; ejecute openclaw doctor --fix para reescribir la configuración persistente de transmisión de Slack con 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 la elimina cuando finaliza la ejecución. Esto resulta 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 en la medida de lo posible y se intenta eliminar automáticamente después de que finalice la ruta de respuesta o error.

Entrada de voz

Para hablar con OpenClaw en Slack actualmente, envíe un clip de audio de Slack a la aplicación OpenClaw. El micrófono de dictado de Slackbot es una función independiente propiedad de Slack, no una API de aplicaciones.

• El dictado de voz de Slackbot se encuentra dentro de la conversación privada del usuario con Slackbot. Slack convierte la grabación en una solicitud para Slackbot, pero no emite un archivo de audio, evento de dictado, solicitud ni marcador de origen de entrada para aplicaciones de Slack de terceros mediante la API de eventos. El plugin de Slack de OpenClaw no puede habilitarlo ni recibirlo.
• Los clips de audio de Slack son archivos almacenados en Slack que pueden publicarse en un mensaje directo, canal o hilo de OpenClaw. OpenClaw descarga un clip accesible con el token del bot, normaliza los metadatos MIME del clip de Slack y lo envía a través del proceso compartido de transcripción de audio. El manifiesto de aplicación recomendado incluye el ámbito files:read requerido.

Los clips de audio y el dictado de Slackbot tienen implicaciones de privacidad diferentes: los clips siguen la política de retención de archivos de Slack y OpenClaw los descarga para transcribirlos, mientras que Slack afirma que el audio del dictado no se almacena.

En un canal con requireMention: true, un clip de audio sin subtítulos puede cumplir el requisito si se pronuncia un patrón de mención configurado (agents.list[].groupChat.mentionPatterns, con messages.groupChat.mentionPatterns como alternativa). OpenClaw autoriza al remitente antes de descargar o transcribir el clip y solo lo admite cuando la transcripción coincide. Una transcripción especulativa fallida o sin coincidencias se descarta junto con el clip descargado; no se conserva en el historial del canal. La identidad nativa @bot de Slack no puede inferirse del habla, por lo que debe configurarse un patrón de nombre hablado o incluirse una mención escrita. Si está habilitada la repetición de la transcripción, esta solo se envía después de la admisión.

Contenido multimedia, fragmentación y entrega

Comandos y comportamiento de las barras diagonales

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

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

/openclaw /help

En cambio, los comandos nativos requieren ajustes adicionales del manifiesto en la aplicación de Slack y se habilitan con channels.slack.commands.native: true o commands.native: true en las 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 se representan de una de las siguientes formas, por orden de prioridad:

• 3-5 opciones suficientemente cortas: un menú de desbordamiento ("...")
• más de 100 opciones, con filtrado asíncrono de opciones disponible: selector externo
• 1-2 opciones, o cualquier opción cuyo valor codificado sea demasiado largo para un selector: bloques de botones
• en los demás casos (6-100 opciones, o más de 100 sin filtrado asíncrono): menú de selección estático, dividido en grupos de 100 opciones por menú

/think

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

Gráficos nativos

El bloque público data_visualization de Block Kit de Slack representa gráficos de líneas, barras, áreas y sectores en los mensajes. OpenClaw asigna el bloque chart de presentation portable a esa forma nativa; no se requiere ningún ámbito de OAuth, carga de archivos, renderizador de imágenes ni configuración de Slack adicional aparte del acceso normal a mensajes chat:write.

{  "blocks": [    {      "type": "chart",      "chartType": "bar",      "title": "Quarterly revenue",      "categories": ["Q1", "Q2"],      "series": [{ "name": "Revenue", "values": [120, 145] }],      "xLabel": "Quarter"    }  ]}

Los límites de Slack se aplican antes de la representación nativa:

• título y etiquetas opcionales de los ejes: 50 caracteres
• sectores: 1-12 segmentos positivos
• líneas/barras/áreas: 1-12 series con nombres únicos y 1-20 categorías compartidas
• etiquetas de segmentos, categorías y series: 20 caracteres
• cada serie debe contener un valor finito por cada categoría; los valores que no sean de sectores pueden ser negativos

Cada gráfico nativo también incluye una representación textual de nivel superior para lectores de pantalla, notificaciones, replicación de sesiones y clientes que no pueden representar el bloque. Los envíos de presentación estándar a otros canales de OpenClaw reciben esos mismos datos deterministas del gráfico como texto, salvo que anuncien compatibilidad nativa con gráficos. Si Slack rechaza el gráfico con invalid_blocks durante un despliegue gradual, OpenClaw elimina los bloques de datos nativos rechazados, conserva los controles hermanos y envía la representación completa del gráfico como texto visible.

Actualmente, Slack acepta hasta dos bloques data_visualization por mensaje. Cuando una presentación contiene más de dos gráficos válidos, OpenClaw conserva su orden y continúa la representación nativa en mensajes posteriores, con un máximo de dos gráficos en cada mensaje.

El lanzamiento para desarrolladores de Slack documenta el bloque como una función de Block Kit orientada a aplicaciones y no publica ninguna restricción de plan de pago. El texto sobre elegibilidad para Business+/Enterprise se aplica a la generación automática de gráficos mediante IA de Slackbot, que es independiente del envío por parte de una aplicación de un gráfico de Block Kit ya estructurado. Los gráficos son bloques exclusivos de mensajes, no contenido de App Home, modales ni Canvas.

Tablas nativas

El bloque actual data_table de Block Kit de Slack representa filas y columnas estructuradas en los mensajes. OpenClaw asigna un bloque table explícito de presentation portable a data_table; no usa el bloque table heredado de Slack. No se requiere ningún ámbito de OAuth ni configuración de Slack adicional aparte del acceso normal a mensajes chat:write.

{  "blocks": [    {      "type": "table",      "caption": "Open pipeline",      "headers": ["Account", "Stage", "ARR"],      "rows": [        ["Acme", "Won", 125000],        ["Globex", "Review", 82000]      ],      "rowHeaderColumnIndex": 0    }  ]}

OpenClaw asigna las celdas de encabezado y de cadena a celdas raw_text de Slack. Las celdas numéricas se asignan a raw_number, conservando el valor numérico finito para la ordenación y el filtrado nativos. rowHeaderColumnIndex, cuando está presente, marca esa columna con índice de base cero como encabezados de fila de Slack.

Los límites publicados de data_table de Slack se aplican antes de la representación nativa:

• 1-20 columnas
• 1-100 filas de datos, además de la fila de encabezado
• el mismo número de celdas en cada fila
• como máximo 10,000 caracteres acumulados entre todas las celdas de tabla de un mensaje

Se pueden representar varios bloques de tabla válidos de forma nativa mientras el mensaje se mantenga dentro del límite total de caracteres. Una tabla que no pueda representarse dentro de los límites nativos se convierte en texto determinista completo en lugar de perder filas o celdas. Si ese texto supera un mensaje de Slack, los envíos y las respuestas a comandos con barra diagonal usan fragmentos de texto ordenados. Las ediciones de tablas fallan con un error de tamaño explícito en lugar de truncar silenciosamente filas de un mensaje existente.

Cada tabla nativa producida a partir de una presentación portable también incluye una representación textual de nivel superior para lectores de pantalla, notificaciones, replicación de sesiones y clientes que no pueden representar el bloque. Los valores sin procesar de gráficos y tablas se mantienen literales en la alternativa, por lo que datos de celda como <@U123> no se convierten en una mención de Slack. Si Slack rechaza bloques nativos de gráficos o tablas con invalid_blocks, OpenClaw elimina todos los bloques de datos nativos en un único paso de recuperación acotado, conserva los bloques hermanos válidos, como botones y selectores, y envía el texto visible completo de gráficos y tablas con el formato de Slack deshabilitado. La entrega de comandos con barra diagonal controla el presupuesto de cinco llamadas de response_url de Slack durante todo el comando. Antes de cada lote de respuestas, selecciona un plan completo que se ajuste a las llamadas restantes o falla antes de publicar ese lote.

Solo los bloques de tabla presentation explícitos se convierten en tablas nativas. Las tablas con barras verticales de Markdown permanecen como texto creado; OpenClaw no intenta deducir la estructura de la tabla ni los tipos de celda. Los productores nativos de Slack existentes y de confianza pueden seguir pasando bloques sin procesar mediante channelData.slack.blocks; OpenClaw deriva el texto alternativo de las celdas data_table sin procesar válidas, mientras que los bloques personalizados malformados pueden degradarse a su pie o a la alternativa general de Block Kit. La salida portable de agentes, CLI y plugins debe usar presentation.

Respuestas interactivas

Slack puede representar controles interactivos de respuesta creados por agentes, pero esta función está deshabilitada de forma predeterminada. Para la salida nueva de agentes, CLI y plugins, se prefieren los botones o bloques de selección compartidos de presentation. Usan la misma ruta de interacción de Slack y también pueden degradarse en otros canales.

Habilítela globalmente:

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

O habilítela solo para una cuenta de Slack:

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

Cuando está habilitada, 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 Block Kit de Slack y encaminan los clics o las selecciones a través de la ruta de eventos de interacción existente de Slack. Consérvelas para solicitudes antiguas y vías de escape específicas de Slack; use la presentación compartida para los nuevos controles portables.

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

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

Use cargas útiles de presentation y buildSlackPresentationBlocks(...) para los nuevos controles representados en Slack.

Notas:

• Esta es una interfaz heredada específica de Slack. Otros canales no traducen las directivas de Block Kit de Slack a sus propios sistemas de botones.
• Los valores de las devoluciones de llamada interactivas son tokens opacos generados por OpenClaw, no valores sin procesar creados por el agente.
• Si los bloques interactivos generados superasen los límites de Block Kit de Slack, OpenClaw utiliza como alternativa la respuesta de texto original en lugar de enviar una carga útil de bloques no válida.

Envíos de modales propiedad de plugins

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

• Establezca callback_id en openclaw:<namespace>:<payload>.
• O conserve un callback_id existente y coloque pluginInteractiveData: "<namespace>:<payload>" en private_metadata del modal.

El controlador recibe ctx.interaction.kind como view_submission o view_closed, las entradas inputs normalizadas y el objeto stateValues sin procesar completo de Slack. El encaminamiento basado únicamente en el identificador de devolución de llamada basta para invocar el controlador del plugin; incluya los campos existentes de encaminamiento de usuario/sesión de private_metadata del modal cuando el modal también deba producir un evento del sistema visible para el agente. El agente recibe un evento del sistema Slack interaction: ... compacto y censurado. Si el controlador devuelve systemEvent.summary, systemEvent.reference o systemEvent.data, esos campos se incluyen en ese evento compacto para que el agente pueda hacer referencia al almacenamiento propiedad del plugin sin ver la carga útil completa del formulario.

Aprobaciones nativas en Slack

Slack puede actuar como cliente nativo de aprobaciones con botones e interacciones, en lugar de recurrir a la interfaz web o al terminal.

• Las aprobaciones de ejecución y de plugins pueden representarse como solicitudes nativas de Block Kit de Slack.
• channels.slack.execApprovals.* sigue siendo la configuración de habilitación y encaminamiento por mensaje directo/canal del cliente nativo de aprobaciones de ejecución.
• Los mensajes directos de aprobación de ejecución usan channels.slack.execApprovals.approvers o commands.ownerAllowFrom.
• Las aprobaciones de plugins usan botones nativos de Slack cuando Slack está habilitado como cliente nativo de aprobaciones para la sesión de origen, o cuando approvals.plugin se encamina a la sesión de Slack de origen o a un destino de Slack.
• Los mensajes directos de aprobación de plugins usan los aprobadores de plugins de Slack de channels.slack.allowFrom, el valor allowFrom de la cuenta con nombre o la ruta predeterminada de la cuenta.
• La autorización del aprobador se sigue aplicando: los aprobadores exclusivos de ejecución no pueden aprobar solicitudes de plugins, salvo que también sean aprobadores de plugins.

Esto usa la misma superficie compartida de botones de aprobación que otros canales. Cuando interactivity está habilitada en la configuración de la aplicación de Slack, las solicitudes de aprobación se muestran como botones de Block Kit directamente en la conversación. Cuando estos botones están presentes, constituyen la experiencia de usuario principal para la 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 vía.

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, valor predeterminado: dm)
• agentFilter, sessionFilter

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

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

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

La configuración nativa de Slack explícita solo es necesaria cuando se quieren sustituir los aprobadores, añadir 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. Úselo solo cuando las solicitudes 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 solo suprime ese mecanismo alternativo cuando Slack puede gestionar de forma nativa la solicitud de aprobación del plugin.

El comando /approve en el mismo chat también funciona en los canales y mensajes directos de Slack que ya admiten comandos. Consulte Aprobaciones de ejecución para conocer el modelo completo de reenvío de aprobaciones.

Eventos y comportamiento operativo

• Las ediciones y eliminaciones de mensajes se asignan a eventos del sistema.
• Las difusiones de hilos (respuestas de hilo con "Also send to channel") se procesan como mensajes normales del usuario.
• Los eventos de adición y eliminación de reacciones se asignan a eventos del sistema.
• Los eventos de entrada o salida de miembros, creación o cambio de nombre de canales y adición o eliminación de elementos 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 y propósito del canal se tratan como contexto no confiable y pueden inyectarse en el contexto de enrutamiento.
• La incorporación del mensaje inicial del hilo y del contexto del historial inicial del hilo se filtra mediante las listas de remitentes permitidos configuradas cuando corresponda.
• Las acciones de bloques, los accesos directos y las interacciones con modales emiten eventos estructurados del sistema Slack interaction: ... con campos de carga útil detallados:
  • acciones de bloques: valores seleccionados, etiquetas, valores de selectores y metadatos workflow_*
  • accesos directos globales: metadatos de devolución de llamada y del actor, enrutados a la sesión directa del actor
  • accesos directos de mensajes: contexto de devolución de llamada, actor, canal, hilo y mensaje seleccionado
  • eventos modales view_submission y view_closed con metadatos del canal enrutado y entradas del formulario

Defina accesos directos globales o de mensajes en la configuración de la aplicación de Slack y use cualquier ID de devolución de llamada no vacío. OpenClaw confirma las cargas útiles de accesos directos coincidentes, aplica la misma política de remitentes de mensajes directos y canales que para otras interacciones de Slack y pone en cola el evento depurado para la sesión del agente enrutada. Los ID de activador y las URL de respuesta se ocultan 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 archivos adjuntos multimedia

Slack puede adjuntar el contenido multimedia descargado al turno del agente cuando las descargas de archivos de Slack se realizan correctamente y los límites de tamaño lo permiten. Los clips de audio pueden transcribirse, los archivos de imagen pueden pasar por la ruta de comprensión multimedia o directamente a un modelo de respuesta con capacidad de visión, y los demás archivos permanecen disponibles como contexto de archivo descargable.

Tipos de contenido multimedia 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 mediante el token del bot.
2. Si la descarga se realiza correctamente, el archivo se guarda en el almacén de medios.
3. Las rutas y los tipos de contenido de los medios descargados se añaden al contexto entrante.
4. Los clips de audio se dirigen al proceso compartido de transcripción; las rutas de modelos o herramientas con capacidad para procesar imágenes pueden usar los archivos adjuntos de imagen del mismo contexto.
5. Los demás archivos permanecen disponibles como metadatos de archivo o referencias de medios para las herramientas que puedan procesarlos.

Herencia de archivos adjuntos del mensaje raíz del hilo

Cuando llega un mensaje en un hilo (tiene un elemento principal thread_ts):

• Si la propia respuesta no contiene medios directos y el mensaje raíz incluido tiene archivos, Slack puede incorporar los archivos del mensaje raíz como contexto inicial del hilo.
• Los archivos del mensaje raíz solo se incorporan al inicializar una sesión de hilo nueva o restablecida. Las respuestas posteriores que solo contienen texto reutilizan el contexto de sesión existente y no vuelven a adjuntar los archivos del mensaje raíz como medios nuevos.
• Los archivos adjuntos directos de la respuesta tienen prioridad sobre los archivos adjuntos del mensaje raíz.
• Un mensaje raíz que solo contiene archivos y no tiene texto se representa mediante un marcador de posición de archivo adjunto para que el mecanismo alternativo pueda seguir incluyendo sus archivos.

Procesamiento de varios archivos adjuntos

Cuando un único mensaje de Slack contiene varios archivos adjuntos:

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

Límites de tamaño, descarga y modelo

• Límite de tamaño: De forma predeterminada, 20 MB por archivo. Se puede configurar mediante channels.slack.mediaMaxMb.
• Límite de transcripción de audio: tools.media.audio.maxBytes también se aplica cuando el archivo descargado se envía a un proveedor de transcripción o a la CLI.
• Fallos de descarga: Los archivos que Slack no puede proporcionar, las URL caducadas, los archivos inaccesibles o demasiado grandes y las respuestas HTML de autenticación o 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 utiliza el modelo de respuesta activo cuando admite visión o el modelo de imágenes configurado en agents.defaults.imageModel.

Limitaciones conocidas

Documentación relacionada

• Proceso de comprensión de medios
• Audio y notas de voz
• Herramienta PDF

Contenido relacionado