---
read_when:
- Configurar Slack o depurar el modo de socket, HTTP o retransmisión de Slack
summary: Configuración de Slack y comportamiento en tiempo de ejecución (Socket Mode, URL de solicitud HTTP y modo de retransmisión)
title: Slack
x-i18n:
generated_at: "2026-07-12T14:20:55Z"
model: gpt-5.6
postprocess_version: locale-links-v1
prompt_version: 15
provider: openai
source_hash: c29d2dccefc54d3972fd8ff4edccfdc3779c030a8d51f29a750a0057d9f0998e
source_path: channels/slack.md
workflow: 16
---
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.
Los mensajes directos de Slack usan de forma predeterminada el modo de vinculación.
Comportamiento de los comandos nativos y catálogo de comandos.
Diagnósticos multicanal y procedimientos de reparación.
## 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.
| Aspecto | Socket Mode (predeterminado) | URL de solicitud HTTP |
| ---------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------- |
| URL pública del Gateway | No es necesaria | Es necesaria (DNS, TLS, proxy inverso o túnel) |
| Red saliente | Debe poder accederse mediante WSS saliente a `wss-primary.slack.com` | Sin WS saliente; solo HTTPS entrante |
| Tokens necesarios | Token del bot + App-Level Token con `connections:write` | Token del bot + Signing Secret |
| Portátil de desarrollo/detrás de un cortafuegos | Funciona sin cambios | Necesita un túnel público (ngrok, Cloudflare Tunnel, Tailscale Funnel) o un Gateway de preproducción |
| Escalado horizontal | Una sesión de Socket Mode por aplicación y host; varios Gateways necesitan aplicaciones de Slack independientes | Controlador POST sin estado; varias réplicas del Gateway pueden compartir una aplicación detrás de un equilibrador de carga |
| Varias cuentas en un Gateway | Compatible; cada cuenta abre su propio WS | Compatible; cada cuenta necesita un `webhookPath` único (predeterminado: `/slack/events`) para evitar que los registros entren en conflicto |
| Transporte de comandos con barra diagonal | Se entregan mediante la conexión WS; se ignora `slash_commands[].url` | Slack envía solicitudes POST a `slash_commands[].url`; el campo es obligatorio para despachar el comando |
| Firma de solicitudes | No se utiliza (la autenticación corresponde al App-Level Token) | Slack firma cada solicitud; OpenClaw la verifica con `signingSecret` |
| Recuperación tras perder la conexión | La reconexión automática del SDK de Slack está habilitada; OpenClaw también reinicia las sesiones de Socket Mode fallidas con una espera progresiva limitada. Se aplica el ajuste del transporte para el tiempo de espera de pong. | No hay una conexión persistente que pueda perderse; Slack gestiona los reintentos por solicitud |
**Elija Socket Mode** para hosts con un único Gateway, portátiles de desarrollo y redes locales que puedan acceder de forma saliente a `*.slack.com`, pero no aceptar HTTPS entrante.
**Elija URL de solicitud HTTP** cuando ejecute varias réplicas del Gateway detrás de un equilibrador de carga, cuando WSS saliente esté bloqueado pero HTTPS entrante esté permitido, o cuando ya termine los webhooks de Slack en un proxy inverso.
Slack puede mantener varias conexiones de Socket Mode para una aplicación y entregar cada carga útil a cualquiera de ellas. Por lo tanto, los Gateways de OpenClaw independientes que compartan una aplicación de Slack necesitan configuraciones equivalentes de enrutamiento y autorización. De lo contrario, use una aplicación de Slack independiente por Gateway, una única entrada de retransmisión o URL de solicitud HTTP detrás de un equilibrador de carga. Consulte [Uso de Socket Mode](https://docs.slack.dev/apis/events-api/using-socket-mode#using-multiple-connections).
### 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.
```json5
{
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
```json
{
"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:
```json5
{
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`):
```json
{
"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:
```json5
{
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:`. 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
```bash
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](/es/tools/plugin) 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](#enterprise-grid-org-wide-installs).
Abra [api.slack.com/apps](https://api.slack.com/apps/new) → **Create New App** → **From a manifest** → seleccione el espacio de trabajo → pegue uno de los manifiestos siguientes → **Next** → **Create**.
```json Recommended
{
"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"
]
}
}
}
```
```json Minimal
{
"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"
]
}
}
}
```
**Recommended** coincide con el conjunto completo de funciones del plugin de Slack: App Home, comandos de barra diagonal, archivos, reacciones, elementos fijados, mensajes directos grupales y lectura de emojis y grupos de usuarios. Elija **Minimal** cuando la política del espacio de trabajo restrinja los ámbitos: cubre mensajes directos, historial de canales y grupos, menciones y comandos de barra diagonal, pero omite archivos, reacciones, elementos fijados, mensajes directos grupales (`mpim:*`), `emoji:read` y `usergroups:read`. Consulte [Lista de comprobación del manifiesto y los ámbitos](#manifest-and-scope-checklist) para conocer la justificación de cada ámbito y opciones adicionales como comandos de barra diagonal adicionales.
Después de que Slack cree la aplicación:
- **Basic Information -> App-Level Tokens -> Generate Token and Scopes**: añada `connections:write`, guarde y copie el token de nivel de aplicación.
- **Install App -> Install to Workspace**: copie el token OAuth del usuario bot.
Configuración recomendada de SecretRef:
```bash
export SLACK_APP_TOKEN=slack-app-token-example
export SLACK_BOT_TOKEN=slack-bot-token-example
cat > slack.socket.patch.json5 <<'JSON5'
{
channels: {
slack: {
enabled: true,
mode: "socket",
appToken: { source: "env", provider: "default", id: "SLACK_APP_TOKEN" },
botToken: { source: "env", provider: "default", id: "SLACK_BOT_TOKEN" },
},
},
}
JSON5
openclaw config patch --file ./slack.socket.patch.json5 --dry-run
openclaw config patch --file ./slack.socket.patch.json5
```
Alternativa mediante variables de entorno (solo para la cuenta predeterminada):
```bash
SLACK_APP_TOKEN=slack-app-token-example
SLACK_BOT_TOKEN=slack-bot-token-example
```
```bash
openclaw gateway
```
Abra [api.slack.com/apps](https://api.slack.com/apps/new) → **Create New App** → **From a manifest** → seleccione el espacio de trabajo → pegue uno de los manifiestos siguientes → sustituya `https://gateway-host.example.com/slack/events` por la URL pública del Gateway → **Next** → **Create**.
```json Recommended
{
"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"
}
}
}
```
```json Minimal
{
"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"
}
}
}
```
**Recomendado** coincide con el conjunto completo de funciones del plugin de Slack; **Mínimo** omite archivos, reacciones, elementos fijados, mensajes directos de grupo (`mpim:*`), `emoji:read` y `usergroups:read` para espacios de trabajo restrictivos. Consulta [Lista de comprobación del manifiesto y los alcances](#manifest-and-scope-checklist) para conocer la justificación de cada alcance.
Los tres campos de URL (`slash_commands[].url`, `event_subscriptions.request_url` e `interactivity.request_url` / `message_menu_options_url`) apuntan al mismo endpoint de OpenClaw. El esquema de manifiesto de Slack exige que tengan nombres distintos, pero OpenClaw enruta según el tipo de carga útil, por lo que basta con un único `webhookPath` (valor predeterminado: `/slack/events`). Los comandos de barra sin `slash_commands[].url` no realizan ninguna acción silenciosamente en el modo HTTP.
Después de que Slack cree la aplicación:
- **Basic Information → App Credentials**: copia el **Signing Secret** para verificar las solicitudes.
- **Install App -> Install to Workspace**: copia el Bot User OAuth Token.
Configuración recomendada de SecretRef:
```bash
export SLACK_BOT_TOKEN=slack-bot-token-example
export SLACK_SIGNING_SECRET=...
cat > slack.http.patch.json5 <<'JSON5'
{
channels: {
slack: {
enabled: true,
mode: "http",
botToken: { source: "env", provider: "default", id: "SLACK_BOT_TOKEN" },
signingSecret: { source: "env", provider: "default", id: "SLACK_SIGNING_SECRET" },
webhookPath: "/slack/events",
},
},
}
JSON5
openclaw config patch --file ./slack.http.patch.json5 --dry-run
openclaw config patch --file ./slack.http.patch.json5
```
Usa rutas de Webhook únicas para HTTP con varias cuentas
Asigna a cada cuenta un `webhookPath` distinto (valor predeterminado: `/slack/events`) para evitar que los registros entren en conflicto.
```bash
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:
```json5
{
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..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):
```json
{
"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:
```json
{
"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.
Se pueden usar varios [comandos de barra nativos](#commands-and-slash-behavior) en lugar de un único comando configurado, con algunas consideraciones:
- Usa `/agentstatus` en lugar de `/status` porque el comando `/status` está reservado.
- No se pueden registrar más de 25 comandos de barra a la vez en una aplicación de Slack (límite de la plataforma de Slack).
Sustituye la sección `features.slash_commands` existente por un subconjunto de los [comandos disponibles](/es/tools/slash-commands#command-list):
```json
{
"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 or max-age "
},
{
"command": "/think",
"description": "Establecer el nivel de razonamiento",
"usage_hint": ""
},
{
"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= security= ask= node="
},
{
"command": "/approve",
"description": "Aprobar o denegar solicitudes de aprobación pendientes",
"usage_hint": " "
},
{
"command": "/model",
"description": "Mostrar o establecer el modelo",
"usage_hint": "[name|#|status]"
},
{
"command": "/models",
"description": "Enumerar proveedores/modelos",
"usage_hint": "[provider] [page] [limit=|size=|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": " [input]"
},
{
"command": "/btw",
"description": "Hacer una pregunta aparte sin cambiar el contexto de la sesión",
"usage_hint": ""
},
{
"command": "/side",
"description": "Hacer una pregunta aparte sin cambiar el contexto de la sesión",
"usage_hint": ""
},
{
"command": "/usage",
"description": "Controlar el pie de uso o mostrar el resumen de costes",
"usage_hint": "off|tokens|full|cost"
}
]
}
```
Use la misma lista `slash_commands` que en el modo Socket anterior y añada `"url": "https://gateway-host.example.com/slack/events"` a cada entrada. Ejemplo:
```json
{
"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"
}
]
}
```
Repita ese valor de `url` en cada comando de la lista.
Añada el ámbito de bot `chat:write.customize` si desea que los mensajes salientes utilicen la identidad del agente activo (nombre de usuario e icono personalizados) en lugar de la identidad predeterminada de la aplicación de Slack.
Si utiliza un icono de emoji, Slack espera la sintaxis `:emoji_name:`.
Si configura `channels.slack.userToken`, los ámbitos de lectura habituales son:
- `channels:history`, `groups:history`, `im:history`, `mpim:history`
- `channels:read`, `groups:read`, `im:read`, `mpim:read`
- `users:read`
- `reactions:read`
- `pins:read`
- `emoji:read`
- `search:read` (si depende de las lecturas de búsqueda de Slack)
## 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`.
Para acciones y lecturas del directorio, se puede dar preferencia al token de usuario cuando esté configurado. Para las escrituras, se sigue dando preferencia al token de bot; las escrituras con tokens de usuario solo se permiten cuando `userTokenReadOnly: false` y el token de bot no está disponible.
## Acciones y controles
Las acciones de Slack se controlan mediante `channels.slack.actions.*`.
Grupos de acciones disponibles en las herramientas actuales de Slack:
| Grupo | Valor predeterminado |
| ---------- | -------------------- |
| messages | habilitado |
| reactions | habilitado |
| pins | habilitado |
| memberInfo | habilitado |
| emojiList | habilitado |
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
`channels.slack.dmPolicy` controla el acceso a los mensajes directos. `channels.slack.allowFrom` es la lista de permitidos canónica para los mensajes directos.
- `pairing` (valor predeterminado)
- `allowlist`
- `open` (requiere que `channels.slack.allowFrom` incluya `"*"`)
- `disabled`
Indicadores de mensajes directos:
- `dm.enabled` (valor predeterminado: true)
- `channels.slack.allowFrom`
- `dm.allowFrom` (heredado)
- `dm.groupEnabled` (valor predeterminado de los mensajes directos grupales: false)
- `dm.groupChannels` (lista de MPIM permitidos opcional)
Precedencia entre varias cuentas:
- `channels.slack.accounts.default.allowFrom` se aplica únicamente a la cuenta `default`.
- Las cuentas con nombre heredan `channels.slack.allowFrom` cuando no tienen establecido su propio `allowFrom`.
- Las cuentas con nombre no heredan `channels.slack.accounts.default.allowFrom`.
Los valores heredados `channels.slack.dm.policy` y `channels.slack.dm.allowFrom` todavía se leen por compatibilidad. `openclaw doctor --fix` los migra a `dmPolicy` y `allowFrom` cuando puede hacerlo sin cambiar el acceso.
El emparejamiento en mensajes directos utiliza `openclaw pairing approve slack `.
`channels.slack.groupPolicy` controla el tratamiento de los canales:
- `open`
- `allowlist`
- `disabled`
La lista de canales permitidos se encuentra en `channels.slack.channels` y **debe utilizar identificadores estables de canales de Slack** (por ejemplo, `C12345678`) como claves de configuración.
Nota sobre el entorno de ejecución: si falta por completo `channels.slack` (configuración solo mediante el entorno), el entorno de ejecución recurre a `groupPolicy="allowlist"` y registra una advertencia (aunque se haya establecido `channels.defaults.groupPolicy`).
Resolución de nombres e identificadores:
- las entradas de la lista de canales permitidos y de la lista de mensajes directos permitidos se resuelven durante el inicio cuando el acceso mediante token lo permite
- las entradas de nombres de canales sin resolver se conservan tal como se configuraron, pero se ignoran de forma predeterminada para el enrutamiento
- de forma predeterminada, la autorización entrante y el enrutamiento de canales dan prioridad a los identificadores; la coincidencia directa con nombres de usuario o slugs requiere `channels.slack.dangerouslyAllowNameMatching: true`
Las claves basadas en nombres (`#channel-name` o `channel-name`) **no** coinciden con `groupPolicy: "allowlist"`. La búsqueda de canales da prioridad a los identificadores de forma predeterminada, por lo que una clave basada en nombres nunca se enrutará correctamente y todos los mensajes de ese canal se bloquearán de forma silenciosa. Esto difiere de `groupPolicy: "open"`, donde la clave del canal no es necesaria para el enrutamiento y una clave basada en nombres parece funcionar.
Utilice siempre el identificador del canal de Slack como clave. Para encontrarlo: haga clic con el botón derecho en el canal en Slack → **Copy link**; el identificador (`C...`) aparece al final de la URL.
Correcto:
```json5
{
channels: {
slack: {
groupPolicy: "allowlist",
channels: {
C12345678: { enabled: true, requireMention: true },
},
},
},
}
```
Incorrecto (se bloquea de forma silenciosa con `groupPolicy: "allowlist"`):
```json5
{
channels: {
slack: {
groupPolicy: "allowlist",
channels: {
"#eng-my-channel": { enabled: true, requireMention: true },
},
},
},
}
```
De forma predeterminada, los mensajes de los canales requieren una mención.
Fuentes de menciones:
- mención explícita de la aplicación (`<@botId>`)
- mención de un grupo de usuarios de Slack (``) cuando el usuario del bot pertenece a ese grupo de usuarios; requiere `usergroups:read`
- patrones de expresiones regulares de menciones (`agents.list[].groupChat.mentionPatterns`, con `messages.groupChat.mentionPatterns` como valor de reserva)
- comportamiento implícito de respuesta al hilo del bot (deshabilitado cuando `thread.requireExplicitMention` es `true`)
Controles por canal (`channels.slack.channels.`; nombres solo mediante la resolución durante el inicio o `dangerouslyAllowNameMatching`):
- `requireMention`
- `ignoreOtherMentions`
- `replyToMode` (`off|first|all|batched`; sustituye el modo de respuesta de la cuenta o del tipo de chat para este canal)
- `users` (lista de permitidos)
- `allowBots`
- `skills`
- `systemPrompt`
- `tools`, `toolsBySender`
- formato de las claves de `toolsBySender`: `channel:`, `id:`, `e164:`, `username:`, `name:` o el comodín `"*"`
(las claves heredadas sin prefijo todavía se asignan únicamente a `id:`)
`ignoreOtherMentions` (valor predeterminado: `false`) descarta los mensajes del canal que mencionan a otro usuario o grupo de usuarios, pero no a este bot. Los mensajes directos y los mensajes directos grupales (MPIM) no se ven afectados. El filtro requiere un identificador de usuario del bot resuelto mediante `auth.test`; si esa identidad no está disponible (por ejemplo, una identidad que solo utiliza un token de usuario), el control permite el paso y los mensajes continúan sin cambios.
`allowBots` adopta un enfoque conservador para los canales y los canales privados: los mensajes de sala creados por bots solo se aceptan cuando el bot remitente figura explícitamente en la lista `users` de permitidos de esa sala, o cuando al menos un identificador explícito de propietario de Slack de `channels.slack.allowFrom` pertenece actualmente a la sala. Los comodines y las entradas de propietarios basadas en nombres visibles no cumplen el requisito de presencia del propietario. La presencia del propietario utiliza `conversations.members` de Slack; asegúrese de que la aplicación tenga el ámbito de lectura correspondiente al tipo de sala (`channels:read` para canales públicos y `groups:read` para canales privados). Si falla la consulta de miembros, OpenClaw descarta el mensaje de sala creado por el bot.
Los mensajes de Slack aceptados y creados por bots usan la [protección compartida contra bucles de bots](/es/channels/bot-loop-protection). Configure `channels.defaults.botLoopProtection` para el límite predeterminado y, a continuación, sobrescríbalo con `channels.slack.botLoopProtection` o `channels.slack.channels..botLoopProtection` cuando un espacio de trabajo o canal necesite un límite diferente.
## 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::slack:channel:`.
- 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:`), 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::slack:channel::thread:` 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..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:]]`
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.
`replyToMode="off"` desactiva los hilos de respuestas salientes de Slack, incluidas las etiquetas explícitas `[[reply_to_*]]`. No aplana las sesiones de hilos entrantes de Slack: los mensajes ya publicados dentro de un hilo de Slack siguen enrutándose a la sesión `:thread:`. Esto difiere de Telegram, donde las etiquetas explícitas se siguen respetando en el modo `"off"`. Los hilos de Slack ocultan los mensajes del canal, mientras que las respuestas de Telegram permanecen visibles en línea.
## 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..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.
El ámbito predeterminado (`"group-mentions"`) no activa reacciones de confirmación en mensajes directos ni en eventos ambientales de sala. Para ver el valor configurado de `ackReaction` (por ejemplo, `"eyes"`) en mensajes directos entrantes de Slack y eventos de salas silenciosas, establezca `messages.ackReactionScope` en `"all"`. `messages.ackReactionScope` se lee al iniciar el proveedor de Slack, por lo que es necesario reiniciar el Gateway para que el cambio surta efecto.
```json5
{
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:
```json
{
"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:
```json5
{
channels: {
slack: {
streaming: {
mode: "partial",
nativeTransport: false,
},
},
},
}
```
Habilite voluntariamente las tarjetas de tareas de progreso nativas de Slack:
```json5
{
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..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](https://slack.com/help/articles/202026038-How-to-use-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](https://slack.com/help/articles/4406235165587-Record-audio-and-video-clips-in-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](/es/nodes/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
Los archivos adjuntos de Slack se descargan desde URL privadas alojadas en Slack (flujo de solicitudes autenticadas mediante token) y se escriben en el almacén multimedia cuando la recuperación se completa correctamente y los límites de tamaño lo permiten. Los marcadores de posición de archivos incluyen el `fileId` de Slack para que los agentes puedan recuperar el archivo original con `download-file`.
Las descargas usan tiempos de espera inactivos y totales limitados. Si la recuperación del archivo de Slack se bloquea o falla, OpenClaw continúa procesando el mensaje y recurre al marcador de posición del archivo.
El límite de tamaño entrante en tiempo de ejecución es de `20MB` de forma predeterminada, salvo que `channels.slack.mediaMaxMb` lo sobrescriba.
- los fragmentos de texto usan `channels.slack.textChunkLimit` (valor predeterminado: `8000`, limitado por el propio límite de longitud de mensajes de Slack)
- `channels.slack.streaming.chunkMode="newline"` habilita la división priorizando los párrafos
- los envíos de archivos usan las API de carga de Slack y pueden incluir respuestas en hilos (`thread_ts`)
- los pies de archivo largos usan el primer fragmento de texto compatible con Slack como comentario de la carga y envían los fragmentos restantes como mensajes posteriores
- el límite de medios salientes sigue `channels.slack.mediaMaxMb` cuando está configurado; de lo contrario, los envíos del canal usan los valores predeterminados por tipo MIME de la canalización de medios
Destinos explícitos preferidos:
- `user:` para mensajes directos
- `channel:` para canales
Los mensajes directos de Slack que solo contienen texto o bloques pueden publicarse directamente en identificadores de usuario; las cargas de archivos y los envíos en hilos abren primero el mensaje directo mediante las API de conversaciones de Slack, porque esas rutas requieren un identificador de conversación concreto.
## 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`
```txt
/openclaw /help
```
En cambio, los comandos nativos requieren [ajustes adicionales del manifiesto](#additional-manifest-settings) 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.
```txt
/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ú
```txt
/think
```
Las sesiones de comandos con barra diagonal usan claves aisladas como `agent::slack:slash:` 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](https://docs.slack.dev/reference/block-kit/blocks/data-visualization-block/)
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`.
```json
{
"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](https://docs.slack.dev/changelog/2026/06/16/block-kit-data-visualization-block/)
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](https://docs.slack.dev/reference/block-kit/blocks/data-table-block/)
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](https://docs.slack.dev/reference/block-kit/blocks/table-block/)
de Slack. No se requiere ningún ámbito de OAuth ni configuración de Slack adicional aparte del acceso normal
a mensajes `chat:write`.
```json
{
"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:
```json5
{
channels: {
slack: {
capabilities: {
interactiveReplies: true,
},
},
},
}
```
O habilítela solo para una cuenta de Slack:
```json5
{
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::`.
- O conserve un `callback_id` existente y coloque `pluginInteractiveData:
":"` 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:
```json5
{
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:
```json5
{
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](/es/tools/exec-approvals) 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](/es/gateway/config-channels#slack).
- modo/autenticación: `mode`, `enterpriseOrgInstall`, `botToken`, `appToken`, `signingSecret`, `webhookPath`, `accounts.*`
- acceso a mensajes directos: `dm.enabled`, `dmPolicy`, `allowFrom` (heredado: `dm.policy`, `dm.allowFrom`), `dm.groupEnabled`, `dm.groupChannels`
- opción de compatibilidad: `dangerouslyAllowNameMatching` (recurso de emergencia; manténgala desactivada salvo que sea necesaria)
- acceso a canales: `groupPolicy`, `channels.*`, `channels.*.users`, `channels.*.requireMention`
- hilos/historial: `replyToMode`, `replyToModeByChatType`, `thread.*`, `historyLimit`, `dmHistoryLimit`, `dms.*.historyLimit`
- entrega: `textChunkLimit`, `streaming.chunkMode`, `mediaMaxMb`, `streaming`, `streaming.nativeTransport`, `streaming.preview.toolProgress`
- vistas previas: `unfurlLinks` (valor predeterminado: `false`), `unfurlMedia` para controlar la vista previa de enlaces y contenido multimedia de `chat.postMessage`; establezca `unfurlLinks: true` para volver a habilitar las vistas previas de enlaces
- operaciones/funciones: `configWrites`, `commands.native`, `slashCommand.*`, `actions.*`, `userToken`, `userTokenReadOnly`
## Solución de problemas
Compruebe, en este orden:
- `groupPolicy`
- lista de canales permitidos (`channels.slack.channels`): **las claves deben ser ID de canales** (`C12345678`), no nombres (`#channel-name`). Las claves basadas en nombres fallan silenciosamente con `groupPolicy: "allowlist"` porque, de forma predeterminada, el enrutamiento de canales prioriza los ID. Para encontrar un ID: haga clic con el botón derecho en el canal de Slack → **Copy link**; el valor `C...` al final de la URL es el ID del canal.
- `requireMention`
- lista de `users` permitidos por canal
- `messages.groupChat.visibleReplies`: las solicitudes normales de grupos o canales usan de forma predeterminada `"automatic"`. Si se optó por `"message_tool"` y los registros muestran texto del asistente sin ninguna llamada a `message(action=send)`, el modelo no siguió la ruta visible de la herramienta de mensajes. En este modo, el texto final permanece privado; inspeccione el registro detallado del Gateway para consultar los metadatos de la carga útil suprimida, o establézcalo en `"automatic"` si se quiere que todas las respuestas finales normales del asistente se publiquen mediante la ruta heredada.
- `messages.groupChat.unmentionedInbound`: si es `"room_event"`, la conversación permitida del canal sin menciones constituye contexto ambiental y permanece silenciosa salvo que el agente llame a la herramienta `message`. Consulte [Eventos ambientales de sala](/es/channels/ambient-room-events).
```json5
{
messages: {
groupChat: {
visibleReplies: "automatic",
},
},
}
```
Comandos útiles:
```bash
openclaw channels status --probe
openclaw logs --follow
openclaw doctor
```
Compruebe:
- `channels.slack.dm.enabled`
- `channels.slack.dmPolicy` (o el valor heredado `channels.slack.dm.policy`)
- aprobaciones de vinculación o entradas de la lista de permitidos (`dmPolicy: "open"` sigue requiriendo `channels.slack.allowFrom: ["*"]`)
- los mensajes directos grupales usan la gestión de MPIM; habilite `channels.slack.dm.groupEnabled` y, si está configurado, incluya el MPIM en `channels.slack.dm.groupChannels`
- eventos de mensajes directos del asistente de Slack: los registros detallados que mencionan `drop message_changed`
suelen indicar que Slack envió un evento editado del hilo del asistente sin un
remitente humano recuperable en los metadatos del mensaje
```bash
openclaw pairing list slack
```
Valide los tokens del bot y de la aplicación, así como que Socket Mode esté habilitado en la configuración de la aplicación de Slack.
El App-Level Token necesita `connections:write`, y el token del bot Bot User OAuth Token
debe pertenecer a la misma aplicación y espacio de trabajo de Slack que el token de la aplicación.
Si `openclaw channels status --probe --json` muestra `botTokenStatus` o
`appTokenStatus: "configured_unavailable"`, la cuenta de Slack está
configurada, pero el entorno de ejecución actual no pudo resolver el valor
respaldado por SecretRef.
Los registros como `slack socket mode failed to start; retry ...` son fallos de inicio
recuperables. Los permisos ausentes, los tokens revocados y la autenticación no válida producen un fallo inmediato.
Un registro `slack token mismatch ...` indica que el token del bot y el token de la aplicación
parecen pertenecer a aplicaciones de Slack diferentes; corrija las credenciales de la aplicación de Slack.
Valide:
- secreto de firma
- ruta del Webhook
- Slack Request URLs (Events + Interactivity + Slash Commands)
- un `webhookPath` único para cada cuenta HTTP
- que la URL pública termine TLS y reenvíe las solicitudes a la ruta del Gateway
- que la ruta `request_url` de la aplicación de Slack coincida exactamente con `channels.slack.webhookPath` (valor predeterminado: `/slack/events`)
Si `signingSecretStatus: "configured_unavailable"` aparece en las instantáneas
de la cuenta, la cuenta HTTP está configurada, pero el entorno de ejecución actual no pudo
resolver el secreto de firma respaldado por SecretRef.
Un registro repetido `slack: webhook path ... already registered` indica que dos cuentas HTTP
usan el mismo `webhookPath`; asigne una ruta distinta a cada cuenta.
Verifique cuál de estas opciones se pretendía usar:
- modo de comandos nativos (`channels.slack.commands.native: true`) con comandos de barra coincidentes registrados en Slack
- o modo de comando de barra único (`channels.slack.slashCommand.enabled: true`)
Slack no crea ni elimina comandos de barra automáticamente. `commands.native: "auto"` no habilita los comandos nativos de Slack; use `true` y cree los comandos coincidentes en la aplicación de Slack. En modo HTTP, cada comando de barra de Slack debe incluir la URL del Gateway. En Socket Mode, las cargas útiles de los comandos llegan mediante el websocket y Slack ignora `slash_commands[].url`.
Compruebe también `commands.useAccessGroups`, la autorización de mensajes directos, las listas de canales permitidos
y las listas de `users` permitidos por canal. Slack devuelve errores efímeros a los
remitentes de comandos de barra bloqueados, entre ellos:
- `This channel is not allowed.`
- `You are not authorized to use this command here.`
## 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
| Tipo de contenido multimedia | Origen | Comportamiento actual | Notas |
| ------------------------------ | -------------------- | --------------------------------------------------------------------------------- | ------------------------------------------------------------------------- |
| Clips de audio de Slack | URL de archivo de Slack | Se descargan y se enrutan mediante la transcripción de audio compartida | Requiere `files:read` y un modelo o una CLI de `tools.media.audio` funcional |
| Imágenes JPEG / PNG / GIF / WebP | URL de archivo de Slack | Se descargan y se adjuntan al turno para su procesamiento con capacidad de visión | Límite por archivo: `channels.slack.mediaMaxMb` (valor predeterminado: 20 MB) |
| Archivos PDF | URL de archivo de Slack | Se descargan y se exponen como contexto de archivo para herramientas como `download-file` o `pdf` | La entrada de Slack no convierte automáticamente los PDF en datos de visión de imágenes |
| Otros archivos | URL de archivo de Slack | Se descargan cuando es posible y se exponen como contexto de archivo | Los archivos binarios no se tratan como datos de imagen |
| Respuestas de hilos | Archivos del mensaje inicial del hilo | Los archivos del mensaje raíz pueden incorporarse como contexto cuando la respuesta no contiene contenido multimedia directo | Los mensajes iniciales que solo contienen archivos usan un marcador de posición de archivo adjunto |
| Mensajes con varios archivos | Varios archivos de Slack | Cada archivo se evalúa de forma independiente | El procesamiento de Slack está limitado a ocho archivos por mensaje |
### 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
| Situación | Comportamiento actual | Solución alternativa |
| --------------------------------------------- | ---------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------- |
| URL de archivo de Slack caducada | Se omite el archivo; no se muestra ningún error | Vuelva a cargar el archivo en Slack |
| Transcripción de audio no disponible | El clip permanece adjunto, pero no se genera ninguna transcripción | Configure `tools.media.audio` o instale una CLI de transcripción local compatible |
| Un clip sin texto no supera un filtro de mención | Se descarta tras una transcripción especulativa privada; la transcripción y la descarga también se eliminan | Configure un patrón de mención del nombre hablado, añada una mención escrita del bot o use un mensaje directo |
| Modelo de visión no configurado | Los archivos adjuntos de imagen se almacenan como referencias de medios, pero no se analizan como imágenes | Configure `agents.defaults.imageModel` o use un modelo de respuesta con capacidad de visión |
| Imágenes muy grandes (> 20 MB de forma predeterminada) | Se omiten conforme al límite de tamaño | Aumente `channels.slack.mediaMaxMb` si Slack lo permite |
| Archivos adjuntos reenviados o compartidos | El texto y los medios de imagen o archivo alojados en Slack se procesan con el mejor esfuerzo posible | Vuelva a compartirlos directamente en el hilo de OpenClaw |
| Archivos PDF adjuntos | Se almacenan como contexto de archivo o medios, pero no se dirigen automáticamente al análisis visual | Use `download-file` para obtener los metadatos del archivo o la herramienta `pdf` para analizar el PDF |
### Documentación relacionada
- [Proceso de comprensión de medios](/es/nodes/media-understanding)
- [Audio y notas de voz](/es/nodes/audio)
- [Herramienta PDF](/es/tools/pdf)
## Contenido relacionado
Vincule un usuario de Slack con el Gateway.
Comportamiento de los canales y los mensajes directos grupales.
Dirija los mensajes entrantes a los agentes.
Modelo de amenazas y refuerzo de la seguridad.
Estructura y precedencia de la configuración.
Catálogo y comportamiento de los comandos.