Slack

​

Elección de un transporte

​

Modo de retransmisión

{
  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",
      },
    },
  },
}

​

Instalaciones para toda la organización de Enterprise Grid

​

Socket Mode

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

{
  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

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

{
  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 },
      },
    },
  },
}

​

Instalación

openclaw plugins install @openclaw/slack

​

Configuración rápida

{
  "display_information": {
    "name": "OpenClaw",
    "description": "Conector de Slack para OpenClaw"
  },
  "features": {
    "bot_user": { "display_name": "OpenClaw", "always_online": true },
    "app_home": {
      "home_tab_enabled": true,
      "messages_tab_enabled": true,
      "messages_tab_read_only_enabled": false
    },
    "agent_view": {
      "agent_description": "OpenClaw conecta las conversaciones de Agent View de Slack con los agentes de OpenClaw.",
      "suggested_prompts": [
        { "title": "¿Qué puedes hacer?", "message": "¿En qué puedes ayudarme?" },
        {
          "title": "Resume este canal",
          "message": "Resume la actividad reciente de este canal."
        },
        { "title": "Redacta una respuesta", "message": "Ayúdame a redactar una respuesta." }
      ]
    },
    "slash_commands": [
      {
        "command": "/openclaw",
        "description": "Enviar un mensaje a OpenClaw",
        "should_escape": false
      }
    ]
  },
  "oauth_config": {
    "scopes": {
      "bot": [
        "app_mentions:read",
        "assistant:write",
        "channels:history",
        "channels:read",
        "chat:write",
        "commands",
        "emoji:read",
        "files:read",
        "files:write",
        "groups:history",
        "groups:read",
        "im:history",
        "im:read",
        "im:write",
        "mpim:history",
        "mpim:read",
        "mpim:write",
        "pins:read",
        "pins:write",
        "reactions:read",
        "reactions:write",
        "usergroups:read",
        "users:read"
      ]
    }
  },
  "settings": {
    "socket_mode_enabled": true,
    "event_subscriptions": {
      "bot_events": [
        "app_home_opened",
        "app_mention",
        "app_context_changed",
        "channel_rename",
        "member_joined_channel",
        "member_left_channel",
        "message.channels",
        "message.groups",
        "message.im",
        "message.mpim",
        "pin_added",
        "pin_removed",
        "reaction_added",
        "reaction_removed"
      ]
    }
  }
}

{
  "display_information": {
    "name": "OpenClaw",
    "description": "Conector de Slack para OpenClaw"
  },
  "features": {
    "bot_user": { "display_name": "OpenClaw", "always_online": true },
    "app_home": {
      "home_tab_enabled": true,
      "messages_tab_enabled": true,
      "messages_tab_read_only_enabled": false
    },
    "agent_view": {
      "agent_description": "OpenClaw conecta las conversaciones de Agent View de Slack con los agentes de OpenClaw.",
      "suggested_prompts": [
        { "title": "¿Qué puedes hacer?", "message": "¿En qué puedes ayudarme?" },
        {
          "title": "Resume este canal",
          "message": "Resume la actividad reciente de este canal."
        },
        { "title": "Redacta una respuesta", "message": "Ayúdame a redactar una respuesta." }
      ]
    },
    "slash_commands": [
      {
        "command": "/openclaw",
        "description": "Enviar un mensaje a OpenClaw",
        "should_escape": false
      }
    ]
  },
  "oauth_config": {
    "scopes": {
      "bot": [
        "app_mentions:read",
        "assistant:write",
        "channels:history",
        "channels:read",
        "chat:write",
        "commands",
        "groups:history",
        "groups:read",
        "im:history",
        "im:read",
        "im:write",
        "users:read"
      ]
    }
  },
  "settings": {
    "socket_mode_enabled": true,
    "event_subscriptions": {
      "bot_events": [
        "app_home_opened",
        "app_mention",
        "app_context_changed",
        "message.channels",
        "message.groups",
        "message.im"
      ]
    }
  }
}

export SLACK_APP_TOKEN=slack-app-token-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

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

openclaw gateway

{
  "display_information": {
    "name": "OpenClaw",
    "description": "Conector de Slack para OpenClaw"
  },
  "features": {
    "bot_user": { "display_name": "OpenClaw", "always_online": true },
    "app_home": {
      "home_tab_enabled": true,
      "messages_tab_enabled": true,
      "messages_tab_read_only_enabled": false
    },
    "agent_view": {
      "agent_description": "OpenClaw conecta las conversaciones de Agent View de Slack con los agentes de OpenClaw.",
      "suggested_prompts": [
        { "title": "¿Qué puedes hacer?", "message": "¿En qué puedes ayudarme?" },
        {
          "title": "Resume este canal",
          "message": "Resume la actividad reciente de este canal."
        },
        { "title": "Redacta una respuesta", "message": "Ayúdame a redactar una respuesta." }
      ]
    },
    "slash_commands": [
      {
        "command": "/openclaw",
        "description": "Enviar un mensaje a OpenClaw",
        "should_escape": false,
        "url": "https://gateway-host.example.com/slack/events"
      }
    ]
  },
  "oauth_config": {
    "scopes": {
      "bot": [
        "app_mentions:read",
        "assistant:write",
        "channels:history",
        "channels:read",
        "chat:write",
        "commands",
        "emoji:read",
        "files:read",
        "files:write",
        "groups:history",
        "groups:read",
        "im:history",
        "im:read",
        "im:write",
        "mpim:history",
        "mpim:read",
        "mpim:write",
        "pins:read",
        "pins:write",
        "reactions:read",
        "reactions:write",
        "usergroups:read",
        "users:read"
      ]
    }
  },
  "settings": {
    "event_subscriptions": {
      "request_url": "https://gateway-host.example.com/slack/events",
      "bot_events": [
        "app_home_opened",
        "app_mention",
        "app_context_changed",
        "channel_rename",
        "member_joined_channel",
        "member_left_channel",
        "message.channels",
        "message.groups",
        "message.im",
        "message.mpim",
        "pin_added",
        "pin_removed",
        "reaction_added",
        "reaction_removed"
      ]
    },
    "interactivity": {
      "is_enabled": true,
      "request_url": "https://gateway-host.example.com/slack/events",
      "message_menu_options_url": "https://gateway-host.example.com/slack/events"
    }
  }
}

{
  "display_information": {
    "name": "OpenClaw",
    "description": "Conector de Slack para OpenClaw"
  },
  "features": {
    "bot_user": { "display_name": "OpenClaw", "always_online": true },
    "app_home": {
      "home_tab_enabled": true,
      "messages_tab_enabled": true,
      "messages_tab_read_only_enabled": false
    },
    "agent_view": {
      "agent_description": "OpenClaw conecta las conversaciones de Slack Agent View con agentes de OpenClaw.",
      "suggested_prompts": [
        { "title": "¿Qué puedes hacer?", "message": "¿En qué puedes ayudarme?" },
        {
          "title": "Resume este canal",
          "message": "Resume la actividad reciente de este canal."
        },
        { "title": "Redacta una respuesta", "message": "Ayúdame a redactar una respuesta." }
      ]
    },
    "slash_commands": [
      {
        "command": "/openclaw",
        "description": "Enviar un mensaje a OpenClaw",
        "should_escape": false,
        "url": "https://gateway-host.example.com/slack/events"
      }
    ]
  },
  "oauth_config": {
    "scopes": {
      "bot": [
        "app_mentions:read",
        "assistant:write",
        "channels:history",
        "channels:read",
        "chat:write",
        "commands",
        "groups:history",
        "groups:read",
        "im:history",
        "im:read",
        "im:write",
        "users:read"
      ]
    }
  },
  "settings": {
    "event_subscriptions": {
      "request_url": "https://gateway-host.example.com/slack/events",
      "bot_events": [
        "app_home_opened",
        "app_mention",
        "app_context_changed",
        "message.channels",
        "message.groups",
        "message.im"
      ]
    },
    "interactivity": {
      "is_enabled": true,
      "request_url": "https://gateway-host.example.com/slack/events",
      "message_menu_options_url": "https://gateway-host.example.com/slack/events"
    }
  }
}

export SLACK_BOT_TOKEN=slack-bot-token-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

openclaw gateway

​

Identidad de usuario (publicar como una persona real)

1. En OAuth & Permissions -> User Token Scopes, añada estos permisos con ámbito de usuario:
   • historial: channels:history, groups:history, im:history, mpim:history
   • búsqueda de conversaciones: channels:read, groups:read, im:read, mpim:read
   • personas: users:read
   • publicación: chat:write (los mensajes se publican como el usuario que autoriza)
   • apertura de mensajes directos: im:write, mpim:write
2. En Event Subscriptions -> Subscribe to events on behalf of users, añada estos eventos de usuario. No los añada únicamente a la lista de eventos del bot:
   • message.channels
   • message.groups
   • message.im
   • message.mpim
3. Elija un transporte de eventos:
   • Socket Mode: habilite Socket Mode y cree un token de nivel de aplicación con connections:write. Configúrelo como appToken.
   • HTTP Request URL: haga que Event Subscriptions apunte al endpoint público de Slack de OpenClaw y copie Basic Information -> App Credentials -> Signing Secret. Configúrelo como signingSecret.
4. Instale o reinstale la aplicación, autorícela como la persona prevista y copie el token OAuth de usuario resultante en userToken.

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

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

​

Ajuste del transporte de Socket Mode

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

• socketMode se ignora en el modo HTTP Request URL.
• La configuración base de channels.slack.socketMode se aplica a todas las cuentas de Slack, salvo que se sobrescriba. Las sobrescrituras por cuenta usan channels.slack.accounts.<accountId>.socketMode; como se trata de una sobrescritura de objeto, incluya todos los campos de ajuste del socket que desee para esa cuenta.
• Solo clientPingTimeout tiene un valor predeterminado de OpenClaw (15000). serverPingTimeout y pingPongLoggingEnabled solo se pasan al SDK de Slack cuando están configurados.
• La espera incremental para reiniciar Socket Mode comienza alrededor de 2 segundos y alcanza un máximo aproximado de 30 segundos. Los fallos recuperables de inicio, espera de inicio y desconexión se reintentan hasta que se detiene el canal. Los errores permanentes de cuenta y credenciales, como una autenticación no válida, tokens revocados o ámbitos ausentes, fallan de inmediato en lugar de reintentarse indefinidamente.

​

Lista de comprobación del manifiesto y los ámbitos

{
  "display_information": {
    "name": "OpenClaw",
    "description": "Conector de Slack para OpenClaw"
  },
  "features": {
    "bot_user": { "display_name": "OpenClaw", "always_online": true },
    "app_home": {
      "home_tab_enabled": true,
      "messages_tab_enabled": true,
      "messages_tab_read_only_enabled": false
    },
    "agent_view": {
      "agent_description": "OpenClaw conecta las conversaciones de Slack Agent View con agentes de OpenClaw.",
      "suggested_prompts": [
        { "title": "¿Qué puedes hacer?", "message": "¿En qué puedes ayudarme?" },
        {
          "title": "Resume este canal",
          "message": "Resume la actividad reciente de este canal."
        },
        { "title": "Redacta una respuesta", "message": "Ayúdame a redactar una respuesta." }
      ]
    },
    "slash_commands": [
      {
        "command": "/openclaw",
        "description": "Enviar un mensaje a OpenClaw",
        "should_escape": false
      }
    ]
  },
  "oauth_config": {
    "scopes": {
      "bot": [
        "app_mentions:read",
        "assistant:write",
        "channels:history",
        "channels:read",
        "chat:write",
        "commands",
        "emoji:read",
        "files:read",
        "files:write",
        "groups:history",
        "groups:read",
        "im:history",
        "im:read",
        "im:write",
        "mpim:history",
        "mpim:read",
        "mpim:write",
        "pins:read",
        "pins:write",
        "reactions:read",
        "reactions:write",
        "usergroups:read",
        "users:read"
      ]
    }
  },
  "settings": {
    "socket_mode_enabled": true,
    "event_subscriptions": {
      "bot_events": [
        "app_home_opened",
        "app_mention",
        "app_context_changed",
        "channel_rename",
        "member_joined_channel",
        "member_left_channel",
        "message.channels",
        "message.groups",
        "message.im",
        "message.mpim",
        "pin_added",
        "pin_removed",
        "reaction_added",
        "reaction_removed"
      ]
    }
  }
}

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

​

Configuración adicional del manifiesto

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

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

​

Modelo de tokens

• La identidad de bot (predeterminada) requiere botToken + appToken para Socket Mode, o botToken + signingSecret para el modo HTTP.
• La identidad de usuario requiere userToken + appToken para Socket Mode, o userToken + signingSecret para el modo HTTP. No usa un token de bot.
• El modo de retransmisión requiere botToken además de relay.url, relay.authToken y relay.gatewayId; no usa un token de aplicación ni un secreto de firma.
• botToken, appToken, signingSecret, relay.authToken y userToken aceptan cadenas de texto sin formato u objetos SecretRef.
• Los tokens de configuración tienen prioridad sobre el valor alternativo de las variables de entorno.
• Los valores alternativos de entorno SLACK_BOT_TOKEN, SLACK_APP_TOKEN y SLACK_USER_TOKEN se aplican únicamente a la cuenta predeterminada.
• userToken usa de forma predeterminada un comportamiento de solo lectura (userTokenReadOnly: true).

• La inspección de cuentas de Slack realiza el seguimiento de los campos *Source y *Status de cada credencial (botToken, appToken, signingSecret, userToken).
• El estado es available, configured_unavailable o missing.
• configured_unavailable significa que la cuenta está configurada mediante SecretRef u otra fuente de secretos no insertada directamente, pero la ruta actual del comando o del entorno de ejecución no pudo resolver el valor real.
• En el modo HTTP, se incluye signingSecretStatus. Socket Mode usa botTokenStatus + appTokenStatus para la identidad de bot y userTokenStatus + appTokenStatus para la identidad de usuario.

​

Acciones y controles

​

Control de acceso y enrutamiento

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

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

​

Hilos, sesiones y etiquetas de respuesta

• Los mensajes directos se enrutan como direct; los canales, como channel; y los MPIM, como group.
• Las vinculaciones de rutas de Slack aceptan ID de pares sin procesar, además de formatos de destino de Slack como channel:C12345678, user:U12345678 y <@U12345678>.
• Con el valor predeterminado session.dmScope=main, los mensajes directos normales de Slack se agrupan en la sesión principal del agente. Las raíces de Agent View y los hilos existentes de Assistant View permanecen aislados como sesiones :thread:<threadTs>.
• Sesiones de canal: agent:<agentId>:slack:channel:<channelId>.
• Los mensajes normales de nivel superior del canal permanecen en la sesión por canal, incluso cuando replyToMode no es off.
• Las respuestas de hilos de canales de Slack, MPIM, Agent View y Assistant View utilizan el thread_ts principal de Slack para los sufijos de sesión (:thread:<threadTs>). Los hilos de respuesta de mensajes directos normales siguen siendo una función de la interfaz de usuario dentro de la sesión base de mensajes directos.
• OpenClaw incorpora una raíz de nivel superior apta del canal en agent:<agentId>:slack:channel:<channelId>:thread:<rootTs> cuando se espera que esa raíz inicie un hilo visible de Slack, de modo que la raíz y las respuestas posteriores del hilo compartan una sesión de OpenClaw. Esto se aplica a eventos app_mention, coincidencias explícitas con el bot o con patrones de menciones configurados y canales requireMention: false con un replyToMode distinto de off.
• El valor predeterminado de channels.slack.thread.historyScope es thread; el de thread.inheritParent es false.
• channels.slack.thread.initialHistoryLimit controla cuántos mensajes existentes del hilo se recuperan cuando se inicia una nueva sesión de hilo (valor predeterminado: 20; establezca 0 para deshabilitarlo).
• channels.slack.implicitMentions.replyToBot controla si una respuesta al mensaje del propio bot omite el requisito de mención (valor predeterminado: true).
• channels.slack.implicitMentions.threadParticipation controla si los mensajes de seguimiento de un hilo en el que el bot ha respondido omiten el requisito de mención (valor predeterminado: true). Establézcalo en false para exigir una nueva mención explícita en esos mensajes de seguimiento. openclaw doctor --fix migra la antigua clave channels.slack.thread.requireExplicitMention a esta marca canónica positiva.
• Las anulaciones de cuenta se encuentran en channels.slack.accounts.<id>.implicitMentions; los valores predeterminados compartidos, en channels.defaults.implicitMentions.

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

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

​

Reacciones de confirmación

​

Emoji (ackReaction)

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

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

​

Ámbito (messages.ackReactionScope)

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

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

​

Transmisión de texto

• off: deshabilitar la transmisión de la vista previa en directo.
• partial (valor predeterminado): sustituir el texto de la vista previa por la salida parcial más reciente.
• block: añadir actualizaciones fragmentadas a la vista previa.
• progress: mostrar texto del estado de progreso durante la generación y, después, enviar el texto final.
• streaming.preview.toolProgress: cuando la vista previa del borrador está activa, dirigir las actualizaciones de herramientas/progreso al mismo mensaje de vista previa editado (valor predeterminado: true). Establezca false para conservar mensajes separados de herramientas/progreso.
• streaming.preview.commandText / streaming.progress.commandText: establezca status para conservar líneas compactas del progreso de las herramientas y ocultar el texto sin procesar de comandos/ejecución (valor predeterminado: raw).

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

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

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

{
  channels: {
    slack: {
      streaming: {
        mode: "progress",
        progress: {
          nativeTaskCards: true,
          render: "rich",
        },
      },
    },
  },
}

• channels.slack.streamMode (replace | status_final | append) es un alias heredado de channels.slack.streaming.mode.
• El valor booleano channels.slack.streaming es un alias heredado de channels.slack.streaming.mode y channels.slack.streaming.nativeTransport.
• Los valores de nivel superior channels.slack.chunkMode y channels.slack.nativeStreaming son alias heredados de channels.slack.streaming.chunkMode y channels.slack.streaming.nativeTransport.
• Los alias heredados no se leen durante la ejecución; ejecutar openclaw doctor --fix para reescribir la configuración persistente de transmisión de Slack con las claves canónicas.

​

Reacción alternativa al escribir

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

• Slack espera códigos cortos (por ejemplo, "hourglass_flowing_sand").
• La reacción se aplica en la medida de lo posible y se intenta eliminar automáticamente después de que finalice la ruta de respuesta o de error.

​

Entrada de voz

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

​

Archivos multimedia, fragmentación y entrega

​

Comandos y comportamiento de las barras diagonales

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

/openclaw /help

• 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

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

/think

​

Gráficos nativos

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

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

​

Tablas nativas

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

• De 1 a 20 columnas
• De 1 a 100 filas de datos, además de la fila de encabezado
• El mismo número de celdas en cada fila
• Como máximo 10,000 caracteres en total entre todas las celdas de las tablas de un mensaje

​

Respuestas interactivas

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

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

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

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

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

​

Envíos de modales propiedad de plugins

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

​

Aprobaciones nativas en Slack

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

• channels.slack.execApprovals.enabled
• channels.slack.execApprovals.approvers (opcional; recurre a commands.ownerAllowFrom cuando es posible)
• channels.slack.execApprovals.target (dm | channel | both, valor predeterminado: dm)
• agentFilter, sessionFilter

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

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

​

Eventos y comportamiento operativo

• Las ediciones y eliminaciones de mensajes se asignan a eventos del sistema.
• Las difusiones de hilos (respuestas de hilo con “Also send to channel”) se procesan como mensajes normales del usuario.
• Los eventos de adición y eliminación de reacciones se asignan a eventos del sistema.
• Los eventos de entrada y salida de miembros, creación o cambio de nombre de canales, y adición o eliminación de elementos fijados se asignan a eventos del sistema.
• El sondeo opcional de presencia puede asignar la transición de away a active de un participante humano observado a la sesión de Slack apta y activa más reciente del participante. Está deshabilitado de forma predeterminada.
• channel_id_changed puede migrar claves de configuración de canales cuando configWrites está habilitado.
• Los metadatos de tema y propósito del canal se tratan como contexto no confiable y pueden inyectarse en el contexto de enrutamiento.
• Las entidades app_context de Agent View se validan en el orden de relevancia de Slack y solo se exponen como contexto estructurado no confiable; un contexto omitido borra el turno en lugar de reutilizar entidades obsoletas.
• El inicio del hilo y la inicialización del contexto del historial inicial del hilo se filtran mediante las listas de remitentes permitidos configuradas cuando corresponda.
• Las acciones de bloques, los accesos directos y las interacciones de modales emiten eventos del sistema Slack interaction: ... estructurados con campos de carga útil detallados:
  • acciones de bloques: valores seleccionados, etiquetas, valores del selector y metadatos workflow_*
  • accesos directos globales: metadatos de devolución de llamada y del actor, enrutados a la sesión directa del actor
  • accesos directos de mensajes: contexto de devolución de llamada, actor, canal, hilo y mensaje seleccionado
  • eventos view_submission y view_closed de modales con metadatos de canal enrutados y entradas del formulario

​

Eventos de presencia

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

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

​

Referencia de configuración

​

Solución de problemas

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

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

openclaw pairing list slack

​

Referencia de medios adjuntos

​

Tipos de medios compatibles

​

Pipeline de entrada

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

​

Herencia de archivos adjuntos de la raíz del hilo

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

​

Manejo de varios archivos adjuntos

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

​

Límites de tamaño, descarga y modelo

• Límite de tamaño: valor predeterminado de 20 MB por archivo. Configurable mediante channels.slack.mediaMaxMb.
• Límite de transcripción de audio: el valor maxBytes de la entrada tools.media.models[] seleccionada con capacidad de audio también se aplica cuando el archivo descargado se envía a un proveedor de transcripción o a la CLI.
• Fallos de descarga: los archivos que Slack no puede proporcionar, las URL caducadas, los archivos inaccesibles, los archivos que superan el tamaño permitido y las respuestas HTML de autenticación/inicio de sesión de Slack se omiten en lugar de notificarse como formatos no compatibles.
• Modelo de visión: el análisis de imágenes utiliza el modelo de respuesta activo cuando admite visión, o el modelo de imagen configurado en agents.defaults.imageModel.

​

Límites conocidos

​

Documentación relacionada

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

​

Temas relacionados