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 implementaciones administradas en las que un enrutador de confianza controla la entrada de Slack.

Elección de un transporte

Socket Mode y las URL de solicitud HTTP ofrecen paridad de funciones para mensajería, comandos de barra diagonal, App Home e interactividad. La elección debe basarse en el tipo de implementación, no en 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 continúa 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 utilizar wss://, salvo que apunte a localhost. Trate 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 el autor de la llamada sigue teniendo prioridad. La conexión de retransmisión vuelve a conectarse con el mismo tiempo de espera incremental limitado que Socket Mode y borra la identidad proporcionada por el enrutador cada vez que se desconecta.

Instalaciones para 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 para toda la organización de Enterprise Grid. Elija Socket Mode directo o URL de solicitud HTTP; el modo de retransmisión no es compatible con las cuentas empresariales. Los dos manifiestos de privilegios mínimos que aparecen a continuación solo habilitan 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": "Conector de Slack para 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 o a un Org Owner que apruebe la aplicación, la instale en el ámbito de la organización y elija los espacios de trabajo que abarca 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 aplicación con connections:write para Socket Mode y, a continuación, copie el token de bot de la instalación de la organización. Configure la cuenta que utiliza el token de 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

Utilice 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 webhookPath del Gateway (valor predeterminado: /slack/events):

{  "display_information": {    "name": "OpenClaw",    "description": "Conector de Slack para 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 o a un Org Owner que apruebe la aplicación, la instale en el ámbito de la organización y elija los espacios de trabajo que abarca la instalación. Después de que Slack verifique la URL de solicitud, copie el token de 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 URL de solicitud:

{  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 el indicador, o un token de espacio de trabajo con el indicador, provoca un error de inicio. Slack sigue siendo la fuente de verdad sobre los espacios de trabajo que han concedido 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 enviarlos, independientemente de allowBots, porque las instalaciones de la organización no proporcionan una identidad de bot estable asociada al espacio de trabajo para evitar bucles.

La compatibilidad empresarial se limita deliberadamente a los eventos directos message y app_mention de Socket Mode o HTTP, así como a sus respuestas inmediatas. El modo de retransmisión, los comandos de barra diagonal, las interacciones, App Home, los listeners de eventos de reacción, los elementos fijados, las herramientas de acciones de Slack, las aprobaciones nativas de Slack, los enlaces, la entrega en cola o programada y los envíos proactivos no están disponibles para una cuenta empresarial. Las reacciones salientes de confirmación, escritura y estado son compatibles mediante el cliente de Slack controlado por el listener y requieren reactions:write; las notificaciones de reacciones entrantes y las herramientas de acciones de reacción 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 y confirmaciones de recepción, pero solo mientras el cliente validado propiedad del 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 cliente en sí nunca se serializa ni persiste.

Las claves de política de canal y las entradas dm.groupChannels deben usar identificadores de canal de Slack estables sin procesar o el formato channel:<id>. OpenClaw normaliza ambos formatos al identificador de canal sin procesar para la correspondencia en tiempo de ejecución; los prefijos slack:, group: y mpim: impiden el inicio. Las entradas de política de usuario deben usar identificadores de usuario de Slack estables; 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 procesar 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, deduplicació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 tratamiento de eventos del sistema.

Los mensajes directos empresariales deben estar deshabilitados (dm.enabled=false o dmPolicy="disabled") o abrirse explícitamente con dmPolicy="open" y una cuenta efectiva allowFrom 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 canal y remitente sigue aplicándose a los mensajes de canal.

Instalación

openclaw plugins install @openclaw/slack

plugins install registra y habilita el plugin. No hace nada hasta que se configuran la aplicación de Slack y los ajustes de canal que aparecen 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, utilice 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},"agent_view": {"agent_description": "OpenClaw conecta las conversaciones de Agent View 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": "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","app_context_changed","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},"agent_view": {"agent_description": "OpenClaw conecta las conversaciones de Agent View 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": "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","app_context_changed","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},"agent_view": {"agent_description": "OpenClaw conecta las conversaciones de Agent View 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": "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","app_context_changed","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},"agent_view": {"agent_description": "OpenClaw conecta las conversaciones de Slack Agent View con 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": "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","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","app_context_changed","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

Identidad de usuario (publicar como una persona real)

La identidad de usuario permite que OpenClaw lea y publique como la persona que autoriza la aplicación de Slack. userToken es la identidad que actúa; una aplicación complementaria de Slack transporta el tráfico de la Events API mediante Socket Mode o una HTTP Request URL. La aplicación complementaria no necesita un usuario bot ni un token de bot.

Configure la aplicación complementaria de la siguiente manera:

1. En OAuth & Permissions -> User Token Scopes, añada estos permisos con ámbito de usuario:

   • historial: channels:history, groups:history, im:history, mpim:history
   • búsqueda de conversaciones: channels:read, groups:read, im:read, mpim:read
   • personas: users:read
   • publicación: chat:write (los mensajes se publican como el usuario que autoriza)
   • apertura de mensajes directos: im:write, mpim:write

2. En Event Subscriptions -> Subscribe to events on behalf of users, añada estos eventos de usuario. No los añada únicamente a la lista de eventos del bot:

   • message.channels
   • message.groups
   • message.im
   • message.mpim

3. Elija un transporte de eventos:

   • Socket Mode: habilite Socket Mode y cree un token de nivel de aplicación con connections:write. Configúrelo como appToken.
   • HTTP Request URL: haga que Event Subscriptions apunte al endpoint público de Slack de OpenClaw y copie Basic Information -> App Credentials -> Signing Secret. Configúrelo como signingSecret.

4. Instale o reinstale la aplicación, autorícela como la persona prevista y copie el token OAuth de usuario resultante en userToken.

Configuración de Socket Mode:

{  channels: {    slack: {      identity: "user",      userToken: "<xoxp>",      appToken: "<xapp>",    },  },}

Configuración de HTTP Request URL:

{  channels: {    slack: {      identity: "user",      mode: "http",      userToken: "<xoxp>",      signingSecret: "<signing-secret>",      webhookPath: "/slack/events",    },  },}

OpenClaw descarta automáticamente los eventos de mensajes con ámbito de usuario cuyo autor sea la identidad humana resuelta, por lo que los mensajes que envía no activan respuestas a sí mismo.

Ajuste del transporte de 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. Sobrescriba la configuración de transporte únicamente cuando necesite ajustes específicos para el espacio de trabajo o el host:

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

Úselo únicamente en espacios de trabajo con Socket Mode que registren tiempos de espera agotados de pong o ping del servidor en el websocket de Slack, o que se ejecuten en hosts con una saturación conocida del bucle de eventos. clientPingTimeout es el tiempo de espera del pong después de que el SDK envíe 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 HTTP Request URL.
• La configuración base de channels.slack.socketMode se aplica a todas las cuentas de Slack, salvo que se sobrescriba. Las sobrescrituras por cuenta usan channels.slack.accounts.<accountId>.socketMode; como se trata de una sobrescritura de objeto, incluya todos los campos de ajuste del socket que desee para esa cuenta.
• Solo clientPingTimeout tiene un valor predeterminado de OpenClaw (15000). serverPingTimeout y pingPongLoggingEnabled solo se pasan al SDK de Slack cuando están configurados.
• La espera incremental para reiniciar Socket Mode comienza alrededor de 2 segundos y alcanza un máximo aproximado de 30 segundos. Los fallos recuperables de inicio, espera de inicio y desconexión se reintentan hasta que se detiene el canal. Los errores permanentes de cuenta y credenciales, como una autenticación no válida, tokens revocados o ámbitos ausentes, fallan de inmediato en lugar de reintentarse indefinidamente.

Lista de comprobación del manifiesto y los ámbitos

El manifiesto base de la aplicación de Slack es el mismo para Socket Mode y las HTTP Request URLs. Solo difieren el bloque settings (y el 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    },    "agent_view": {      "agent_description": "OpenClaw conecta las conversaciones de Slack Agent View con 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": "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",        "app_context_changed",        "channel_rename",        "member_joined_channel",        "member_left_channel",        "message.channels",        "message.groups",        "message.im",        "message.mpim",        "pin_added",        "pin_removed",        "reaction_added",        "reaction_removed"      ]    }  }}

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

{  "features": {    "slash_commands": [      {        "command": "/openclaw",        "description": "Enviar 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",        "app_context_changed",        "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

Muestra distintas funciones que amplían los valores predeterminados anteriores.

La configuración predeterminada del manifiesto 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. Cuando se habilita el modo de comando de barra único, la sugerencia del comando usa channels.slack.slashCommand.name; las instalaciones que usan comandos nativos o ningún comando de barra omiten esa sugerencia. La pestaña Messages permanece habilitada para los mensajes directos de Slack. Las aplicaciones nuevas usan Slack Agent View mediante features.agent_view, assistant:write y app_context_changed. Cada raíz visible de Agent View se dirige a su propia sesión de hilo de OpenClaw, y las entidades ordenadas de la vista activa de Slack llegan al agente únicamente como contexto no confiable.

Las aplicaciones existentes que ya usan features.assistant_view pueden conservar su manifiesto actual. OpenClaw sigue gestionando assistant_thread_started y assistant_thread_context_changed para esas instalaciones. Slack hace que la migración de Assistant View a Agent View sea irreversible y exige que los usuarios realicen después una actualización forzada, por lo que no se debe sustituir assistant_view en una aplicación existente hasta que se pretenda migrar todo el espacio de trabajo.

{"slash_commands": [{"command": "/new","description": "Iniciar una sesión nueva","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": "inactividad <duration|off> o antigüedad máxima <duration|off>"},{"command": "/think","description": "Establecer el nivel de razonamiento","usage_hint": "<level>"},{"command": "/verbose","description": "Activar o desactivar 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": "Activar o desactivar la visibilidad del razonamiento","usage_hint": "[on|off|stream]"},{"command": "/elevated","description": "Activar o desactivar 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 puede usar el agente actual en este momento","usage_hint": "[compact|verbose]"},{"command": "/agentstatus","description": "Mostrar el estado 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 construye 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 secundaria sin cambiar el contexto de la sesión","usage_hint": "<question>"},{"command": "/login","description": "Emparejar el inicio de sesión de Codex","usage_hint": "[codex|openai]"},{"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 sesión nueva","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

• La identidad de bot (predeterminada) requiere botToken + appToken para Socket Mode, o botToken + signingSecret para el modo HTTP.
• La identidad de usuario requiere userToken + appToken para Socket Mode, o userToken + signingSecret para el modo HTTP. No usa un token de bot.
• El modo de retransmisión requiere botToken además de relay.url, relay.authToken y relay.gatewayId; no usa 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 tienen prioridad sobre el valor alternativo de las variables de entorno.
• Los valores alternativos de entorno SLACK_BOT_TOKEN, SLACK_APP_TOKEN y SLACK_USER_TOKEN se aplican únicamente a la cuenta predeterminada.
• userToken usa de forma predeterminada un comportamiento 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. Socket Mode usa botTokenStatus + appTokenStatus para la identidad de bot y userTokenStatus + appTokenStatus para la identidad de usuario.

Acciones y controles

Las acciones de Slack están controladas por channels.slack.actions.*.

Grupos de acciones disponibles en las herramientas actuales de Slack:

Las acciones de mensajes actuales de Slack incluyen send, upload-file, download-file, read, edit, delete, pin, unpin, list-pins, member-info y emoji-list. download-file acepta los ID de archivo de Slack que aparecen en los marcadores de posición de archivos entrantes y devuelve vistas previas para las imágenes o metadatos de archivos locales 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 ID de pares sin procesar, además de formatos de destino de Slack como channel:C12345678, user:U12345678 y <@U12345678>.
• Con el valor predeterminado session.dmScope=main, los mensajes directos normales de Slack se agrupan en la sesión principal del agente. Las raíces de Agent View y los hilos existentes de Assistant View permanecen aislados como sesiones :thread:<threadTs>.
• Sesiones de canal: agent:<agentId>:slack:channel:<channelId>.
• Los mensajes normales de nivel superior del canal permanecen en la sesión por canal, incluso cuando replyToMode no es off.
• Las respuestas de hilos de canales de Slack, MPIM, Agent View y Assistant View utilizan el thread_ts principal de Slack para los sufijos de sesión (:thread:<threadTs>). Los hilos de respuesta de mensajes directos normales siguen siendo una función de la interfaz de usuario dentro de la sesión base de mensajes directos.
• OpenClaw incorpora una raíz de nivel superior apta del canal en agent:<agentId>:slack:channel:<channelId>:thread:<rootTs> cuando se espera que esa raíz inicie un hilo visible de Slack, de modo que la raíz y las respuestas posteriores del hilo compartan una sesión de OpenClaw. Esto se aplica a eventos app_mention, coincidencias explícitas con el bot o con patrones de menciones configurados y canales requireMention: false con 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 deshabilitarlo).
• channels.slack.implicitMentions.replyToBot controla si una respuesta al mensaje del propio bot omite el requisito de mención (valor predeterminado: true).
• channels.slack.implicitMentions.threadParticipation controla si los mensajes de seguimiento de un hilo en el que el bot ha respondido omiten el requisito de mención (valor predeterminado: true). Establézcalo en false para exigir una nueva mención explícita en esos mensajes de seguimiento. openclaw doctor --fix migra la antigua clave channels.slack.thread.requireExplicitMention a esta marca canónica positiva.
• Las anulaciones de cuenta se encuentran en channels.slack.accounts.<id>.implicitMentions; los valores predeterminados compartidos, en channels.defaults.implicitMentions.

Controles de hilos de respuestas:

• channels.slack.channels.<id>.replyToMode: anulación 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 respuestas explícitas a hilos de Slack desde la herramienta message, establezca replyBroadcast: true con action: "send" y threadId o replyTo para solicitar a Slack que también publique la respuesta del hilo en el canal principal. Esto se asigna a la marca reply_broadcast de chat.postMessage de Slack y solo se admite para envíos de texto o Block Kit, no para cargas multimedia.

Cuando una llamada a la herramienta message se ejecuta dentro de un hilo de Slack y tiene como destino el mismo canal, OpenClaw suele heredar 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 a send o upload-file dirigidas al mismo canal utilizan la misma anulación por canal. Establezca 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. 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 de agente/asistente de Slack muestra el progreso mediante mensajes de carga rotativos. Establezca messages.statusReactions.enabled: true para activar el ciclo de vida de reacciones en cola/pensando/herramienta/finalizado/error.

Emoji (ackReaction)

Orden de resolución:

• channels.slack.accounts.<accountId>.ackReaction
• channels.slack.ackReaction
• messages.ackReaction
• emoji alternativo de la identidad del agente (agents.entries.*.identity.emoji; de lo contrario, "eyes" / 👀)

Notas:

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

Ámbito (messages.ackReactionScope)

El proveedor de Slack lee el ámbito desde messages.ackReactionScope (valor predeterminado: "group-mentions"). Actualmente no existe ninguna anulación 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 de sala ambientales.
• "direct": reaccionar solo en mensajes directos.
• "group-all": reaccionar a todos los mensajes de grupo, excepto a los eventos de sala ambientales (sin mensajes directos).
• "group-mentions" (valor predeterminado): reaccionar en grupos, pero solo cuando se mencione al bot (o en elementos mencionables de grupo que hayan activado esta opción). 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 directo:

• off: deshabilitar la transmisión de la vista previa en directo.
• partial (valor predeterminado): sustituir el texto de la vista previa por la salida parcial más reciente.
• block: añadir actualizaciones fragmentadas a la vista previa.
• progress: mostrar texto del 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, dirigir las actualizaciones de herramientas/progreso al mismo mensaje de vista previa editado (valor predeterminado: true). Establezca false para conservar mensajes separados de herramientas/progreso.
• streaming.preview.commandText / streaming.progress.commandText: establezca status para conservar líneas compactas del progreso de las herramientas y ocultar el texto sin procesar de comandos/ejecución (valor predeterminado: raw).

Ocultar el texto sin procesar de comandos/ejecución y conservar líneas compactas de progreso:

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

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

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

• Debe haber un hilo de respuestas disponible para que aparezcan la transmisión de texto nativa 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 grupales 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 existe un hilo de respuestas.
• Los mensajes directos de Slack de nivel superior permanecen fuera de los hilos de forma predeterminada, por lo que no muestran la vista previa de transmisión o estado nativa con formato de hilo de Slack; en su lugar, OpenClaw publica y edita una vista previa del borrador en el mensaje directo.
• Los archivos multimedia y las cargas útiles que no son de texto recurren a la entrega normal.
• Los resultados finales de archivos multimedia o errores cancelan las ediciones pendientes de la vista previa; los resultados finales de texto o bloques aptos solo se envían cuando pueden editar la vista previa en el mismo lugar.
• Si la transmisión falla durante una respuesta, OpenClaw recurre a la entrega normal para las cargas útiles restantes.

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

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

Habilitar 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.
• Los valores 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; ejecutar openclaw doctor --fix para reescribir la configuración persistente de transmisión de Slack con las claves canónicas.

Reacción alternativa al escribir

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 especialmente ú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 aplica en la medida de lo posible y se intenta eliminar automáticamente después de que finalice la ruta de respuesta o de error.

Entrada de voz

Actualmente, para hablar con OpenClaw en Slack, enviar 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 para aplicaciones.

• El dictado por 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 ningún archivo de audio, evento de dictado, solicitud ni marcador de origen de entrada a aplicaciones de Slack de terceros mediante la Events API. 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 pipeline 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 están sujetos a 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ítulo puede satisfacer la condición pronunciando un patrón de mención configurado (agents.entries.*.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 que no coincida se descarta junto con el clip descargado; no se conserva en el historial del canal. La identidad nativa @bot de Slack no puede deducirse 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.

Archivos multimedia, fragmentación y entrega

Comandos y comportamiento de las barras diagonales

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

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

/openclaw /help

Los comandos nativos requieren ajustes adicionales del manifiesto en la aplicación de Slack y, en su lugar, 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:

• De 3 a 5 opciones suficientemente cortas: un menú de desbordamiento («...»)
• Más de 100 opciones, con filtrado asíncrono de opciones disponible: selector externo
• De 1 a 2 opciones, o cualquier opción cuyo valor codificado sea demasiado largo para un selector: bloques de botones
• En los demás casos (de 6 a 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 de barra diagonal usan claves aisladas como agent:<agentId>:slack:slash:<userId> y siguen dirigiendo la ejecución de comandos a la sesión de la conversación de destino mediante CommandTargetSessionKey.

Gráficos nativos

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

{  "blocks": [    {      "type": "chart",      "chartType": "bar",      "title": "Ingresos trimestrales",      "categories": ["T1", "T2"],      "series": [{ "name": "Ingresos", "values": [120, 145] }],      "xLabel": "Trimestre"    }  ]}

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

• Título y etiquetas opcionales de los ejes: 50 caracteres
• Sectores: de 1 a 12 segmentos positivos
• Líneas, barras o áreas: de 1 a 12 series con nombres únicos y de 1 a 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 gráficos de sectores pueden ser negativos

Cada gráfico nativo también contiene una representación textual de nivel superior para lectores de pantalla, notificaciones, duplicació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 por fases, OpenClaw elimina los bloques de datos nativos rechazados, conserva los controles relacionados 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 de seguimiento, 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 planes de pago. El texto sobre la disponibilidad para Business+/Enterprise se aplica a la generación automática de gráficos mediante IA de Slackbot, que es independiente de que una aplicación envíe un gráfico de Block Kit ya estructurado. Los gráficos son bloques exclusivos de mensajes, no contenido de App Home, ventanas modales ni Canvas.

Tablas nativas

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

{  "blocks": [    {      "type": "table",      "caption": "Pipeline abierto",      "headers": ["Cuenta", "Etapa", "ARR"],      "rows": [        ["Acme", "Ganado", 125000],        ["Globex", "Revisión", 82000]      ],      "rowHeaderColumnIndex": 0    }  ]}

OpenClaw asigna las celdas de encabezado y de cadenas 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. Cuando está presente, rowHeaderColumnIndex marca esa columna, cuyo índice comienza en cero, como encabezado de las filas de Slack.

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

• De 1 a 20 columnas
• De 1 a 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 en total entre todas las celdas de las tablas de un mensaje

Se pueden representar de forma nativa varios bloques de tablas válidos mientras el mensaje permanezca 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 excede un mensaje de Slack, los envíos y las respuestas a comandos de 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 las 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, duplicación de sesiones y clientes que no pueden renderizar el bloque. Los valores sin procesar de gráficos y tablas se mantienen literales en la alternativa, por lo que los 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 los gráficos y las tablas con el formato de Slack deshabilitado. La entrega de comandos de barra controla el presupuesto de cinco llamadas 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 Markdown con barras verticales permanecen como texto creado; OpenClaw no infiere 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 con formato incorrecto pueden degradarse a su leyenda o a la alternativa general de Block Kit. La salida portable del agente, la CLI y los plugins debe usar presentation.

Respuestas interactivas

Slack puede renderizar controles de respuesta interactivos creados por el agente, pero esta función está deshabilitada de forma predeterminada. Para las nuevas salidas de agentes, la CLI y plugins, se recomienda usar los botones o bloques de selección compartidos presentation. Utilizan la misma ruta de interacción de Slack y también se degradan correctamente en otros canales.

Para habilitarla globalmente:

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

O para habilitarla únicamente 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 Slack Block Kit y enrutan los clics o las selecciones a través de la ruta existente de eventos de interacción de Slack. Consérvelas para prompts antiguos 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 presentation y buildSlackPresentationBlocks(...) para los nuevos controles renderizados en Slack.

Notas:

• Esta es una interfaz de usuario heredada específica de Slack. Otros canales no traducen las directivas de Slack Block Kit a sus propios sistemas de botones.
• Los valores de devolución de llamada interactivos son tokens opacos generados por OpenClaw, no valores sin procesar creados por el agente.
• 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.

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 de modales antes de que OpenClaw compacte la carga útil para el evento del sistema visible para el agente. Use uno de estos patrones de enrutamiento 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 el private_metadata del modal.

El controlador recibe ctx.interaction.kind como view_submission o view_closed, inputs normalizado y el objeto stateValues completo sin procesar de Slack. El enrutamiento solo mediante el ID de devolución de llamada basta para invocar el controlador del plugin; incluya los campos existentes de enrutamiento de usuario/sesión 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 de aprobación nativo con botones e interacciones, en lugar de recurrir a la interfaz web o al terminal.

• Las aprobaciones de ejecución y plugins pueden renderizarse como prompts nativos de Slack mediante Block Kit.
• channels.slack.execApprovals.* sigue siendo la configuración de habilitación del cliente nativo de aprobación de ejecución y de enrutamiento a mensajes directos/canales.
• 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 de aprobación nativo para la sesión de origen, o cuando approvals.plugin enruta a la sesión de Slack de origen o a un destino de Slack.
• Los mensajes directos de aprobación de plugins usan los aprobadores de plugins de Slack de channels.slack.allowFrom, el allowFrom de la cuenta con nombre o la ruta predeterminada de la cuenta.
• La autorización del aprobador sigue aplicándose: los aprobadores exclusivos de ejecución no pueden aprobar solicitudes de plugins salvo que también sean aprobadores de plugins.

Esto utiliza la misma superficie compartida de botones de aprobación que otros canales. Cuando interactivity está habilitado en la configuración de la 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, constituyen la experiencia de aprobación principal; OpenClaw solo debe incluir un comando manual /approve cuando el resultado de la herramienta indique que las aprobaciones mediante 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 es posible)
• channels.slack.execApprovals.target (dm | channel | both, valor predeterminado: dm)
• agentFilter, sessionFilter

Slack habilita automáticamente las aprobaciones nativas de ejecución cuando enabled no está definido o es "auto" y se resuelve al menos un aprobador de ejecución. Slack también puede 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 las aprobaciones nativas cuando se resuelvan los aprobadores. Deshabilitar las aprobaciones de ejecución de Slack no deshabilita la entrega nativa de aprobaciones de plugins de Slack habilitada mediante approvals.plugin; la entrega de aprobaciones de plugins utiliza en su lugar los aprobadores de plugins de Slack.

Comportamiento predeterminado sin una 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 desean 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 approvals.exec es independiente. Úselo solo cuando los prompts de aprobación de ejecución también deban enrutarse a otros chats o a destinos explícitos fuera de banda. El reenvío compartido approvals.plugin también es independiente; la entrega nativa de Slack suprime esa alternativa únicamente cuando Slack puede gestionar la solicitud de aprobación del plugin de forma nativa.

/approve en el mismo chat también funciona en 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 y 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.
• El sondeo opcional de presencia puede asignar la transición de away a active de un participante humano observado a la sesión de Slack apta y activa más reciente del participante. Está deshabilitado de forma predeterminada.
• 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.
• Las entidades app_context de Agent View se validan en el orden de relevancia de Slack y solo se exponen como contexto estructurado no confiable; un contexto omitido borra el turno en lugar de reutilizar entidades obsoletas.
• El inicio del hilo y la inicialización del contexto del historial inicial del hilo se filtran mediante las listas de remitentes permitidos configuradas cuando corresponda.
• Las acciones de bloques, los accesos directos y las interacciones de modales emiten eventos del sistema Slack interaction: ... estructurados con campos de carga útil detallados:
  • acciones de bloques: valores seleccionados, etiquetas, valores del selector 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 view_submission y view_closed de modales con metadatos de canal enrutados y entradas del formulario

Defina accesos directos globales o de mensajes en la configuración de su aplicación de Slack y use cualquier ID de devolución de llamada que no esté vacío. OpenClaw confirma las cargas útiles de accesos directos coincidentes, aplica la misma política de remitentes de mensajes directos/canales que a otras interacciones de Slack y pone en cola el evento depurado para la sesión enrutada del agente. Los ID de activador y las URL de respuesta se censuran del contexto del agente.

Eventos de presencia

Slack no envía cambios de presencia mediante Events API ni Socket Mode. En su lugar, OpenClaw puede consultar periódicamente users.getPresence para los participantes humanos cuyos mensajes hayan superado las comprobaciones normales de acceso y enrutamiento de Slack.

{  channels: {    slack: {      presenceEvents: { mode: "auto" },      channels: {        C0123456789: { presenceEvents: { mode: "on" } },        C0987654321: { presenceEvents: { mode: "off" } },      },    },  },}

• off (valor predeterminado): sin temporizador de presencia ni llamadas a la API de Slack.
• auto: supervisa los mensajes directos, MPIM y los hilos de Slack activos durante las últimas 24 horas con un máximo de 8 participantes humanos observados. Se excluyen las sesiones de canal de nivel superior.
• on: supervisa las mismas conversaciones sin el límite de participantes e incluye las sesiones de canal de nivel superior. Use una anulación por canal para forzar o suprimir un canal.

OpenClaw consulta como máximo a 45 usuarios únicos por minuto y por cuenta de Slack, inicializa el primer resultado sin activar al agente y solo lo activa cuando observa una transición de away a active. Se aplica un periodo de espera persistente de 8 horas por cuenta de Slack y usuario, incluso si esa persona participa en varios hilos. El evento solo se enruta a la conversación apta y activa más reciente de esa persona e indica al agente que consulte la memoria/wiki y el contexto de zona horaria conocido antes de decidir si envía un saludo breve. El agente puede permanecer en silencio.

El token del bot necesita users:read, que ya está incluido en el manifiesto recomendado. Los eventos de presencia no están disponibles para instalaciones de Enterprise Grid en toda la organización.

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 medios adjuntos

Slack puede adjuntar los 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 clips de audio pueden transcribirse, los archivos de imagen pueden pasar por la ruta de comprensión de medios o directamente a un modelo de respuesta con capacidad de visión, y los demás archivos permanecen disponibles como contexto de archivo descargable.

Tipos de medios compatibles

Pipeline de entrada

Cuando llega un mensaje de Slack con archivos adjuntos:

1. OpenClaw descarga el archivo desde la URL privada de Slack utilizando el token del bot.
2. Si la descarga se realiza correctamente, el archivo se escribe en el almacén de medios.
3. Las rutas y los tipos de contenido de los medios descargados se añaden al contexto de entrada.
4. Los clips de audio se dirigen al Pipeline de transcripción compartido; las rutas de modelos/herramientas con capacidad para imágenes pueden utilizar los archivos de imagen adjuntos del mismo contexto.
5. Los demás archivos permanecen disponibles como metadatos de archivo o referencias de medios para las herramientas capaces de procesarlos.

Herencia de archivos adjuntos de la raíz del hilo

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

• Si la propia respuesta no tiene medios directos y el mensaje raíz incluido contiene archivos, Slack puede incorporar los archivos raíz como contexto de inicio del hilo.
• Los archivos 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 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 con un marcador de posición de adjunto para que la ruta alternativa pueda incluir sus archivos.

Manejo de varios archivos adjuntos

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

• Cada archivo adjunto se procesa de forma independiente mediante el Pipeline de medios.
• Las referencias a 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 en la descarga de un archivo adjunto no bloquea los demás.

Límites de tamaño, descarga y modelo

• Límite de tamaño: valor predeterminado de 20 MB por archivo. Configurable mediante channels.slack.mediaMaxMb.
• Límite de transcripción de audio: el valor maxBytes de la entrada tools.media.models[] seleccionada con capacidad de audio 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, los archivos que superan el tamaño permitido 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 utiliza 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

• Pipeline de comprensión multimedia
• Audio y notas de voz
• Herramienta de PDF

Temas relacionados