Slack

Pronto para produção para DMs e canais por meio de integrações de apps do Slack. O modo padrão é Socket Mode; URLs de solicitação HTTP também são compatíveis.

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 slash, App Home e interatividade. Escolha pelo formato de implantação, não pelos recursos.

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},"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","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},"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","message.channels","message.groups","message.im"]}}}

export SLACK_APP_TOKEN=xapp-...export SLACK_BOT_TOKEN=xoxb-...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" },},},}JSON5openclaw config patch --file ./slack.socket.patch.json5 --dry-runopenclaw config patch --file ./slack.socket.patch.json5

SLACK_APP_TOKEN=xapp-...SLACK_BOT_TOKEN=xoxb-...

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},"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","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},"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","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=xoxb-...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",},},}JSON5openclaw config patch --file ./slack.http.patch.json5 --dry-runopenclaw config patch --file ./slack.http.patch.json5

openclaw gateway

Ajuste do transporte em Socket Mode

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

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

Use isto somente para workspaces em Socket Mode que registram timeouts de pong/server-ping no websocket do Slack ou rodam em hosts com esgotamento conhecido do loop de eventos. clientPingTimeout é a espera pelo pong depois que o SDK envia um ping do 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.

Checklist de manifesto e escopos

O manifesto base do app Slack é o mesmo para Socket Mode e URLs de solicitação HTTP. Apenas o bloco settings (e o 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    },    "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",        "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 URLs de solicitação HTTP, 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",        "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

Exponha diferentes recursos que ampliam os padrões acima.

O manifesto padrão habilita a aba Home do Slack App Home e assina app_home_opened. Quando um membro do workspace abre a aba Home, o OpenClaw publica uma visualização Home padrão segura com views.publish; nenhum payload de conversa ou configuração privada é incluído. A aba Messages permanece habilitada para DMs do Slack.

{"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": "/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 tokens

• botToken + appToken são obrigatórios para o Socket Mode.
• O modo HTTP exige botToken + signingSecret.
• botToken, appToken, signingSecret e userToken aceitam strings de 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 (xoxp-...) existe apenas na configuração (sem fallback de env) e usa comportamento somente leitura por padrão (userTokenReadOnly: true).

Comportamento do instantâneo de status:

• A inspeção de conta 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 origem de segredo não inline, mas o comando/caminho de runtime atual 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 controles

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

Grupos de ações disponíveis nas ferramentas atuais do Slack:

As ações de mensagem atuais 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 arquivos do Slack mostrados em placeholders de arquivos recebidos e retorna prévias de imagem para imagens ou metadados de arquivo local para outros tipos de arquivo.

Controle de acesso e roteamento

Threads, 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 brutos de pares e formas de destino do Slack, como channel:C12345678, user:U12345678 e <@U12345678>.
• Com o session.dmScope=main padrão, DMs do Slack são agrupadas na sessão principal do agente.
• Sessões de canal: agent:<agentId>:slack:channel:<channelId>.
• Respostas em thread podem criar sufixos de sessão de thread (:thread:<threadTs>) quando aplicável.
• Em canais nos quais o OpenClaw trata mensagens de nível superior sem exigir menção explícita, replyToMode diferente de off roteia cada raiz tratada para agent:<agentId>:slack:channel:<channelId>:thread:<rootTs>, para que a thread visível do Slack mapeie para uma sessão do OpenClaw desde o primeiro turno.
• O padrão de channels.slack.thread.historyScope é thread; o padrão de thread.inheritParent é false.
• channels.slack.thread.initialHistoryLimit controla quantas mensagens de thread existentes são buscadas quando uma nova sessão de thread começa (padrão 20; defina 0 para desativar).
• channels.slack.thread.requireExplicitMention (padrão false): quando true, suprime menções implícitas de thread 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 o controle de requireMention.

Controles de encadeamento de respostas:

• 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 de resposta manuais são compatíveis:

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

Para respostas explícitas em thread 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 é compatível apenas com envios de texto ou Block Kit, não com uploads de mídia.

Quando uma chamada da ferramenta message é executada dentro de uma thread do Slack e tem o mesmo canal como destino, 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 está processando uma mensagem recebida.

Ordem de resolução:

• channels.slack.accounts.<accountId>.ackReaction
• channels.slack.ackReaction
• messages.ackReaction
• fallback de emoji da identidade do agente (agents.list[].identity.emoji; caso contrário, "👀")

Observações:

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

Streaming de texto

channels.slack.streaming controla o comportamento de prévia ao vivo:

• off: desativa streaming de prévia ao vivo.
• partial (padrão): substitui o texto de prévia pela saída parcial mais recente.
• block: acrescenta atualizações de prévia 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évia de rascunho está ativa, roteia atualizações de ferramenta/progresso para a mesma mensagem de prévia editada (padrão: true). Defina como 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/exec (padrão: raw).

Ocultar texto bruto de comando/exec 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).

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

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

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

Chaves legadas:

• channels.slack.streamMode (replace | status_final | append) é um alias de runtime legado para channels.slack.streaming.mode.
• o booleano channels.slack.streaming é um alias de runtime legado 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 recebida 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 "is typing...".

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 é em melhor esforço, e a limpeza é tentada automaticamente depois que o caminho de resposta ou falha é concluído.

Mídia, fragmentação e entrega

Comandos e comportamento de barra

Comandos de barra 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 nas configurações globais.

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

/help

Menus de argumentos nativos 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 handlers de opções de interatividade estão disponíveis
• limites do Slack excedidos: valores de opção codificados recorrem a botões

/think

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

Respostas interativas

O Slack pode renderizar controles de resposta interativos criados pelo agente, mas esse recurso vem desabilitado por padrão.

Habilite-o globalmente:

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

Ou habilite-o somente para uma conta do Slack:

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

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

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

Essas diretivas são compiladas para Slack Block Kit e encaminham cliques ou seleções de volta pelo caminho de evento de interação existente do Slack.

Observações:

• Esta é uma interface 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 escritos pelo 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 uma carga útil de blocos inválida.

Aprovações de execução no Slack

O Slack pode atuar como um cliente nativo de aprovação com botões interativos e interações, em vez de recorrer à interface Web ou ao terminal.

• Aprovações de execução usam channels.slack.execApprovals.* para roteamento nativo de DM/canal.
• Aprovações de Plugin ainda podem ser resolvidas pela mesma superfície de botões nativa do Slack quando a solicitação já chega ao Slack e o tipo do ID de aprovação é plugin:.
• A autorização do aprovador ainda é aplicada: somente usuários identificados como aprovadores podem aprovar ou negar solicitações pelo Slack.

Isso usa a mesma superfície compartilhada de botões 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 do Block Kit diretamente na conversa. Quando esses botões estão presentes, eles são a UX principal de aprovação; o OpenClaw deve incluir um comando manual /approve somente 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; recorre a commands.ownerAllowFrom quando possível)
• channels.slack.execApprovals.target (dm | channel | both, padrão: dm)
• agentFilter, sessionFilter

O Slack habilita automaticamente aprovações de execução nativas quando enabled não está definido ou é "auto" e pelo menos um aprovador é resolvido. Defina enabled: false para desabilitar explicitamente o Slack como cliente nativo de aprovação. Defina enabled: true para forçar aprovações nativas quando aprovadores forem resolvidos.

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

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

A configuração nativa explícita do Slack só é necessária quando você quer substituir aprovadores, adicionar filtros ou aderir à 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 prompts de aprovação de execução também precisarem ser roteados para outros chats ou destinos explícitos fora de banda. O encaminhamento compartilhado de approvals.plugin também é separado; botões nativos do Slack ainda podem resolver aprovações de Plugin quando essas solicitações já chegam ao Slack.

/approve no mesmo chat também funciona em canais e DMs do Slack que já oferecem suporte a 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 adição/remoção de reação são mapeados para eventos do sistema.
• Eventos de entrada/saída de membro, 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á habilitado.
• 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 do contexto inicial do histórico da thread são filtrados por allowlists de remetentes configuradas quando aplicável.
• Ações de bloco e interações modais emitem eventos de sistema estruturados Slack interaction: ... com campos de carga útil ricos:
  • ações de bloco: valores selecionados, rótulos, valores de seletores e metadados workflow_*
  • eventos modais view_submission e view_closed com metadados de canal roteado e entradas de formulário

Referência de configuração

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

Solução de problemas

openclaw channels status --probeopenclaw logs --followopenclaw doctor

openclaw pairing list slack

Referência de visão para anexos

O Slack pode anexar mídia baixada ao turno do agente quando os downloads de arquivos do Slack são bem-sucedidos e os limites de tamanho permitem. Arquivos de imagem podem ser passados pelo caminho de entendimento 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 serem 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 (xoxb-...).
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 do início da thread.
• Anexos diretos da resposta têm precedência sobre anexos da mensagem raiz.
• Uma mensagem raiz que tem 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 no payload 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 incompatíveis.
• Modelo de visão: a análise de imagem usa o modelo de resposta ativo quando ele tem suporte a visão, ou o modelo de imagem configurado em agents.defaults.imageModel.

Limites conhecidos

Documentação relacionada

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

Relacionado