Slack

Pronto para produção para DMs e canais via integrações de app do Slack. O modo padrão é Socket Mode; URLs de solicitação HTTP também são compatíveis. O modo de retransmissão é destinado a implantações gerenciadas em que um roteador confiável é responsável pela entrada do Slack.

Como escolher Socket Mode ou URLs de solicitação HTTP

Ambos os transportes estão prontos para produção e alcançam paridade de recursos para mensagens, comandos de barra, App Home e interatividade. Escolha pelo formato da implantação, não pelos recursos.

Modo de retransmissão

O modo de retransmissão separa a entrada do Slack do gateway OpenClaw. Um roteador confiável é responsável pela única conexão Socket Mode do Slack, escolhe um gateway de destino e encaminha um evento tipado por um websocket autenticado. O gateway continua usando seu token de bot para chamadas de saída à Web API do 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",      },    },  },}

A URL de retransmissão deve usar wss://, a menos que aponte para localhost. Trate o token bearer e a tabela de rotas do roteador como parte do limite de autorização do Slack: eventos roteados entram no manipulador normal de mensagens do Slack como ativações autorizadas. Um slack_identity fornecido pelo roteador no quadro hello do websocket pode definir o nome de usuário e o ícone de saída padrão; uma identidade explícita fornecida pelo chamador ainda prevalece. A conexão de retransmissão reconecta com o mesmo tempo de backoff limitado usado pelo Socket Mode e limpa a identidade fornecida pelo roteador sempre que se desconecta.

Instalar

Instale o Slack antes de configurar o canal:

openclaw plugins install @openclaw/slack

plugins install registra e habilita o plugin. O plugin ainda não faz nada até você configurar o app Slack e as configurações de canal abaixo. Consulte Plugins para comportamento geral de plugins e regras de instalação.

Configuração rápida

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

export SLACK_APP_TOKEN=slack-app-token-exampleexport SLACK_BOT_TOKEN=slack-bot-token-examplecat > slack.socket.patch.json5 <<'JSON5'{channels: {slack: {enabled: true,mode: "socket",appToken: { source: "env", provider: "default", id: "SLACK_APP_TOKEN" },botToken: { source: "env", provider: "default", id: "SLACK_BOT_TOKEN" },},},}JSON5openclaw config patch --file ./slack.socket.patch.json5 --dry-runopenclaw config patch --file ./slack.socket.patch.json5

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

openclaw gateway

{"display_information": {"name": "OpenClaw","description": "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"}}}

export SLACK_BOT_TOKEN=slack-bot-token-exampleexport SLACK_SIGNING_SECRET=...cat > slack.http.patch.json5 <<'JSON5'{channels: {slack: {enabled: true,mode: "http",botToken: { source: "env", provider: "default", id: "SLACK_BOT_TOKEN" },signingSecret: { source: "env", provider: "default", id: "SLACK_SIGNING_SECRET" },webhookPath: "/slack/events",},},}JSON5openclaw config patch --file ./slack.http.patch.json5 --dry-runopenclaw config patch --file ./slack.http.patch.json5

openclaw gateway

Ajuste de transporte do Socket Mode

O OpenClaw define por padrão o tempo limite de pong do cliente do SDK do Slack como 15 segundos para o Socket Mode. Substitua as configurações de transporte somente quando precisar de ajustes específicos para workspace ou host:

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

Use isso apenas para workspaces em Socket Mode que registrem timeouts de pong/websocket ou server-ping do Slack, ou que rodem em hosts com inanição conhecida do loop de eventos. clientPingTimeout é a espera pelo pong depois que o SDK envia um ping de cliente; serverPingTimeout é a espera por pings do servidor Slack. Mensagens e eventos do app continuam sendo estado da aplicação, não sinais de vivacidade do transporte.

Observações:

• socketMode é ignorado no modo HTTP Request URL.
• As configurações base de channels.slack.socketMode se aplicam a todas as contas Slack, a menos que sejam substituídas. Substituições por conta usam channels.slack.accounts.<accountId>.socketMode; como isso é uma substituição de objeto, inclua todos os campos de ajuste de socket que você quiser para essa conta.
• Somente clientPingTimeout tem um padrão do OpenClaw (15000). serverPingTimeout e pingPongLoggingEnabled são passados para o SDK do Slack somente quando configurados.
• O backoff de reinício do Socket Mode começa por volta de 2 segundos e tem limite por volta de 30 segundos. Falhas recuperáveis de início, espera de início e desconexão tentam novamente até o canal parar. Erros permanentes de conta e credenciais, como autenticação inválida, tokens revogados ou escopos ausentes, falham rapidamente em vez de tentar novamente para sempre.

Lista de verificação de manifesto e escopos

O manifesto base do app Slack é o mesmo para Socket Mode e HTTP Request URLs. Somente o bloco settings (e a url do comando slash) difere.

Manifesto base (padrão do 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 o modo HTTP Request URLs, substitua settings pela variante HTTP e adicione url a cada comando slash. URL pública obrigatória:

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

Configurações adicionais do manifesto

Expõe recursos diferentes que estendem os padrões acima.

O manifesto padrão habilita a guia Início do Slack App Home e assina app_home_opened. Quando um membro do workspace abre a guia Início, o OpenClaw publica uma visualização inicial segura padrão com views.publish; nenhum payload de conversa ou configuração privada é incluído. A guia Mensagens permanece habilitada para DMs do Slack. O manifesto também habilita threads de assistente do Slack com features.assistant_view, assistant:write, assistant_thread_started e assistant_thread_context_changed; threads de assistente são roteadas para suas próprias sessões de thread do OpenClaw e mantêm o contexto de thread fornecido pelo Slack disponível para o agente.

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

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

Modelo de token

• botToken + appToken são obrigatórios para Socket Mode.
• O modo HTTP exige botToken + signingSecret.
• O modo relay exige botToken mais relay.url, relay.authToken e relay.gatewayId; ele não usa token de app nem segredo de assinatura.
• botToken, appToken, signingSecret, relay.authToken e userToken aceitam strings em texto simples ou objetos SecretRef.
• Tokens de configuração substituem o fallback de env.
• O fallback de env SLACK_BOT_TOKEN / SLACK_APP_TOKEN se aplica apenas à conta padrão.
• userToken só pode ser configurado por config (sem fallback de env) e usa comportamento somente leitura por padrão (userTokenReadOnly: true).

Comportamento do snapshot de status:

• A inspeção de contas do Slack rastreia campos *Source e *Status por credencial (botToken, appToken, signingSecret, userToken).
• O status é available, configured_unavailable ou missing.
• configured_unavailable significa que a conta está configurada por SecretRef ou outra fonte de segredo não inline, mas o caminho atual de comando/runtime não conseguiu resolver o valor real.
• No modo HTTP, signingSecretStatus é incluído; no Socket Mode, o par obrigatório é botTokenStatus + appTokenStatus.

Ações e gates

As ações do Slack são controladas por channels.slack.actions.*.

Grupos de ação disponíveis nas ferramentas atuais do Slack:

As ações atuais de mensagem do Slack incluem send, upload-file, download-file, read, edit, delete, pin, unpin, list-pins, member-info e emoji-list. download-file aceita IDs de arquivo do Slack mostrados em placeholders de arquivos recebidos e retorna pré-visualizações de imagem para imagens ou metadados de arquivo local para outros tipos de arquivo.

Controle de acesso e roteamento

Encadeamento, sessões e tags de resposta

• DMs são roteadas como direct; canais como channel; MPIMs como group.
• Vínculos de rota do Slack aceitam IDs de par brutos e formas de destino do Slack, como channel:C12345678, user:U12345678 e <@U12345678>.
• Com o padrão session.dmScope=main, DMs do Slack são consolidadas na sessão principal do agente.
• Sessões de canal: agent:<agentId>:slack:channel:<channelId>.
• Mensagens comuns de nível superior em canais permanecem na sessão por canal, mesmo quando replyToMode não é off.
• Respostas em threads do Slack usam o thread_ts pai do Slack para sufixos de sessão (:thread:<threadTs>), mesmo quando o encadeamento de respostas de saída está desabilitado com replyToMode="off".
• O OpenClaw inicializa uma raiz elegível de canal de nível superior em agent:<agentId>:slack:channel:<channelId>:thread:<rootTs> quando essa raiz deve iniciar uma thread visível do Slack, para que a raiz e respostas posteriores na thread compartilhem uma sessão do OpenClaw. Isso se aplica a eventos app_mention, correspondências explícitas de bot ou de padrão de menção configurado, e canais com requireMention: false com replyToMode diferente de off.
• O padrão de channels.slack.thread.historyScope é thread; o padrão de thread.inheritParent é false.
• channels.slack.thread.initialHistoryLimit controla quantas mensagens existentes da thread são buscadas quando uma nova sessão de thread começa (padrão 20; defina 0 para desabilitar).
• channels.slack.thread.requireExplicitMention (padrão false): quando true, suprime menções implícitas em threads para que o bot responda apenas a menções explícitas @bot dentro de threads, mesmo quando o bot já participou da thread. Sem isso, respostas em uma thread com participação do bot ignoram a exigência de requireMention.

Controles de encadeamento de resposta:

• channels.slack.replyToMode: off|first|all|batched (padrão off)
• channels.slack.replyToModeByChatType: por direct|group|channel
• fallback legado para chats diretos: channels.slack.dm.replyToMode

Tags manuais de resposta são compatíveis:

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

Para respostas explícitas em threads do Slack pela ferramenta message, defina replyBroadcast: true com action: "send" e threadId ou replyTo para pedir ao Slack que também transmita a resposta da thread para o canal pai. Isso mapeia para a flag reply_broadcast de chat.postMessage do Slack e só é compatível com envios de texto ou Block Kit, não uploads de mídia.

Quando uma chamada da ferramenta message é executada dentro de uma thread do Slack e aponta para o mesmo canal, o OpenClaw normalmente herda a thread atual do Slack de acordo com replyToMode. Defina topLevel: true em action: "send" ou action: "upload-file" para forçar uma nova mensagem no canal pai. threadId: null é aceito como a mesma opção de saída para nível superior.

Reações de confirmação

ackReaction envia um emoji de confirmação enquanto o OpenClaw processa uma mensagem de entrada. ackReactionScope decide quando esse emoji é realmente enviado.

Emoji (ackReaction)

Ordem de resolução:

• channels.slack.accounts.<accountId>.ackReaction
• channels.slack.ackReaction
• messages.ackReaction
• fallback para emoji de identidade do agente (agents.list[].identity.emoji, ou "eyes" / 👀)

Observações:

• O Slack espera shortcodes (por exemplo, "eyes").
• Use "" para desabilitar a reação para a conta do Slack ou globalmente.

Escopo (messages.ackReactionScope)

O provedor do Slack lê o escopo de messages.ackReactionScope (padrão "group-mentions"). Hoje não há sobrescrita por conta do Slack nem por canal do Slack; o valor é global para o Gateway.

Valores:

• "all": reage em DMs e grupos.
• "direct": reage somente em DMs.
• "group-all": reage a todas as mensagens de grupo (sem DMs).
• "group-mentions" (padrão): reage em grupos, mas somente quando o bot é mencionado (ou em mencionáveis de grupo que fizeram opt-in). DMs são excluídas.
• "off" / "none": nunca reage.

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

Streaming de texto

channels.slack.streaming controla o comportamento de pré-visualização ao vivo:

• off: desabilita o streaming de pré-visualização ao vivo.
• partial (padrão): substitui o texto de pré-visualização pela saída parcial mais recente.
• block: acrescenta atualizações de pré-visualização em blocos.
• progress: mostra texto de status de progresso durante a geração e depois envia o texto final.
• streaming.preview.toolProgress: quando a pré-visualização de rascunho está ativa, roteia atualizações de ferramenta/progresso para a mesma mensagem de pré-visualização editada (padrão: true). Defina false para manter mensagens separadas de ferramenta/progresso.
• streaming.preview.commandText / streaming.progress.commandText: defina como status para manter linhas compactas de progresso de ferramenta enquanto oculta texto bruto de comando/execução (padrão: raw).

Oculte texto bruto de comando/execução mantendo linhas compactas de progresso:

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

channels.slack.streaming.nativeTransport controla o streaming de texto nativo do Slack quando channels.slack.streaming.mode é partial (padrão: true).

Cartões nativos de tarefa de progresso do Slack são opt-in para o modo de progresso. Defina channels.slack.streaming.progress.nativeTaskCards como true com channels.slack.streaming.mode="progress" para enviar um cartão nativo do Slack de plano/tarefa enquanto o trabalho está em execução e depois atualizar o mesmo cartão de tarefa na conclusão. Sem essa flag, o modo de progresso mantém o comportamento portátil de pré-visualização de rascunho.

• Uma thread de resposta deve estar disponível para que o streaming de texto nativo e o status de thread do assistente do Slack apareçam. A seleção de thread ainda segue replyToMode.
• Raízes de canal, chat em grupo e DMs de nível superior ainda podem usar a pré-visualização normal de rascunho quando o streaming nativo está indisponível ou não existe thread de resposta.
• DMs de nível superior do Slack permanecem fora de thread por padrão, portanto não mostram a pré-visualização nativa de stream/status em estilo de thread do Slack; em vez disso, o OpenClaw posta e edita uma pré-visualização de rascunho na DM.
• Mídia e payloads não textuais fazem fallback para entrega normal.
• Finais de mídia/erro cancelam edições pendentes de pré-visualização; finais elegíveis de texto/bloco só são descarregados quando podem editar a pré-visualização no lugar.
• Se o streaming falhar no meio da resposta, o OpenClaw faz fallback para entrega normal dos payloads restantes.

Use pré-visualização de rascunho em vez de streaming de texto nativo do Slack:

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

Faça opt-in para cartões nativos de tarefa de progresso do Slack:

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

Chaves legadas:

• channels.slack.streamMode (replace | status_final | append) é um alias legado de runtime para channels.slack.streaming.mode.
• o booleano channels.slack.streaming é um alias legado de runtime para channels.slack.streaming.mode e channels.slack.streaming.nativeTransport.
• channels.slack.nativeStreaming legado é um alias de runtime para channels.slack.streaming.nativeTransport.
• Execute openclaw doctor --fix para reescrever a configuração persistida de streaming do Slack para as chaves canônicas.

Fallback de reação de digitação

typingReaction adiciona uma reação temporária à mensagem de entrada do Slack enquanto o OpenClaw processa uma resposta e depois a remove quando a execução termina. Isso é mais útil fora de respostas em threads, que usam um indicador de status padrão "está digitando...".

Ordem de resolução:

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

Observações:

• O Slack espera shortcodes (por exemplo, "hourglass_flowing_sand").
• A reação é de melhor esforço, e a limpeza é tentada automaticamente depois que a resposta ou o caminho de falha é concluído.

Mídia, divisão em partes e entrega

Comandos e comportamento de slash

Comandos slash aparecem no Slack como um único comando configurado ou vários comandos nativos. Configure channels.slack.slashCommand para alterar os padrões de comando:

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

/openclaw /help

Comandos nativos exigem configurações adicionais de manifesto no seu app do Slack e são habilitados com channels.slack.commands.native: true ou commands.native: true em configurações globais.

• O modo automático de comando nativo fica desligado para Slack, portanto commands.native: "auto" não habilita comandos nativos do Slack.

/help

Menus nativos de argumentos usam uma estratégia de renderização adaptativa que mostra um modal de confirmação antes de despachar um valor de opção selecionado:

• até 5 opções: blocos de botão
• 6 a 100 opções: menu de seleção estático
• mais de 100 opções: seleção externa com filtragem assíncrona de opções quando manipuladores de opções de interatividade estão disponíveis
• limites do Slack excedidos: valores de opção codificados fazem fallback para botões

/think

Sessões de barra usam chaves isoladas como agent:<agentId>:slack:slash:<userId> e ainda roteiam execuções de comandos para a sessão de conversa de destino usando CommandTargetSessionKey.

Respostas interativas

O Slack pode renderizar controles de resposta interativa criados por agente, mas esse recurso é desabilitado por padrão. Para novas saídas de agente, CLI e Plugin, prefira os botões presentation compartilhados ou blocos de seleção. Eles usam o mesmo caminho de interação do Slack e também degradam em outros canais.

Habilite globalmente:

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

Ou habilite apenas para uma conta do Slack:

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

Quando habilitado, os agentes ainda podem emitir diretivas de resposta obsoletas exclusivas do Slack:

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

Essas diretivas são compiladas para o Slack Block Kit e roteiam cliques ou seleções de volta pelo caminho de evento de interação existente do Slack. Mantenha-as para prompts antigos e rotas de escape específicas do Slack; use apresentação compartilhada para novos controles portáteis.

As APIs do compilador de diretivas também estão obsoletas para novo código produtor:

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

Use payloads presentation e buildSlackPresentationBlocks(...) para novos controles renderizados no Slack.

Observações:

• Esta é uma IU legada específica do Slack. Outros canais não traduzem diretivas do Slack Block Kit para seus próprios sistemas de botões.
• Os valores de callback interativo são tokens opacos gerados pelo OpenClaw, não valores brutos criados por agente.
• Se os blocos interativos gerados excederem os limites do Slack Block Kit, o OpenClaw volta para a resposta de texto original em vez de enviar um payload de blocos inválido.

Envios de modais pertencentes a Plugins

Plugins do Slack que registram um manipulador interativo também podem receber eventos de ciclo de vida modal view_submission e view_closed antes que o OpenClaw compacte o payload para o evento de sistema visível ao agente. Use um destes padrões de roteamento ao abrir um modal do Slack:

• Defina callback_id como openclaw:<namespace>:<payload>.
• Ou mantenha um callback_id existente e coloque pluginInteractiveData: "<namespace>:<payload>" nos private_metadata do modal.

O manipulador recebe ctx.interaction.kind como view_submission ou view_closed, inputs normalizados e o objeto bruto completo stateValues do Slack. O roteamento somente por callback-id é suficiente para invocar o manipulador do Plugin; inclua os campos de roteamento de usuário/sessão existentes em private_metadata do modal quando o modal também deve produzir um evento de sistema visível ao agente. O agente recebe um evento de sistema compacto e redigido Slack interaction: .... Se o manipulador retornar systemEvent.summary, systemEvent.reference ou systemEvent.data, esses campos serão incluídos nesse evento compacto para que o agente possa referenciar armazenamento pertencente ao Plugin sem ver o payload completo do formulário.

Aprovações nativas no Slack

O Slack pode atuar como um cliente de aprovação nativo com botões interativos e interações, em vez de voltar para a IU Web ou o terminal.

• Aprovações de execução e Plugin podem ser renderizadas como prompts Slack-native Block Kit.
• channels.slack.execApprovals.* continua sendo a configuração de habilitação do cliente nativo de aprovação de execução e de roteamento de DM/canal.
• DMs de aprovação de execução usam channels.slack.execApprovals.approvers ou commands.ownerAllowFrom.
• Aprovações de Plugin usam botões nativos do Slack quando o Slack está habilitado como cliente de aprovação nativo para a sessão de origem, ou quando approvals.plugin roteia para a sessão do Slack de origem ou para um destino do Slack.
• DMs de aprovação de Plugin usam aprovadores de Plugin do Slack de channels.slack.allowFrom, allowFrom de conta nomeada ou a rota padrão da conta.
• A autorização do aprovador ainda é aplicada: aprovadores somente de execução não podem aprovar solicitações de Plugin, a menos que também sejam aprovadores de Plugin.

Isso usa a mesma superfície compartilhada de botão de aprovação que outros canais. Quando interactivity está habilitado nas configurações do seu app Slack, os prompts de aprovação são renderizados como botões Block Kit diretamente na conversa. Quando esses botões estão presentes, eles são a principal UX de aprovação; o OpenClaw só deve incluir um comando manual /approve quando o resultado da ferramenta disser que aprovações por chat estão indisponíveis ou que a aprovação manual é o único caminho.

Caminho de configuração:

• channels.slack.execApprovals.enabled
• channels.slack.execApprovals.approvers (opcional; volta para commands.ownerAllowFrom quando possível)
• channels.slack.execApprovals.target (dm | channel | both, padrão: dm)
• agentFilter, sessionFilter

O Slack habilita automaticamente aprovações nativas de execução quando enabled não está definido ou é "auto" e pelo menos um aprovador de execução é resolvido. O Slack também pode lidar com aprovações nativas de Plugin por meio desse caminho de cliente nativo quando aprovadores de Plugin do Slack são resolvidos e a solicitação corresponde aos filtros do cliente nativo. Defina enabled: false para desabilitar explicitamente o Slack como cliente de aprovação nativo. Defina enabled: true para forçar aprovações nativas quando aprovadores forem resolvidos. Desabilitar aprovações de execução do Slack não desabilita a entrega de aprovação nativa de Plugin do Slack que é habilitada por meio de approvals.plugin; a entrega de aprovação de Plugin usa aprovadores de Plugin do Slack em vez disso.

Comportamento padrão sem configuração explícita de aprovação de execução do Slack:

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

A configuração explícita nativa do Slack só é necessária quando você quer substituir aprovadores, adicionar filtros ou optar pela entrega no chat de origem:

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

O encaminhamento compartilhado de approvals.exec é separado. Use-o somente quando os prompts de aprovação de execução também precisarem ser roteados para outros chats ou destinos explícitos fora da banda. O encaminhamento compartilhado de approvals.plugin também é separado; a entrega nativa do Slack suprime esse fallback somente quando o Slack consegue lidar nativamente com a solicitação de aprovação do plugin.

O /approve no mesmo chat também funciona em canais do Slack e DMs que já aceitam comandos. Consulte Aprovações de execução para ver o modelo completo de encaminhamento de aprovações.

Eventos e comportamento operacional

• Edições/exclusões de mensagens são mapeadas para eventos do sistema.
• Transmissões de thread (respostas de thread com "Também enviar para o canal") são processadas como mensagens normais de usuário.
• Eventos de adicionar/remover reações são mapeados para eventos do sistema.
• Eventos de entrada/saída de membros, canal criado/renomeado e adição/remoção de fixação são mapeados para eventos do sistema.
• channel_id_changed pode migrar chaves de configuração de canal quando configWrites está ativado.
• Metadados de tópico/finalidade do canal são tratados como contexto não confiável e podem ser injetados no contexto de roteamento.
• O iniciador da thread e a semeadura inicial do contexto de histórico da thread são filtrados por allowlists de remetentes configuradas quando aplicável.
• Ações de bloco, atalhos e interações modais emitem eventos de sistema estruturados Slack interaction: ... com campos de payload avançados:
  • ações de bloco: valores selecionados, rótulos, valores de seletores e metadados workflow_*
  • atalhos globais: metadados de callback e ator, roteados para a sessão direta do ator
  • atalhos de mensagem: contexto de callback, ator, canal, thread e mensagem selecionada
  • eventos modais view_submission e view_closed com metadados de canal roteado e entradas de formulário

Defina atalhos globais ou de mensagem na configuração do seu app Slack e use qualquer ID de callback não vazio. O OpenClaw confirma payloads de atalho correspondentes, aplica a mesma política de remetente de DM/canal das outras interações do Slack e enfileira o evento higienizado para a sessão do agente roteada. IDs de acionamento e URLs de resposta são redigidos do contexto do agente.

Referência de configuração

Referência principal: Referência de configuração - Slack.

Solução de problemas

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

openclaw channels status --probeopenclaw logs --followopenclaw doctor

openclaw pairing list slack

Referência de visão de anexos

O Slack pode anexar mídia baixada à rodada do agente quando os downloads de arquivos do Slack têm sucesso e os limites de tamanho permitem. Arquivos de imagem podem passar pelo caminho de compreensão de mídia ou diretamente para um modelo de resposta com capacidade de visão; outros arquivos são mantidos como contexto de arquivo baixável, em vez de tratados como entrada de imagem.

Tipos de mídia compatíveis

Pipeline de entrada

Quando uma mensagem do Slack com anexos de arquivo chega:

1. O OpenClaw baixa o arquivo da URL privada do Slack usando o token do bot.
2. O arquivo é gravado no armazenamento de mídia em caso de sucesso.
3. Caminhos de mídia baixada e tipos de conteúdo são adicionados ao contexto de entrada.
4. Caminhos de modelo/ferramenta com capacidade de imagem podem usar anexos de imagem desse contexto.
5. Arquivos que não são imagem permanecem disponíveis como metadados de arquivo ou referências de mídia para ferramentas que conseguem lidar com eles.

Herança de anexos da raiz da thread

Quando uma mensagem chega em uma thread (tem um pai thread_ts):

• Se a própria resposta não tiver mídia direta e a mensagem raiz incluída tiver arquivos, o Slack pode hidratar os arquivos raiz como contexto de início da thread.
• Anexos diretos da resposta têm precedência sobre anexos da mensagem raiz.
• Uma mensagem raiz que tenha apenas arquivos e nenhum texto é representada com um placeholder de anexo para que o fallback ainda possa incluir seus arquivos.

Tratamento de vários anexos

Quando uma única mensagem do Slack contém vários anexos de arquivo:

• Cada anexo é processado independentemente pelo pipeline de mídia.
• Referências de mídia baixada são agregadas ao contexto da mensagem.
• A ordem de processamento segue a ordem dos arquivos do Slack na carga do evento.
• Uma falha no download de um anexo não bloqueia os outros.

Limites de tamanho, download e modelo

• Limite de tamanho: padrão de 20 MB por arquivo. Configurável via channels.slack.mediaMaxMb.
• Falhas de download: arquivos que o Slack não consegue servir, URLs expiradas, arquivos inacessíveis, arquivos grandes demais e respostas HTML de autenticação/login do Slack são ignorados em vez de serem relatados como formatos não compatíveis.
• Modelo de visão: a análise de imagem usa o modelo de resposta ativo quando ele oferece suporte a visão, ou o modelo de imagem configurado em agents.defaults.imageModel.

Limites conhecidos

Documentação relacionada

• Pipeline de compreensão de mídia
• Ferramenta PDF
• Epic: #51349 — habilitação de visão de anexos do Slack
• Testes de regressão: #51353
• Verificação ao vivo: #51354

Relacionados