Slack - OpenClaw

La compatibilidad con Slack cubre DM y canales mediante integraciones de apps de Slack. El transporte predeterminado es Socket Mode; también se admiten URL de solicitud HTTP. El modo relay es para despliegues gestionados donde un router de confianza posee la entrada de Slack.

Emparejamiento

Los DM de Slack usan el modo de emparejamiento de forma predeterminada.

Comandos slash

Comportamiento de comandos nativos y catálogo de comandos.

Solución de problemas de canales

Diagnósticos entre canales y guías de reparación.

Elegir un transporte

Socket Mode y las URL de solicitud HTTP alcanzan paridad de funciones para mensajería, comandos slash, App Home e interactividad. Elige según la forma del despliegue, no según las funciones.

Aspecto	Socket Mode (predeterminado)	URL de solicitud HTTP
URL pública del Gateway	No requerida	Requerida (DNS, TLS, proxy inverso o túnel)
Red saliente	WSS saliente a `wss-primary.slack.com` debe ser alcanzable	Sin WS saliente; solo HTTPS entrante
Tokens necesarios	Token de bot + token de nivel de app con `connections:write`	Token de bot + Signing Secret
Portátil de desarrollo / detrás de firewall	Funciona tal cual	Necesita un túnel público (ngrok, Cloudflare Tunnel, Tailscale Funnel) o un Gateway de staging
Escalado horizontal	Una sesión de Socket Mode por app y por host; varios Gateways necesitan apps de Slack separadas	Manejador POST sin estado; varias réplicas de Gateway pueden compartir una app detrás de un balanceador 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 que los registros no colisionen
Transporte de comandos slash	Entregado a través de la conexión WS; `slash_commands[].url` se ignora	Slack envía POST a `slash_commands[].url`; el campo es obligatorio para despachar el comando
Firma de solicitudes	No se usa (la autenticación es el token de nivel de app)	Slack firma cada solicitud; OpenClaw verifica con `signingSecret`
Recuperación al caer 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 retroceso acotado. Se aplica el ajuste de transporte por tiempo de espera de Pong.	No hay conexión persistente que pueda caer; los reintentos son por solicitud desde Slack

Elige Socket Mode para hosts con un solo Gateway, portátiles de desarrollo y redes locales que pueden alcanzar *.slack.com de salida pero no pueden aceptar HTTPS entrante.Elige URL de solicitud HTTP cuando ejecutes varias réplicas de Gateway detrás de un balanceador de carga, cuando WSS saliente esté bloqueado pero HTTPS entrante esté permitido, o cuando ya termines los webhooks de Slack en un proxy inverso.

Slack puede mantener varias conexiones de Socket Mode para una app y puede entregar cada carga a cualquier conexión. Por lo tanto, los gateways de OpenClaw separados que comparten una app de Slack necesitan una configuración de enrutamiento y autorización equivalente. De lo contrario, usa una app de Slack separada por gateway, una única entrada relay o URL de solicitud HTTP detrás de un balanceador de carga. Consulta Usar Socket Mode.

Modo relay

El modo relay separa la entrada de Slack del gateway de OpenClaw. Un router de confianza posee la única conexión de Slack Socket Mode, elige un gateway de destino y reenvía un evento tipado por un websocket autenticado. El gateway sigue usando su 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 relay debe usar wss:// salvo que apunte a localhost. Trata el token bearer y la tabla de rutas del router como parte del límite de autorización de Slack: los eventos enrutados entran en el manejador normal de mensajes de Slack como activaciones autorizadas. Un slack_identity proporcionado por el router en el marco hello del websocket puede establecer el nombre de usuario y el icono salientes predeterminados; una identidad explícita proporcionada por el llamador sigue teniendo prioridad. La conexión relay se reconecta con la misma temporización de retroceso acotado que Socket Mode y borra la identidad proporcionada por el router cada vez que se desconecta.

Instalación

openclaw plugins install @openclaw/slack

plugins install registra y habilita el Plugin. No hace nada hasta que configures la app de Slack y los ajustes de canal a continuación. Consulta Plugins para ver las reglas generales de instalación de plugins.

Configuración rápida

Socket Mode (predeterminado)
HTTP Request URLs

Crear una nueva app de Slack

Abre api.slack.com/apps → Create New App → From a manifest → selecciona tu espacio de trabajo → pega uno de los manifiestos siguientes → Next → Create.

{
  "display_information": {
    "name": "OpenClaw",
    "description": "Slack connector for OpenClaw"
  },
  "features": {
    "bot_user": { "display_name": "OpenClaw", "always_online": true },
    "app_home": {
      "home_tab_enabled": true,
      "messages_tab_enabled": true,
      "messages_tab_read_only_enabled": false
    },
    "assistant_view": {
      "assistant_description": "OpenClaw connects Slack assistant threads to OpenClaw agents.",
      "suggested_prompts": [
        { "title": "What can you do?", "message": "What can you help me with?" },
        {
          "title": "Summarize this channel",
          "message": "Summarize the recent activity in this channel."
        },
        { "title": "Draft a reply", "message": "Help me draft a reply." }
      ]
    },
    "slash_commands": [
      {
        "command": "/openclaw",
        "description": "Send a message to OpenClaw",
        "should_escape": false
      }
    ]
  },
  "oauth_config": {
    "scopes": {
      "bot": [
        "app_mentions:read",
        "assistant:write",
        "channels:history",
        "channels:read",
        "chat:write",
        "commands",
        "emoji:read",
        "files:read",
        "files:write",
        "groups:history",
        "groups:read",
        "im:history",
        "im:read",
        "im:write",
        "mpim:history",
        "mpim:read",
        "mpim:write",
        "pins:read",
        "pins:write",
        "reactions:read",
        "reactions:write",
        "usergroups:read",
        "users:read"
      ]
    }
  },
  "settings": {
    "socket_mode_enabled": true,
    "event_subscriptions": {
      "bot_events": [
        "app_home_opened",
        "app_mention",
        "assistant_thread_context_changed",
        "assistant_thread_started",
        "channel_rename",
        "member_joined_channel",
        "member_left_channel",
        "message.channels",
        "message.groups",
        "message.im",
        "message.mpim",
        "pin_added",
        "pin_removed",
        "reaction_added",
        "reaction_removed"
      ]
    }
  }
}

{
  "display_information": {
    "name": "OpenClaw",
    "description": "Slack connector for OpenClaw"
  },
  "features": {
    "bot_user": { "display_name": "OpenClaw", "always_online": true },
    "app_home": {
      "home_tab_enabled": true,
      "messages_tab_enabled": true,
      "messages_tab_read_only_enabled": false
    },
    "assistant_view": {
      "assistant_description": "OpenClaw connects Slack assistant threads to OpenClaw agents.",
      "suggested_prompts": [
        { "title": "What can you do?", "message": "What can you help me with?" },
        {
          "title": "Summarize this channel",
          "message": "Summarize the recent activity in this channel."
        },
        { "title": "Draft a reply", "message": "Help me draft a reply." }
      ]
    },
    "slash_commands": [
      {
        "command": "/openclaw",
        "description": "Send a message to OpenClaw",
        "should_escape": false
      }
    ]
  },
  "oauth_config": {
    "scopes": {
      "bot": [
        "app_mentions:read",
        "assistant:write",
        "channels:history",
        "channels:read",
        "chat:write",
        "commands",
        "groups:history",
        "groups:read",
        "im:history",
        "im:read",
        "im:write",
        "users:read"
      ]
    }
  },
  "settings": {
    "socket_mode_enabled": true,
    "event_subscriptions": {
      "bot_events": [
        "app_home_opened",
        "app_mention",
        "assistant_thread_context_changed",
        "assistant_thread_started",
        "message.channels",
        "message.groups",
        "message.im"
      ]
    }
  }
}

Recomendado coincide con el conjunto completo de funciones del plugin de Slack: App Home, comandos slash, archivos, reacciones, pines, DM de grupo y lecturas de emoji/grupos de usuarios. Elige Mínimo cuando la política del espacio de trabajo restrinja los ámbitos: cubre DM, historial de canales/grupos, menciones y comandos slash, pero elimina archivos, reacciones, pines, DM de grupo (mpim:*), emoji:read y usergroups:read. Consulta Lista de comprobación de manifiesto y ámbitos para ver la justificación por ámbito y opciones aditivas como comandos slash adicionales.

Después de que Slack cree la app:

Basic Information -> App-Level Tokens -> Generate Token and Scopes: añade connections:write, guarda y copia el token de nivel de app.
Install App -> Install to Workspace: copia el token OAuth de usuario de bot.

Configurar OpenClaw

Configuración SecretRef recomendada:

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

Respaldo de entorno (solo cuenta predeterminada):

SLACK_APP_TOKEN=slack-app-token-example
SLACK_BOT_TOKEN=slack-bot-token-example

Start gateway

openclaw gateway

Create a new Slack app

Abre api.slack.com/apps → Create New App → From a manifest → selecciona tu espacio de trabajo → pega uno de los manifiestos siguientes → reemplaza https://gateway-host.example.com/slack/events por tu URL pública del Gateway → Next → Create.

{
  "display_information": {
    "name": "OpenClaw",
    "description": "Slack connector for OpenClaw"
  },
  "features": {
    "bot_user": { "display_name": "OpenClaw", "always_online": true },
    "app_home": {
      "home_tab_enabled": true,
      "messages_tab_enabled": true,
      "messages_tab_read_only_enabled": false
    },
    "assistant_view": {
      "assistant_description": "OpenClaw connects Slack assistant threads to OpenClaw agents.",
      "suggested_prompts": [
        { "title": "What can you do?", "message": "What can you help me with?" },
        {
          "title": "Summarize this channel",
          "message": "Summarize the recent activity in this channel."
        },
        { "title": "Draft a reply", "message": "Help me draft a reply." }
      ]
    },
    "slash_commands": [
      {
        "command": "/openclaw",
        "description": "Send a message to OpenClaw",
        "should_escape": false,
        "url": "https://gateway-host.example.com/slack/events"
      }
    ]
  },
  "oauth_config": {
    "scopes": {
      "bot": [
        "app_mentions:read",
        "assistant:write",
        "channels:history",
        "channels:read",
        "chat:write",
        "commands",
        "emoji:read",
        "files:read",
        "files:write",
        "groups:history",
        "groups:read",
        "im:history",
        "im:read",
        "im:write",
        "mpim:history",
        "mpim:read",
        "mpim:write",
        "pins:read",
        "pins:write",
        "reactions:read",
        "reactions:write",
        "usergroups:read",
        "users:read"
      ]
    }
  },
  "settings": {
    "event_subscriptions": {
      "request_url": "https://gateway-host.example.com/slack/events",
      "bot_events": [
        "app_home_opened",
        "app_mention",
        "assistant_thread_context_changed",
        "assistant_thread_started",
        "channel_rename",
        "member_joined_channel",
        "member_left_channel",
        "message.channels",
        "message.groups",
        "message.im",
        "message.mpim",
        "pin_added",
        "pin_removed",
        "reaction_added",
        "reaction_removed"
      ]
    },
    "interactivity": {
      "is_enabled": true,
      "request_url": "https://gateway-host.example.com/slack/events",
      "message_menu_options_url": "https://gateway-host.example.com/slack/events"
    }
  }
}

{
  "display_information": {
    "name": "OpenClaw",
    "description": "Slack connector for OpenClaw"
  },
  "features": {
    "bot_user": { "display_name": "OpenClaw", "always_online": true },
    "app_home": {
      "home_tab_enabled": true,
      "messages_tab_enabled": true,
      "messages_tab_read_only_enabled": false
    },
    "assistant_view": {
      "assistant_description": "OpenClaw connects Slack assistant threads to OpenClaw agents.",
      "suggested_prompts": [
        { "title": "What can you do?", "message": "What can you help me with?" },
        {
          "title": "Summarize this channel",
          "message": "Summarize the recent activity in this channel."
        },
        { "title": "Draft a reply", "message": "Help me draft a reply." }
      ]
    },
    "slash_commands": [
      {
        "command": "/openclaw",
        "description": "Send a message to OpenClaw",
        "should_escape": false,
        "url": "https://gateway-host.example.com/slack/events"
      }
    ]
  },
  "oauth_config": {
    "scopes": {
      "bot": [
        "app_mentions:read",
        "assistant:write",
        "channels:history",
        "channels:read",
        "chat:write",
        "commands",
        "groups:history",
        "groups:read",
        "im:history",
        "im:read",
        "im:write",
        "users:read"
      ]
    }
  },
  "settings": {
    "event_subscriptions": {
      "request_url": "https://gateway-host.example.com/slack/events",
      "bot_events": [
        "app_home_opened",
        "app_mention",
        "assistant_thread_context_changed",
        "assistant_thread_started",
        "message.channels",
        "message.groups",
        "message.im"
      ]
    },
    "interactivity": {
      "is_enabled": true,
      "request_url": "https://gateway-host.example.com/slack/events",
      "message_menu_options_url": "https://gateway-host.example.com/slack/events"
    }
  }
}

Recomendado coincide con el conjunto completo de funciones del Plugin de Slack; Mínimo elimina archivos, reacciones, elementos fijados, mensajes directos de grupo (mpim:*), emoji:read y usergroups:read para espacios de trabajo restrictivos. Consulta la Lista de comprobación de manifiesto y alcances para ver 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 todos al mismo endpoint de OpenClaw. El esquema de manifiesto de Slack exige que se nombren por separado, pero OpenClaw enruta por tipo de carga útil, así que un único webhookPath (predeterminado: /slack/events) es suficiente. Los comandos de barra diagonal sin slash_commands[].url no hacen nada silenciosamente en modo HTTP.

Después de que Slack cree la aplicación:

Basic Information → App Credentials: copia el Signing Secret para la verificación de solicitudes.
Install App -> Install to Workspace: copia el Bot User OAuth Token.

Configure OpenClaw

Configuración recomendada de SecretRef:

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 cuentasDale a cada cuenta un webhookPath distinto (predeterminado: /slack/events) para que los registros no colisionen.

Start gateway

openclaw gateway

Ajuste del transporte de Socket Mode

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

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

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

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

Lista de comprobación de manifiesto y alcances

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

{
  "display_information": {
    "name": "OpenClaw",
    "description": "Slack connector for OpenClaw"
  },
  "features": {
    "bot_user": { "display_name": "OpenClaw", "always_online": true },
    "app_home": {
      "home_tab_enabled": true,
      "messages_tab_enabled": true,
      "messages_tab_read_only_enabled": false
    },
    "assistant_view": {
      "assistant_description": "OpenClaw connects Slack assistant threads to OpenClaw agents.",
      "suggested_prompts": [
        { "title": "What can you do?", "message": "What can you help me with?" },
        {
          "title": "Summarize this channel",
          "message": "Summarize the recent activity in this channel."
        },
        { "title": "Draft a reply", "message": "Help me draft a reply." }
      ]
    },
    "slash_commands": [
      {
        "command": "/openclaw",
        "description": "Send a message to OpenClaw",
        "should_escape": false
      }
    ]
  },
  "oauth_config": {
    "scopes": {
      "bot": [
        "app_mentions:read",
        "assistant:write",
        "channels:history",
        "channels:read",
        "chat:write",
        "commands",
        "emoji:read",
        "files:read",
        "files:write",
        "groups:history",
        "groups:read",
        "im:history",
        "im:read",
        "im:write",
        "mpim:history",
        "mpim:read",
        "mpim:write",
        "pins:read",
        "pins:write",
        "reactions:read",
        "reactions:write",
        "usergroups:read",
        "users:read"
      ]
    }
  },
  "settings": {
    "socket_mode_enabled": true,
    "event_subscriptions": {
      "bot_events": [
        "app_home_opened",
        "app_mention",
        "assistant_thread_context_changed",
        "assistant_thread_started",
        "channel_rename",
        "member_joined_channel",
        "member_left_channel",
        "message.channels",
        "message.groups",
        "message.im",
        "message.mpim",
        "pin_added",
        "pin_removed",
        "reaction_added",
        "reaction_removed"
      ]
    }
  }
}

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

{
  "features": {
    "slash_commands": [
      {
        "command": "/openclaw",
        "description": "Send a message to OpenClaw",
        "should_escape": false,
        "url": "https://gateway-host.example.com/slack/events"
      }
    ]
  },
  "settings": {
    "event_subscriptions": {
      "request_url": "https://gateway-host.example.com/slack/events",
      "bot_events": [
        "app_home_opened",
        "app_mention",
        "assistant_thread_context_changed",
        "assistant_thread_started",
        "channel_rename",
        "member_joined_channel",
        "member_left_channel",
        "message.channels",
        "message.groups",
        "message.im",
        "message.mpim",
        "pin_added",
        "pin_removed",
        "reaction_added",
        "reaction_removed"
      ]
    },
    "interactivity": {
      "is_enabled": true,
      "request_url": "https://gateway-host.example.com/slack/events",
      "message_menu_options_url": "https://gateway-host.example.com/slack/events"
    }
  }
}

Configuración adicional del manifiesto

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

Comandos slash nativos opcionales

Se pueden usar varios comandos slash nativos en lugar de un único comando configurado, con algunos matices:

Usa /agentstatus en lugar de /status porque el comando /status está reservado.
No se pueden registrar más de 25 comandos slash en una app de Slack a la vez (límite de la plataforma Slack).

Sustituye tu sección features.slash_commands existente por un subconjunto de comandos disponibles:

Socket Mode (predeterminado)
URL de solicitud HTTP

{
  "slash_commands": [
    {
      "command": "/new",
      "description": "Start a new session",
      "usage_hint": "[model]"
    },
    {
      "command": "/reset",
      "description": "Reset the current session"
    },
    {
      "command": "/compact",
      "description": "Compact the session context",
      "usage_hint": "[instructions]"
    },
    {
      "command": "/stop",
      "description": "Stop the current run"
    },
    {
      "command": "/session",
      "description": "Manage thread-binding expiry",
      "usage_hint": "idle <duration|off> or max-age <duration|off>"
    },
    {
      "command": "/think",
      "description": "Set the thinking level",
      "usage_hint": "<level>"
    },
    {
      "command": "/verbose",
      "description": "Toggle verbose output",
      "usage_hint": "on|off|full"
    },
    {
      "command": "/fast",
      "description": "Show or set fast mode",
      "usage_hint": "[status|on|off]"
    },
    {
      "command": "/reasoning",
      "description": "Toggle reasoning visibility",
      "usage_hint": "[on|off|stream]"
    },
    {
      "command": "/elevated",
      "description": "Toggle elevated mode",
      "usage_hint": "[on|off|ask|full]"
    },
    {
      "command": "/exec",
      "description": "Show or set exec defaults",
      "usage_hint": "host=<auto|sandbox|gateway|node> security=<deny|allowlist|full> ask=<off|on-miss|always> node=<id>"
    },
    {
      "command": "/approve",
      "description": "Approve or deny pending approval requests",
      "usage_hint": "<id> <decision>"
    },
    {
      "command": "/model",
      "description": "Show or set the model",
      "usage_hint": "[name|#|status]"
    },
    {
      "command": "/models",
      "description": "List providers/models",
      "usage_hint": "[provider] [page] [limit=<n>|size=<n>|all]"
    },
    {
      "command": "/help",
      "description": "Show the short help summary"
    },
    {
      "command": "/commands",
      "description": "Show the generated command catalog"
    },
    {
      "command": "/tools",
      "description": "Show what the current agent can use right now",
      "usage_hint": "[compact|verbose]"
    },
    {
      "command": "/agentstatus",
      "description": "Show runtime status, including provider usage/quota when available"
    },
    {
      "command": "/tasks",
      "description": "List active/recent background tasks for the current session"
    },
    {
      "command": "/context",
      "description": "Explain how context is assembled",
      "usage_hint": "[list|detail|json]"
    },
    {
      "command": "/whoami",
      "description": "Show your sender identity"
    },
    {
      "command": "/skill",
      "description": "Run a skill by name",
      "usage_hint": "<name> [input]"
    },
    {
      "command": "/btw",
      "description": "Ask a side question without changing session context",
      "usage_hint": "<question>"
    },
    {
      "command": "/side",
      "description": "Ask a side question without changing session context",
      "usage_hint": "<question>"
    },
    {
      "command": "/usage",
      "description": "Control the usage footer or show cost summary",
      "usage_hint": "off|tokens|full|cost"
    }
  ]
}

Usa la misma lista slash_commands que en Socket Mode arriba y añade "url": "https://gateway-host.example.com/slack/events" a cada entrada. Ejemplo:

{
  "slash_commands": [
    {
      "command": "/new",
      "description": "Start a new session",
      "usage_hint": "[model]",
      "url": "https://gateway-host.example.com/slack/events"
    },
    {
      "command": "/help",
      "description": "Show the short help summary",
      "url": "https://gateway-host.example.com/slack/events"
    }
  ]
}

Repite ese valor url en cada comando de la lista.

Ámbitos de autoría opcionales (operaciones de escritura)

Añade el ámbito de bot chat:write.customize si quieres que los mensajes salientes usen la identidad del agente activo (nombre de usuario e icono personalizados) en lugar de la identidad predeterminada de la app de Slack.Si usas un icono de emoji, Slack espera la sintaxis :emoji_name:.

Ámbitos opcionales de token de usuario (operaciones de lectura)

Si configuras channels.slack.userToken, los ámbitos de lectura típicos 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 dependes de lecturas de búsqueda de Slack)

Modelo de tokens

botToken + appToken son obligatorios para Socket Mode.
El modo HTTP requiere botToken + signingSecret.
El modo de relay requiere botToken más relay.url, relay.authToken y relay.gatewayId; no usa un token de app 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 anulan el respaldo de env.
Los respaldos de env SLACK_BOT_TOKEN, SLACK_APP_TOKEN y SLACK_USER_TOKEN se aplican cada uno solo 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 rastrea por credencial los campos *Source y *Status (botToken, appToken, signingSecret, userToken).
El estado es available, configured_unavailable o missing.
configured_unavailable significa que la cuenta está configurada mediante SecretRef u otra fuente de secreto no en línea, pero la ruta actual de comando/runtime no pudo resolver el valor real.
En modo HTTP, se incluye signingSecretStatus; en Socket Mode, el par requerido es botTokenStatus + appTokenStatus.

Para acciones/lecturas de directorio, se puede preferir el token de usuario cuando esté configurado. Para escrituras, se sigue prefiriendo el token de bot; las escrituras con token 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	Predeterminado
messages	enabled
reactions	enabled
pins	enabled
memberInfo	enabled
emojiList	enabled

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 ID de archivo de Slack que se muestran en los marcadores de posición de archivos entrantes y devuelve vistas previas de imágenes para imágenes o metadatos de archivo local para otros tipos de archivo.

Control de acceso y enrutamiento

Política de DM
Política de canales
Menciones y usuarios de canales

channels.slack.dmPolicy controla el acceso a DM. channels.slack.allowFrom es la lista de permitidos canónica de DM.

pairing (predeterminado)
allowlist
open (requiere que channels.slack.allowFrom incluya "*")
disabled

Flags de DM:

dm.enabled (true de forma predeterminada)
channels.slack.allowFrom
dm.allowFrom (heredado)
dm.groupEnabled (DM de grupo false de forma predeterminada)
dm.groupChannels (lista de permitidos MPIM opcional)

Precedencia de varias cuentas:

channels.slack.accounts.default.allowFrom se aplica solo a la cuenta default.
Las cuentas con nombre heredan channels.slack.allowFrom cuando su propio allowFrom no está definido.
Las cuentas con nombre no heredan channels.slack.accounts.default.allowFrom.

Los valores heredados channels.slack.dm.policy y channels.slack.dm.allowFrom aún se leen por compatibilidad. openclaw doctor --fix los migra a dmPolicy y allowFrom cuando puede hacerlo sin cambiar el acceso.El emparejamiento en DM usa openclaw pairing approve slack <code>.

channels.slack.groupPolicy controla el manejo de canales:

open
allowlist
disabled

La lista de permitidos de canales vive bajo channels.slack.channels y debe usar ID estables de canales de Slack (por ejemplo, C12345678) como claves de configuración.Nota de runtime: si falta por completo channels.slack (configuración solo con env), runtime recurre a groupPolicy="allowlist" y registra una advertencia (incluso si channels.defaults.groupPolicy está definido).Resolución de nombres/ID:

las entradas de lista de permitidos de canales y de lista de permitidos de DM se resuelven al iniciar cuando el acceso del token lo permite
las entradas de nombre de canal no resueltas se mantienen tal como están configuradas, pero se ignoran para el enrutamiento de forma predeterminada
la autorización entrante y el enrutamiento de canales priorizan el ID de forma predeterminada; la coincidencia directa por nombre de usuario/slug requiere channels.slack.dangerouslyAllowNameMatching: true

Las claves basadas en nombre (#channel-name o channel-name) no coinciden bajo groupPolicy: "allowlist". La búsqueda de canales prioriza el ID de forma predeterminada, por lo que una clave basada en nombre nunca se enrutará correctamente y todos los mensajes de ese canal se bloquearán silenciosamente. Esto difiere de groupPolicy: "open", donde la clave de canal no es necesaria para el enrutamiento y una clave basada en nombre parece funcionar.Usa siempre el ID de canal de Slack como clave. Para encontrarlo: haz clic derecho en el canal en Slack → Copiar enlace — el ID (C...) aparece al final de la URL.Correcto:

{
  channels: {
    slack: {
      groupPolicy: "allowlist",
      channels: {
        C12345678: { allow: true, requireMention: true },
      },
    },
  },
}

Incorrecto (bloqueado silenciosamente bajo groupPolicy: "allowlist"):

{
  channels: {
    slack: {
      groupPolicy: "allowlist",
      channels: {
        "#eng-my-channel": { allow: true, requireMention: true },
      },
    },
  },
}

Los mensajes de canal están sujetos a menciones de forma predeterminada.Fuentes de mención:

mención explícita de la aplicación (<@botId>)
mención de grupo de usuarios de Slack (<!subteam^S...>) cuando el usuario bot es miembro de ese grupo de usuarios; requiere usergroups:read
patrones regex de mención (agents.list[].groupChat.mentionPatterns, reserva messages.groupChat.mentionPatterns)
comportamiento implícito de hilo en respuesta al bot (deshabilitado cuando thread.requireExplicitMention es true)

Controles por canal (channels.slack.channels.<id>; nombres solo mediante resolución de inicio o dangerouslyAllowNameMatching):

requireMention
ignoreOtherMentions
replyToMode (off|first|all|batched; anula el modo de respuesta de cuenta/tipo de chat para este canal)
users (allowlist)
allowBots
skills
systemPrompt
tools, toolsBySender
formato de clave de toolsBySender: channel:, id:, e164:, username:, name:, o comodín "*" (las claves heredadas sin prefijo todavía se asignan solo a id:)

ignoreOtherMentions (predeterminado false) descarta mensajes de canal que mencionan a otro usuario o grupo de usuarios, pero no a este bot. Los MD y los MD de grupo (MPIM) no se ven afectados. El filtro requiere un ID de usuario bot resuelto desde auth.test; si esa identidad no está disponible (por ejemplo, una identidad solo con token de usuario), la compuerta falla abierta y los mensajes pasan sin cambios.allowBots es conservador para canales y canales privados: los mensajes de sala creados por bots se aceptan solo cuando el bot remitente está incluido explícitamente en la allowlist de users de esa sala, o cuando al menos un ID de propietario explícito de Slack de channels.slack.allowFrom es miembro actual de la sala. Los comodines y las entradas de propietario por nombre visible no satisfacen la presencia de propietario. La presencia de propietario usa conversations.members de Slack; asegúrate de que la aplicación tenga el alcance de lectura correspondiente para el tipo de sala (channels:read para canales públicos, groups:read para canales privados). Si la búsqueda de miembros falla, OpenClaw descarta el mensaje de sala creado por bot.Los mensajes de Slack creados por bots y aceptados usan la protección compartida contra bucles de bots. Configura channels.defaults.botLoopProtection para el presupuesto predeterminado, luego anúlalo con channels.slack.botLoopProtection o channels.slack.channels.<id>.botLoopProtection cuando un espacio de trabajo o canal necesite un límite diferente.

Hilos, sesiones y etiquetas de respuesta

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

Controles de hilos de respuesta:

channels.slack.channels.<id>.replyToMode: anulación por canal para mensajes de canales/canales privados de Slack
channels.slack.replyToMode: off|first|all|batched (predeterminado off)
channels.slack.replyToModeByChatType: por direct|group|channel
reserva heredada para chats directos: channels.slack.dm.replyToMode

Se admiten etiquetas de respuesta manuales:

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

Para respuestas explícitas de hilos de Slack desde la herramienta message, establece replyBroadcast: true con action: "send" y threadId o replyTo para pedir a Slack que también difunda la respuesta del hilo al canal padre. Esto se asigna 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 de medios. Cuando una llamada a la herramienta message se ejecuta dentro de un hilo de Slack y apunta al mismo canal, OpenClaw normalmente hereda el hilo actual de Slack según 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 anulación por canal. Establece topLevel: true en action: "send" o action: "upload-file" para forzar un nuevo mensaje en el canal padre. threadId: null se acepta como la misma exclusión de nivel superior.

replyToMode="off" deshabilita los hilos de respuesta saliente 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 todavía se enrutan a la sesión :thread:<threadTs>. Esto difiere de Telegram, donde las etiquetas explícitas todavía se respetan en modo "off". Los hilos de Slack ocultan los mensajes del canal, mientras que las respuestas de Telegram permanecen visibles en línea.

Reacciones de acuse de recibo

ackReaction envía un emoji de acuse de recibo mientras OpenClaw procesa un mensaje entrante. ackReactionScope decide cuándo se envía realmente ese emoji. De forma predeterminada, el acuse de recibo permanece estático mientras el estado de hilo de asistente nativo de Slack muestra el progreso con mensajes de carga rotativos. Establece messages.statusReactions.enabled: true para optar por el ciclo de vida de reacciones de en cola/pensando/herramienta/completado/error.

Emoji (`ackReaction`)

Orden de resolución:

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

Notas:

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

Alcance (`messages.ackReactionScope`)

El proveedor de Slack lee el alcance desde messages.ackReactionScope (predeterminado "group-mentions"). Hoy no hay anulación a nivel de cuenta de Slack ni de canal de Slack; el valor es global para el gateway. Valores:

"all": reaccionar en MD y grupos, incluidos eventos de sala ambientales.
"direct": reaccionar solo en MD.
"group-all": reaccionar en cada mensaje de grupo excepto eventos de sala ambientales (sin MD).
"group-mentions" (predeterminado): reaccionar en grupos, pero solo cuando se menciona al bot (o en mencionables de grupo que optaron por participar). Los MD están excluidos.
"off" / "none": nunca reaccionar.

El alcance predeterminado ("group-mentions") no dispara reacciones de acuse de recibo en mensajes directos ni eventos de sala ambientales. Para ver el ackReaction configurado (por ejemplo "eyes") en MD entrantes de Slack y eventos de sala silenciosos, establece messages.ackReactionScope en "all". messages.ackReactionScope se lee al iniciar el proveedor de Slack, por lo que se necesita reiniciar el Gateway para que el cambio surta efecto.

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

Streaming de texto

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

off: deshabilita el streaming de vista previa en vivo.
partial (predeterminado): reemplaza el texto de vista previa por la salida parcial más reciente.
block: agrega actualizaciones de vista previa fragmentadas.
progress: muestra texto de estado de progreso mientras se genera y luego envía el texto final.
streaming.preview.toolProgress: cuando la vista previa de borrador está activa, enruta las actualizaciones de herramienta/progreso al mismo mensaje de vista previa editado (predeterminado: true). Establece false para mantener mensajes separados de herramienta/progreso.
streaming.preview.commandText / streaming.progress.commandText: establece en status para mantener líneas compactas de progreso de herramienta mientras ocultas el texto sin procesar de comando/exec (predeterminado: raw).

Oculta el texto sin procesar de comando/exec mientras mantienes líneas compactas de progreso:

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

channels.slack.streaming.nativeTransport controla el streaming de texto nativo de Slack cuando channels.slack.streaming.mode es partial (predeterminado: true). Las tarjetas de tareas de progreso nativas de Slack son opcionales para el modo de progreso. Establece channels.slack.streaming.progress.nativeTaskCards en true con channels.slack.streaming.mode="progress" para enviar una tarjeta de plan/tarea nativa de Slack mientras el trabajo está en ejecución, y luego actualizar la misma tarjeta de tarea al completarse. Sin esta marca, el modo de progreso conserva el comportamiento portable de vista previa de borrador.

Debe haber un hilo de respuesta disponible para que aparezcan el streaming de texto nativo y el estado de hilo de asistente de Slack. La selección de hilo sigue respetando replyToMode.
Las raíces de canal, chat de grupo y MD de nivel superior todavía pueden usar la vista previa de borrador normal cuando el streaming nativo no está disponible o no existe ningún hilo de respuesta.
Los MD de Slack de nivel superior permanecen fuera de hilo de forma predeterminada, por lo que no muestran la vista previa de streaming/estado nativa con estilo de hilo de Slack; OpenClaw publica y edita una vista previa de borrador en el MD en su lugar.
Los medios y las cargas que no son de texto recurren a la entrega normal.
Los finales de medios/error cancelan las ediciones de vista previa pendientes; los finales de texto/bloque aptos se vacían solo cuando pueden editar la vista previa en su lugar.
Si el streaming falla a mitad de respuesta, OpenClaw recurre a la entrega normal para las cargas restantes.

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

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

Opta por 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 de runtime heredado para channels.slack.streaming.mode.
el booleano channels.slack.streaming es un alias de runtime heredado para channels.slack.streaming.mode y channels.slack.streaming.nativeTransport.
channels.slack.chunkMode y channels.slack.nativeStreaming de nivel superior son alias de runtime heredados para channels.slack.streaming.chunkMode y channels.slack.streaming.nativeTransport.
Ejecuta openclaw doctor --fix para reescribir la configuración persistida de streaming de Slack a las claves canónicas.

Reserva de reacción de escritura

typingReaction agrega una reacción temporal al mensaje entrante de Slack mientras OpenClaw procesa una respuesta, y luego la elimina cuando la ejecución termina. Esto es más útil fuera de respuestas de hilo, que usan un indicador de estado predeterminado “está escribiendo…”. Orden de resolución:

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

Notas:

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

Medios, fragmentación y entrega

Archivos adjuntos entrantes

Los archivos adjuntos de Slack se descargan desde URL privadas alojadas por Slack (flujo de solicitud autenticado con token) y se escriben en el almacén de medios cuando la recuperación se realiza 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 acotados, tanto de inactividad como totales. Si la recuperación de archivos de Slack se bloquea o falla, OpenClaw sigue 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 20MB de forma predeterminada, salvo que channels.slack.mediaMaxMb lo sobrescriba.

Texto y archivos salientes

los fragmentos de texto usan channels.slack.textChunkLimit (predeterminado 8000, limitado por el propio límite de longitud de mensajes de Slack)
channels.slack.streaming.chunkMode="newline" habilita la división con prioridad por párrafos
los envíos de archivos usan las API de carga de Slack y pueden incluir respuestas en hilos (thread_ts)
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 de entrega

Destinos explícitos preferidos:

user:<id> para MD
channel:<id> para canales

Los MD de Slack solo con texto/bloques pueden publicar directamente en IDs de usuario; las cargas de archivos y los envíos en hilos abren primero el MD mediante las API de conversaciones de Slack porque esas rutas requieren un ID de conversación concreto.

Comandos y comportamiento de barra diagonal

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

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

/openclaw /help

Los comandos nativos requieren ajustes adicionales del manifiesto en tu app de Slack y, en su lugar, se habilitan con channels.slack.commands.native: true o commands.native: true en configuraciones globales.

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

/help

Los menús de argumentos nativos se representan como una de las siguientes opciones, en orden de prioridad:

3-5 opciones suficientemente cortas: un menú de desbordamiento (”…”)
más de 100 opciones, con filtrado asíncrono de opciones disponible: selección externa
1-2 opciones, o cualquier opción cuyo valor codificado sea demasiado largo para una selección: bloques de botones
en caso contrario (6-100 opciones, o más de 100 sin filtrado asíncrono): menú de selección estática, dividido en fragmentos de 100 opciones por menú

/think

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

Respuestas interactivas

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

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

O habilítalo solo para una cuenta de Slack:

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

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

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

Estas directivas se compilan en Slack Block Kit y enrutan clics o selecciones a través de la ruta existente de eventos de interacción de Slack. Consérvalas para prompts antiguos y vías de escape específicas de Slack; usa la presentación compartida para nuevos controles portables. Las API del compilador de directivas también están obsoletas para nuevo código productor:

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

Usa cargas útiles de presentation y buildSlackPresentationBlocks(...) para nuevos controles representados en Slack. Notas:

Esta es una IU 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 manejador interactivo también pueden recibir eventos de 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. Usa uno de estos patrones de enrutamiento al abrir un modal de Slack:

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

El manejador recibe ctx.interaction.kind como view_submission o view_closed, inputs normalizados y el objeto completo sin procesar stateValues de Slack. El enrutamiento solo por callback ID basta para invocar el manejador del plugin; incluye los campos de enrutamiento de usuario/sesión del private_metadata modal existente 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 manejador 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 interactivas, en lugar de recurrir a la IU web o a la terminal.

Las aprobaciones de ejecución y de plugin pueden representarse como avisos nativos de Slack Block Kit.
channels.slack.execApprovals.* sigue siendo la configuración de habilitación y enrutamiento a MD/canal del cliente nativo de aprobación de ejecución.
Los MD de aprobación de ejecución usan channels.slack.execApprovals.approvers o commands.ownerAllowFrom.
Las aprobaciones de plugin usan botones nativos de Slack cuando Slack está habilitado como cliente de aprobación nativo para la sesión de origen, o cuando approvals.plugin enruta a la sesión de Slack de origen o a un destino de Slack.
Los MD de aprobación de plugin usan aprobadores del plugin de Slack de channels.slack.allowFrom, allowFrom de cuenta nombrada o la ruta predeterminada de la cuenta.
La autorización del aprobador se sigue aplicando: los aprobadores solo de ejecución no pueden aprobar solicitudes de plugin a menos que también sean aprobadores de plugin.

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

channels.slack.execApprovals.enabled
channels.slack.execApprovals.approvers (opcional; recurre a commands.ownerAllowFrom cuando es posible)
channels.slack.execApprovals.target (dm | channel | both, 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 de plugin nativas mediante esta ruta de cliente nativo cuando se resuelven aprobadores del plugin de Slack y la solicitud coincide con los filtros de cliente nativo. Establece enabled: false para deshabilitar explícitamente Slack como cliente de aprobación nativo. Establece enabled: true para forzar las aprobaciones nativas cuando se resuelven aprobadores. Deshabilitar las aprobaciones de ejecución de Slack no deshabilita la entrega de aprobaciones nativas de plugin de Slack habilitada mediante approvals.plugin; la entrega de aprobaciones de plugin usa aprobadores del plugin de Slack en su lugar. Comportamiento predeterminado sin configuración explícita de aprobación de ejecución de Slack:

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

La configuración explícita nativa de Slack solo es necesaria cuando quieres sobrescribir aprobadores, agregar filtros u optar por la entrega en el chat de origen:

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

El reenvío compartido de approvals.exec es independiente. Úsalo solo cuando los avisos de aprobación de ejecución también deban enrutarse a otros chats o destinos explícitos fuera de banda. El reenvío compartido de approvals.plugin también es independiente; la entrega nativa de Slack suprime esa alternativa solo cuando Slack puede gestionar la solicitud de aprobación de plugin de forma nativa. /approve en el mismo chat también funciona en canales y MD de Slack que ya admiten comandos. Consulta Aprobaciones de ejecución para ver el modelo completo de reenvío de aprobaciones.

Eventos y comportamiento operativo

Las ediciones/eliminaciones de mensajes se asignan a eventos del sistema.
Las difusiones de hilos (respuestas de hilo con “Also send to channel”) se procesan como mensajes de usuario normales.
Los eventos de agregar/eliminar reacciones se asignan a eventos del sistema.
Los eventos de entrada/salida de miembros, canal creado/renombrado y agregar/eliminar 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/propósito del canal se tratan como contexto no confiable y pueden inyectarse en el contexto de enrutamiento.
El iniciador del hilo y la inicialización del contexto de historial inicial del hilo se filtran por listas de permitidos de remitentes configuradas cuando corresponde.
Las acciones de bloque, los accesos directos y las interacciones modales emiten eventos del sistema estructurados Slack interaction: ... con campos de carga útil enriquecidos:
- acciones de bloque: valores seleccionados, etiquetas, valores de selectores y metadatos workflow_*
- accesos directos globales: metadatos de callback y actor, enrutados a la sesión directa del actor
- accesos directos de mensaje: contexto de callback, actor, canal, hilo y mensaje seleccionado
- eventos modales view_submission y view_closed con metadatos de canal enrutados y entradas de formulario

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

Referencia de configuración

Referencia principal: Referencia de configuración - Slack.

Campos de Slack de alta señal

modo/autenticación: mode, botToken, appToken, signingSecret, webhookPath, accounts.*
acceso a MD: dm.enabled, dmPolicy, allowFrom (heredado: dm.policy, dm.allowFrom), dm.groupEnabled, dm.groupChannels
interruptor de compatibilidad: dangerouslyAllowNameMatching (ruptura de emergencia; mantenlo desactivado salvo que sea necesario)
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
despliegues: unfurlLinks (predeterminado: false), unfurlMedia para el control de vista previa de enlaces/medios de chat.postMessage; establece unfurlLinks: true para volver a activar las vistas previas de enlaces
operaciones/funciones: configWrites, commands.native, slashCommand.*, actions.*, userToken, userTokenReadOnly

Solución de problemas

No hay respuestas en canales

Comprueba, en orden:

groupPolicy
lista de permitidos de canales (channels.slack.channels) — las claves deben ser ID de canal (C12345678), no nombres (#channel-name). Las claves basadas en nombres fallan silenciosamente con groupPolicy: "allowlist" porque el enrutamiento de canales prioriza los ID de forma predeterminada. Para encontrar un ID: haz clic derecho en el canal en Slack → Copy link — el valor C... al final de la URL es el ID del canal.
requireMention
lista de permitidos users por canal
messages.groupChat.visibleReplies: las solicitudes normales de grupo/canal usan "automatic" de forma predeterminada. Si activaste "message_tool" y los registros muestran texto del asistente sin una llamada message(action=send), el modelo no siguió la ruta visible de la herramienta de mensajes. El texto final permanece privado en este modo; inspecciona el registro detallado del Gateway para ver metadatos de carga útil suprimidos, o configúralo en "automatic" si quieres que cada respuesta final normal del asistente se publique mediante la ruta heredada.
messages.groupChat.unmentionedInbound: si es "room_event", la conversación permitida sin mención en el canal es contexto ambiental y permanece silenciosa a menos que el agente llame a la herramienta message. Consulta Eventos ambientales de sala.

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

Comandos útiles:

openclaw channels status --probe
openclaw logs --follow
openclaw doctor

DM messages ignored

Comprueba:

channels.slack.dm.enabled
channels.slack.dmPolicy (o el valor heredado channels.slack.dm.policy)
aprobaciones de emparejamiento / entradas en la lista de permitidos (dmPolicy: "open" todavía requiere channels.slack.allowFrom: ["*"])
los DM de grupo usan manejo MPIM; habilita channels.slack.dm.groupEnabled y, si está configurado, incluye el MPIM en channels.slack.dm.groupChannels
eventos de DM de Slack Assistant: los registros detallados que mencionan drop message_changed normalmente significan que Slack envió un evento de hilo de Assistant editado sin un remitente humano recuperable en los metadatos del mensaje

openclaw pairing list slack

Socket mode not connecting

Valida los tokens de bot y de app, y que Socket Mode esté habilitado en la configuración de la app de Slack. El App-Level Token necesita connections:write, y el Bot User OAuth Token debe pertenecer a la misma app/área de trabajo de Slack que el token de la app.Si openclaw channels status --probe --json muestra botTokenStatus o appTokenStatus: "configured_unavailable", la cuenta de Slack está configurada, pero el runtime 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 faltantes, tokens revocados y autenticación no válida fallan rápido en su lugar. Un registro slack token mismatch ... significa que el token de bot y el token de app parecen pertenecer a apps de Slack distintas; corrige las credenciales de la app de Slack.

HTTP mode not receiving events

Valida:

secreto de firma
ruta del webhook
URL de solicitud de Slack (Events + Interactivity + Slash Commands)
webhookPath único por cuenta HTTP
la URL pública termina TLS y reenvía solicitudes a la ruta del Gateway
la ruta request_url de la app de Slack coincide exactamente con channels.slack.webhookPath (valor predeterminado /slack/events)

Si signingSecretStatus: "configured_unavailable" aparece en las instantáneas de cuenta, la cuenta HTTP está configurada, pero el runtime actual no pudo resolver el secreto de firma respaldado por SecretRef.Un registro repetido slack: webhook path ... already registered significa que dos cuentas HTTP están usando el mismo webhookPath; asigna a cada cuenta una ruta distinta.

Native/slash commands not firing

Verifica qué pretendías usar:

modo de comando nativo (channels.slack.commands.native: true) con comandos slash coincidentes registrados en Slack
o modo de comando slash único (channels.slack.slashCommand.enabled: true)

Slack no crea ni elimina comandos slash automáticamente. commands.native: "auto" no habilita los comandos nativos de Slack; usa true y crea los comandos coincidentes en la app de Slack. En modo HTTP, cada comando slash de Slack debe incluir la URL del Gateway. En Socket Mode, las cargas útiles de comandos llegan por el websocket y Slack ignora slash_commands[].url.Comprueba también commands.useAccessGroups, la autorización de DM, las listas de permitidos de canales y las listas de permitidos users por canal. Slack devuelve errores efímeros para remitentes de comandos slash bloqueados, incluidos:

This channel is not allowed.
You are not authorized to use this command here.

Referencia de visión para adjuntos

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

Tipos de medios compatibles

Tipo de medio	Origen	Comportamiento actual	Notas
Imágenes JPEG / PNG / GIF / WebP	URL de archivo de Slack	Descargadas y adjuntadas al turno para manejo compatible con visión	Límite por archivo: `channels.slack.mediaMaxMb` (valor predeterminado 20 MB)
Archivos PDF	URL de archivo de Slack	Descargados y expuestos como contexto de archivo para herramientas como `download-file` o `pdf`	La entrada de Slack no convierte automáticamente los PDF en entrada de visión de imagen
Otros archivos	URL de archivo de Slack	Descargados cuando es posible y expuestos como contexto de archivo	Los archivos binarios no se tratan como entrada de imagen
Respuestas de hilo	Archivos del mensaje inicial del hilo	Los archivos del mensaje raíz pueden hidratarse como contexto cuando la respuesta no tiene medios directos	Los mensajes iniciales solo con archivos usan un marcador de posición de adjunto
Mensajes con varias imágenes	Varios archivos de Slack	Cada archivo se evalúa de forma independiente	El procesamiento de Slack está limitado a ocho archivos por mensaje

Pipeline de entrada

Cuando llega un mensaje de Slack con archivos adjuntos:

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

Herencia de adjuntos del mensaje raíz del hilo

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

Si la respuesta no tiene medios directos y el mensaje raíz incluido tiene archivos, Slack puede hidratar los archivos raíz como contexto del mensaje inicial del hilo.
Los archivos raíz se hidratan solo al inicializar una sesión de hilo nueva o restablecida. Las respuestas posteriores solo de texto reutilizan el contexto de sesión existente y no vuelven a adjuntar los archivos raíz como medios nuevos.
Los adjuntos directos de la respuesta tienen prioridad sobre los adjuntos del mensaje raíz.
Un mensaje raíz que solo tiene archivos y no texto se representa con un marcador de posición de adjunto para que la ruta de fallback aún pueda incluir sus archivos.

Manejo de varios adjuntos

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

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

Límites de tamaño, descarga y modelo

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

Límites conocidos

Escenario	Comportamiento actual	Solución alternativa
URL de archivo de Slack caducada	Archivo omitido; no se muestra ningún error	Vuelve a cargar el archivo en Slack
Modelo de visión no configurado	Los adjuntos de imagen se almacenan como referencias de medios, pero no se analizan como imágenes	Configura `agents.defaults.imageModel` o usa un modelo de respuesta compatible con visión
Imágenes muy grandes (> 20 MB de forma predeterminada)	Omitidas según el límite de tamaño	Aumenta `channels.slack.mediaMaxMb` si Slack lo permite
Adjuntos reenviados/compartidos	El texto y los medios de imagen/archivo alojados en Slack se manejan con el mayor esfuerzo posible	Vuelve a compartirlos directamente en el hilo de OpenClaw
Adjuntos PDF	Se almacenan como contexto de archivo/medio, no se enrutan automáticamente mediante visión de imagen	Usa `download-file` para metadatos de archivo o la herramienta `pdf` para análisis de PDF

Documentación relacionada

Relacionado

Pairing

Empareja un usuario de Slack con el gateway.

Groups

Comportamiento de canal y DM de grupo.

Channel routing

Enruta mensajes entrantes a agentes.

Security

Modelo de amenazas y refuerzo.

Configuration

Diseño y precedencia de la configuración.

Slash commands

Catálogo y comportamiento de comandos.

Emparejamiento

Comandos slash

Solución de problemas de canales

​Elegir un transporte

​Modo relay

​Instalación

​Configuración rápida

​Ajuste del transporte de Socket Mode

​Lista de comprobación de manifiesto y alcances

​Configuración adicional del manifiesto

​Modelo de tokens

​Acciones y controles

​Control de acceso y enrutamiento

​Hilos, sesiones y etiquetas de respuesta

​Reacciones de acuse de recibo

​Emoji (ackReaction)

​Alcance (messages.ackReactionScope)

​Streaming de texto

​Reserva de reacción de escritura

​Medios, fragmentación y entrega

​Comandos y comportamiento de barra diagonal

​Respuestas interactivas

​Envíos de modales propiedad de Plugins

​Aprobaciones nativas en Slack

​Eventos y comportamiento operativo

​Referencia de configuración

​Solución de problemas

​Referencia de visión para adjuntos

​Tipos de medios compatibles

​Pipeline de entrada

​Herencia de adjuntos del mensaje raíz del hilo

​Manejo de varios adjuntos

​Límites de tamaño, descarga y modelo

​Límites conocidos

​Documentación relacionada

​Relacionado

Pairing

Groups

Channel routing

Security

Configuration

Slash commands

Elegir un transporte

Modo relay

Instalación

Configuración rápida

Ajuste del transporte de Socket Mode

Lista de comprobación de manifiesto y alcances

Configuración adicional del manifiesto

Modelo de tokens

Acciones y controles

Control de acceso y enrutamiento

Hilos, sesiones y etiquetas de respuesta

Reacciones de acuse de recibo

Emoji (`ackReaction`)

Alcance (`messages.ackReactionScope`)

Streaming de texto

Reserva de reacción de escritura

Medios, fragmentación y entrega

Comandos y comportamiento de barra diagonal

Respuestas interactivas

Envíos de modales propiedad de Plugins

Aprobaciones nativas en Slack

Eventos y comportamiento operativo

Referencia de configuración

Solución de problemas

Referencia de visión para adjuntos

Tipos de medios compatibles

Pipeline de entrada

Herencia de adjuntos del mensaje raíz del hilo

Manejo de varios adjuntos

Límites de tamaño, descarga y modelo

Límites conocidos

Documentación relacionada

Relacionado