Slack

O suporte ao Slack abrange mensagens diretas e canais por meio de integrações de aplicativos do Slack. O transporte padrão é o Socket Mode; URLs de solicitação HTTP também são compatíveis. O modo de retransmissão destina-se a implantações gerenciadas nas quais um roteador confiável controla a entrada do Slack.

Escolha de um transporte

O Socket Mode e as URLs de solicitação HTTP oferecem os mesmos recursos para mensagens, comandos de barra, App Home e interatividade. Escolha com base na arquitetura da implantação, não nos recursos.

Modo de retransmissão

O modo de retransmissão separa a entrada do Slack do Gateway do OpenClaw. Um roteador confiável controla a única conexão do Socket Mode com o Slack, escolhe um Gateway de destino e encaminha um evento tipado por um websocket autenticado. O Gateway ainda usa seu próprio token de bot para chamadas de saída à API Web 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 de portador e a tabela de rotas do roteador como parte do limite de autorização do Slack: os 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 tem prioridade. A conexão de retransmissão é restabelecida com o mesmo intervalo de espera progressiva limitada do Socket Mode e limpa a identidade fornecida pelo roteador sempre que é desconectada.

Instalações para toda a organização no Enterprise Grid

Uma conta do Slack pode receber mensagens de todos os espaços de trabalho abrangidos por uma instalação para toda a organização do Enterprise Grid. Escolha o Socket Mode direto ou URLs de solicitação HTTP; o modo de retransmissão não é compatível com contas corporativas. Ambos os manifestos de privilégio mínimo abaixo habilitam somente o caminho de eventos V1 message e app_mention, respostas imediatas e reações de status controladas pelo listener.

Socket Mode

{  "display_information": {    "name": "OpenClaw",    "description": "Conector do Slack para o 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"      ]    }  }}

Peça a um Enterprise Grid Org Admin ou Org Owner para aprovar o aplicativo, instalá-lo no nível da organização e escolher os espaços de trabalho abrangidos pela instalação. Confirme se o aplicativo está disponível em todos os espaços de trabalho pretendidos antes de iniciar o OpenClaw. Gere um token no nível do aplicativo com connections:write para o Socket Mode e copie o token do bot da instalação da organização. Configure a conta que usa o token do bot instalado na organização:

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

URLs de solicitação HTTP

Use o modo HTTP quando o Gateway tiver um endpoint HTTPS público e não abrir uma conexão do Socket Mode. Substitua a URL de exemplo pela URL pública de webhookPath do Gateway (padrão /slack/events):

{  "display_information": {    "name": "OpenClaw",    "description": "Conector do Slack para o 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"      ]    }  }}

Peça a um Enterprise Grid Org Admin ou Org Owner para aprovar o aplicativo, instalá-lo no nível da organização e escolher os espaços de trabalho abrangidos pela instalação. Depois que o Slack verificar a Request URL, copie o token do bot da instalação da organização e o Basic Information -> App Credentials -> Signing Secret do aplicativo. Configure a conta corporativa com o mesmo caminho da Request URL:

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

Na inicialização, o OpenClaw verifica enterpriseOrgInstall usando auth.test do Slack. Um token instalado na organização sem o sinalizador, ou um token de espaço de trabalho com o sinalizador, faz com que a inicialização falhe. O Slack continua sendo a fonte da verdade sobre quais espaços de trabalho concederam a instalação; em seguida, o OpenClaw aplica as políticas configuradas de canal, usuário, mensagem direta e menção a cada evento entregue. O Enterprise V1 rejeita todos os eventos message e app_mention criados por bots antes do encaminhamento, independentemente de allowBots, porque as instalações da organização não fornecem uma identidade de bot estável qualificada pelo espaço de trabalho para impedir loops.

O suporte corporativo é intencionalmente limitado a eventos diretos message e app_mention do Socket Mode ou HTTP e às suas respostas imediatas. O modo de retransmissão, os comandos de barra, as interações, o App Home, os listeners de eventos de reação, os itens fixados, as ferramentas de ação do Slack, as aprovações nativas do Slack, as associações, a entrega enfileirada ou agendada e os envios proativos não estão disponíveis para uma conta corporativa. As reações de confirmação, digitação e status de saída são compatíveis por meio do cliente Slack controlado pelo listener e exigem reactions:write; as notificações de reação de entrada e as ferramentas de ação de reação continuam indisponíveis.

As respostas imediatas reutilizam o comportamento padrão de entrega do Slack para blocos, mídia, metadados, identidade alternativa, expansões de links e confirmações, mas somente enquanto o cliente validado controlado pelo listener permanecer no turno ativo do evento. A fila de envio em memória e os registros de participação em conversas são particionados pelo espaço de trabalho desse evento; o próprio cliente nunca é serializado nem persistido.

As chaves de política de canal e as entradas de dm.groupChannels devem usar IDs de canal estáveis brutos do Slack ou o formato channel:<id>. O OpenClaw normaliza qualquer um dos formatos para o ID bruto do canal para correspondência em tempo de execução; os prefixos slack:, group: e mpim: impedem a inicialização. As entradas de política de usuário devem usar IDs de usuário estáveis do Slack; nomes, slugs, nomes de exibição e endereços de e-mail impedem a inicialização. Os IDs devem usar o prefixo e o corpo canônicos em maiúsculas do Slack (por exemplo, C0123456789 ou U0123456789); versões em minúsculas e imitações mais curtas impedem a inicialização. Contas Enterprise não podem habilitar dangerouslyAllowNameMatching. Contas Enterprise podem definir o mentionPatterns.mode global, mas mentionPatterns.allowIn e mentionPatterns.denyIn impedem a inicialização porque IDs de canal brutos do Slack não são qualificados pelo workspace e podem ser reutilizados entre workspaces. Instalações em workspace mantêm o comportamento existente de padrões de menção com escopo. Cada workspace aceito recebe identidades separadas de roteamento, sessão, transcrição, desduplicação, histórico e cache, mesmo quando os IDs do Slack se sobrepõem. No fluxo message, mensagens comuns de usuários e eventos file_share criados por usuários são compatíveis; outros subtipos de mensagem são rejeitados antes da autorização ou do tratamento de eventos do sistema.

As DMs Enterprise devem estar desabilitadas (dm.enabled=false ou dmPolicy="disabled") ou explicitamente abertas com dmPolicy="open" e um allowFrom efetivo da conta contendo o literal "*". Uma lista de permissões vazia ou IDs específicos de usuários sem "*" impedem a inicialização. O pareamento e as listas de permissões de DM por usuário são rejeitados porque os IDs de usuário do Slack não são qualificados pelo workspace nesses armazenamentos de autorização. A política de canal e remetente continua sendo aplicada às mensagens de canal.

Instalação

openclaw plugins install @openclaw/slack

plugins install registra e habilita o plugin. Ele não faz nada até que você configure o aplicativo Slack e as definições de canal abaixo. Consulte Plugins para conhecer as regras gerais de instalação de plugins.

Configuração rápida

Os manifestos desta seção criam uma instalação com escopo de workspace. Para uma instalação em toda a organização do Enterprise Grid, use o manifesto e fluxo de trabalho para toda a organização dedicado.

{"display_information": {"name": "OpenClaw","description": "Conector do Slack para o 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": "O OpenClaw conecta threads do assistente do Slack a agentes do OpenClaw.","suggested_prompts": [{ "title": "O que você pode fazer?", "message": "Com o que você pode me ajudar?" },{"title": "Resumir este canal","message": "Resuma a atividade recente neste canal."},{ "title": "Elaborar uma resposta", "message": "Ajude-me a elaborar uma resposta." }]},"slash_commands": [{"command": "/openclaw","description": "Enviar uma mensagem ao 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": "Conector do Slack para o 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": "O OpenClaw conecta threads do assistente do Slack a agentes do OpenClaw.","suggested_prompts": [{ "title": "O que você pode fazer?", "message": "Com o que você pode me ajudar?" },{"title": "Resumir este canal","message": "Resuma a atividade recente neste canal."},{ "title": "Elaborar uma resposta", "message": "Ajude-me a elaborar uma resposta." }]},"slash_commands": [{"command": "/openclaw","description": "Enviar uma mensagem ao 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": "Conector do Slack para o 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": "O OpenClaw conecta threads do assistente do Slack a agentes do OpenClaw.","suggested_prompts": [{ "title": "O que você pode fazer?", "message": "Com o que você pode me ajudar?" },{"title": "Resumir este canal","message": "Resuma a atividade recente neste canal."},{ "title": "Elaborar uma resposta", "message": "Ajude-me a elaborar uma resposta." }]},"slash_commands": [{"command": "/openclaw","description": "Enviar uma mensagem ao 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": "Conector do Slack para o 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": "O OpenClaw conecta threads do assistente do Slack a agentes do OpenClaw.","suggested_prompts": [{ "title": "O que você pode fazer?", "message": "Com o que você pode me ajudar?" },{"title": "Resumir este canal","message": "Resuma a atividade recente neste canal."},{ "title": "Redigir uma resposta", "message": "Ajude-me a redigir uma resposta." }]},"slash_commands": [{"command": "/openclaw","description": "Enviar uma mensagem ao 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 do transporte do Socket Mode

Por padrão, o OpenClaw define 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 do espaço de trabalho ou do host:

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

Use isso somente em espaços de trabalho no Socket Mode que registrem tempos limite de pong/server-ping do websocket do Slack ou sejam executados em hosts com inanição conhecida do loop de eventos. clientPingTimeout é o tempo de espera pelo pong depois que o SDK envia um ping do cliente; serverPingTimeout é o tempo de espera pelos pings do servidor do Slack. Mensagens e eventos do aplicativo continuam sendo estado da aplicação, não sinais de atividade do transporte.

Observações:

• socketMode é ignorado no modo HTTP Request URL.
• As configurações básicas de channels.slack.socketMode se aplicam a todas as contas do Slack, salvo quando substituídas. As substituições por conta usam channels.slack.accounts.<accountId>.socketMode; como essa é uma substituição de objeto, inclua todos os campos de ajuste de socket desejados para essa conta.
• Somente clientPingTimeout tem um valor padrão do OpenClaw (15000). serverPingTimeout e pingPongLoggingEnabled são repassados ao SDK do Slack somente quando configurados.
• O recuo de reinicialização do Socket Mode começa em cerca de 2 segundos e tem um limite de aproximadamente 30 segundos. Falhas recuperáveis de inicialização, espera pela inicialização e desconexão são repetidas até que o canal seja interrompido. Erros permanentes de conta e credenciais, como autenticação inválida, tokens revogados ou escopos ausentes, falham imediatamente em vez de tentar novamente para sempre.

Checklist de manifesto e escopos

O manifesto básico do aplicativo Slack é o mesmo para o Socket Mode e para HTTP Request URLs. Apenas o bloco settings (e a url do comando de barra) é diferente.

Manifesto básico (Socket Mode por padrão):

{  "display_information": {    "name": "OpenClaw",    "description": "Conector do Slack para o 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": "O OpenClaw conecta threads do assistente do Slack a agentes do OpenClaw.",      "suggested_prompts": [        { "title": "O que você pode fazer?", "message": "Com o que você pode me ajudar?" },        {          "title": "Resumir este canal",          "message": "Resuma a atividade recente neste canal."        },        { "title": "Redigir uma resposta", "message": "Ajude-me a redigir uma resposta." }      ]    },    "slash_commands": [      {        "command": "/openclaw",        "description": "Enviar uma mensagem ao 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 de barra. URL pública obrigatória:

{  "features": {    "slash_commands": [      {        "command": "/openclaw",        "description": "Enviar uma mensagem ao 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

Disponibilize diferentes recursos que ampliem os padrões acima.

O manifesto padrão habilita a guia Home do Slack App Home e assina o evento app_home_opened. Quando um membro do espaço de trabalho abre a guia Home, o OpenClaw publica uma visualização inicial padrão segura com views.publish; nenhum payload de conversa ou configuração privada é incluído. Quando o modo de comando de barra único está habilitado, a dica do comando usa channels.slack.slashCommand.name; instalações que usam comandos nativos ou nenhum comando de barra omitem essa dica. A guia Messages permanece habilitada para DMs do Slack. O manifesto também habilita threads do assistente do Slack com features.assistant_view, assistant:write, assistant_thread_started e assistant_thread_context_changed; as threads do assistente são encaminhadas para suas próprias sessões de thread do OpenClaw e mantêm o contexto da thread fornecido pelo Slack disponível para o agente.

{"slash_commands": [{"command": "/new","description": "Iniciar uma nova sessão","usage_hint": "[model]"},{"command": "/reset","description": "Redefinir a sessão atual"},{"command": "/compact","description": "Compactar o contexto da sessão","usage_hint": "[instructions]"},{"command": "/stop","description": "Interromper a execução atual"},{"command": "/session","description": "Gerenciar a expiração da vinculação à thread","usage_hint": "idle <duration|off> or max-age <duration|off>"},{"command": "/think","description": "Definir o nível de raciocínio","usage_hint": "<level>"},{"command": "/verbose","description": "Alternar a saída detalhada","usage_hint": "on|off|full"},{"command": "/fast","description": "Exibir ou definir o modo rápido","usage_hint": "[status|on|off]"},{"command": "/reasoning","description": "Alternar a visibilidade do raciocínio","usage_hint": "[on|off|stream]"},{"command": "/elevated","description": "Alternar o modo elevado","usage_hint": "[on|off|ask|full]"},{"command": "/exec","description": "Exibir ou definir os padrões de execução","usage_hint": "host=<auto|sandbox|gateway|node> security=<deny|allowlist|full> ask=<off|on-miss|always> node=<id>"},{"command": "/approve","description": "Aprovar ou negar solicitações de aprovação pendentes","usage_hint": "<id> <decision>"},{"command": "/model","description": "Exibir ou definir o modelo","usage_hint": "[name|#|status]"},{"command": "/models","description": "Listar provedores/modelos","usage_hint": "[provider] [page] [limit=<n>|size=<n>|all]"},{"command": "/help","description": "Exibir o resumo breve da ajuda"},{"command": "/commands","description": "Exibir o catálogo de comandos gerado"},{"command": "/tools","description": "Exibir o que o agente atual pode usar neste momento","usage_hint": "[compact|verbose]"},{"command": "/agentstatus","description": "Exibir o status do runtime, incluindo o uso/a cota do provedor quando disponível"},{"command": "/tasks","description": "Listar tarefas em segundo plano ativas/recentes da sessão atual"},{"command": "/context","description": "Explicar como o contexto é montado","usage_hint": "[list|detail|json]"},{"command": "/whoami","description": "Exibir sua identidade de remetente"},{"command": "/skill","description": "Executar uma skill pelo nome","usage_hint": "<name> [input]"},{"command": "/btw","description": "Fazer uma pergunta paralela sem alterar o contexto da sessão","usage_hint": "<question>"},{"command": "/side","description": "Fazer uma pergunta paralela sem alterar o contexto da sessão","usage_hint": "<question>"},{"command": "/usage","description": "Controlar o rodapé de uso ou exibir o resumo de custos","usage_hint": "off|tokens|full|cost"}]}

{"slash_commands": [{"command": "/new","description": "Iniciar uma nova sessão","usage_hint": "[model]","url": "https://gateway-host.example.com/slack/events"},{"command": "/help","description": "Exibir o resumo breve da ajuda","url": "https://gateway-host.example.com/slack/events"}]}

Modelo de tokens

• botToken + appToken são obrigatórios para o Socket Mode.
• O modo HTTP requer botToken + signingSecret.
• O modo de retransmissão requer botToken, além de relay.url, relay.authToken e relay.gatewayId; ele não usa um token de aplicativo nem um segredo de assinatura.
• botToken, appToken, signingSecret, relay.authToken e userToken aceitam strings de texto simples ou objetos SecretRef.
• Os tokens da configuração substituem o fallback de variáveis de ambiente.
• O fallback das variáveis de ambiente SLACK_BOT_TOKEN, SLACK_APP_TOKEN e SLACK_USER_TOKEN aplica-se, em cada caso, somente à conta padrão.
• userToken adota por padrão o comportamento somente leitura (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 meio de SecretRef ou de outra fonte de segredo não incorporada, mas o caminho atual do 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 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 atuais de mensagens 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 exibidos nos placeholders de arquivos recebidos e retorna pré-visualizações para imagens ou metadados de arquivos locais para outros tipos de arquivo.

Controle de acesso e roteamento

Threads, sessões e tags de resposta

• As DMs são roteadas como direct; os canais, como channel; e as MPIMs, como group.
• As associações de rota do Slack aceitam IDs brutos de pares, além de formatos de destino do Slack como channel:C12345678, user:U12345678 e <@U12345678>.
• Com o padrão session.dmScope=main, as DMs do Slack são consolidadas na sessão principal do agente.
• Sessões de canal: agent:<agentId>:slack:channel:<channelId>.
• Mensagens comuns no nível superior do canal permanecem na sessão específica do canal, mesmo quando replyToMode não é off.
• As respostas em threads do Slack usam o thread_ts pai do Slack nos sufixos de sessão (:thread:<threadTs>), mesmo quando a criação de threads para respostas de saída está desativada com replyToMode="off".
• O OpenClaw inicializa uma raiz de canal de nível superior elegível em agent:<agentId>:slack:channel:<channelId>:thread:<rootTs> quando se espera que essa raiz inicie uma thread visível no Slack, para que a raiz e as respostas posteriores na thread compartilhem uma única sessão do OpenClaw. Isso se aplica a eventos app_mention, correspondências explícitas com o bot ou com padrões de menção configurados e canais com requireMention: false e 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 é iniciada (padrão 20; defina como 0 para desativar).
• channels.slack.thread.requireExplicitMention (padrão false): quando true, suprime menções implícitas em threads, para que o bot responda somente a menções explícitas a @bot dentro das threads, mesmo que já tenha participado delas. Sem isso, as respostas em uma thread da qual o bot participou ignoram a restrição de requireMention.

Controles de criação de threads para respostas:

• channels.slack.channels.<id>.replyToMode: substituição por canal para mensagens de canais públicos/privados do Slack
• channels.slack.replyToMode: off|first|all|batched (padrão off)
• channels.slack.replyToModeByChatType: por direct|group|channel
• fallback legado para conversas diretas: channels.slack.dm.replyToMode

Há suporte a tags manuais de resposta:

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

Para respostas explícitas em threads do Slack enviadas pela ferramenta message, defina replyBroadcast: true com action: "send" e threadId ou replyTo para solicitar que o Slack também transmita a resposta da thread no canal pai. Isso corresponde ao sinalizador reply_broadcast de chat.postMessage do Slack e só é compatível 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 como destino o mesmo canal, o OpenClaw normalmente herda a thread atual do Slack de acordo com o replyToMode efetivo da conta, do tipo de conversa ou do canal. Respostas automáticas e chamadas send ou upload-file para o mesmo canal usam a mesma substituição por canal. 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 não usar thread no nível superior.

Reações de confirmação

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

Por padrão, a confirmação permanece estática enquanto o status nativo da thread do assistente do Slack mostra o progresso com mensagens de carregamento alternadas. Defina messages.statusReactions.enabled: true para habilitar o ciclo de vida de reações de fila/raciocínio/ferramenta/conclusão/erro.

Emoji (ackReaction)

Ordem de resolução:

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

Observações:

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

Escopo (messages.ackReactionScope)

O provedor do Slack lê o escopo de messages.ackReactionScope (padrão "group-mentions"). Atualmente, não há substituição no nível da conta nem do canal do Slack; o valor é global para o Gateway.

Valores:

• "all": reage em DMs e grupos, incluindo eventos ambientes de salas.
• "direct": reage apenas em DMs.
• "group-all": reage a todas as mensagens de grupo, exceto eventos ambientes de salas (sem DMs).
• "group-mentions" (padrão): reage em grupos, mas somente quando o bot é mencionado (ou em grupos com recursos de menção que habilitaram essa opção). As DMs são excluídas.
• "off" / "none": nunca reage.

{  messages: {    ackReaction: "eyes",    ackReactionScope: "all", // reage em DMs e grupos  },}

Streaming de texto

channels.slack.streaming controla o comportamento da visualização ao vivo:

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

Oculte o texto bruto de comandos/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).

Os cartões de tarefas de progresso nativos do Slack são opcionais no 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, ao concluir, atualizar o mesmo cartão de tarefa. Sem esse sinalizador, o modo de progresso mantém o comportamento portátil de visualização de rascunho.

• Uma thread de resposta precisa 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 continua seguindo replyToMode.
• Canais, conversas em grupo e raízes de DMs no nível superior ainda podem usar a visualização normal de rascunho quando o streaming nativo não está disponível ou não existe uma thread de resposta.
• Por padrão, as DMs de nível superior do Slack permanecem fora de threads e, portanto, não mostram a visualização nativa de streaming/status no estilo de thread do Slack; em vez disso, o OpenClaw publica e edita uma visualização de rascunho na DM.
• Mídias e cargas úteis que não sejam texto usam como fallback a entrega normal.
• Resultados finais de mídia/erro cancelam edições pendentes da visualização; resultados finais elegíveis de texto/blocos só são concluídos quando podem editar a visualização no mesmo local.
• Se o streaming falhar durante a resposta, o OpenClaw usa como fallback a entrega normal para as cargas úteis restantes.

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

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

Habilite os cartões de tarefas de progresso nativos 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 channels.slack.streaming.mode.
• O valor booleano channels.slack.streaming é um alias legado de channels.slack.streaming.mode e channels.slack.streaming.nativeTransport.
• channels.slack.chunkMode e channels.slack.nativeStreaming no nível superior são aliases legados de channels.slack.streaming.chunkMode e channels.slack.streaming.nativeTransport.
• Os aliases legados não são lidos em tempo de execução; execute openclaw doctor --fix para reescrever a configuração persistida de streaming do Slack com 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 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 códigos curtos (por exemplo, "hourglass_flowing_sand").
• A reação funciona em regime de melhor esforço, e a limpeza é tentada automaticamente depois que o caminho de resposta ou falha é concluído.

Entrada de voz

Atualmente, para falar com o OpenClaw no Slack, envie um clipe de áudio do Slack para o aplicativo OpenClaw. O microfone de ditado do Slackbot é um recurso separado pertencente ao Slack, não uma API de aplicativo.

• O ditado por voz do Slackbot funciona dentro da conversa privada do usuário com o Slackbot. O Slack transforma a gravação em um prompt do Slackbot, mas não emite arquivo de áudio, evento de ditado, prompt nem marcador da origem da entrada para aplicativos de terceiros do Slack por meio da Events API. O Plugin do Slack para OpenClaw não pode habilitá-lo nem recebê-lo.
• Os clipes de áudio do Slack são arquivos armazenados no Slack que podem ser publicados em uma DM, um canal ou uma thread do OpenClaw. O OpenClaw baixa um clipe acessível usando o token do bot, normaliza os metadados MIME do clipe do Slack e o envia pelo pipeline compartilhado de transcrição de áudio. O manifesto recomendado do aplicativo inclui o escopo obrigatório files:read.

Os clipes de áudio e o ditado do Slackbot têm semânticas de privacidade diferentes: os clipes seguem a política de retenção de arquivos do Slack, e o OpenClaw os baixa para transcrição, enquanto o Slack informa que o áudio de ditado não é armazenado.

Em um canal com requireMention: true, um clipe de áudio sem legenda pode atender à restrição ao pronunciar um padrão de menção configurado (agents.list[].groupChat.mentionPatterns, usando messages.groupChat.mentionPatterns como fallback). O OpenClaw autoriza o remetente antes de baixar ou transcrever o clipe e só o admite quando a transcrição corresponde ao padrão. Uma transcrição especulativa com falha ou sem correspondência é descartada junto com o clipe baixado; ela não é mantida no histórico do canal. A identidade nativa @bot do Slack não pode ser inferida pela fala; portanto, configure um padrão de nome falado ou inclua uma menção digitada. Se a repetição da transcrição estiver habilitada, ela só será enviada após a admissão.

Mídia, divisão em blocos e entrega

Comandos e comportamento de comandos de barra

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

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

/openclaw /help

Os comandos nativos exigem configurações adicionais do manifesto no seu aplicativo Slack e, como alternativa, são habilitados com channels.slack.commands.native: true ou commands.native: true nas configurações globais.

• O modo automático de comandos nativos fica desativado no Slack, portanto commands.native: "auto" não habilita os comandos nativos do Slack.

/help

Os menus de argumentos nativos são renderizados de uma das seguintes formas, em ordem de prioridade:

• 3-5 opções suficientemente curtas: um menu de overflow ("...")
• mais de 100 opções, com filtragem assíncrona disponível: seleção externa
• 1-2 opções ou qualquer opção cujo valor codificado seja longo demais para uma seleção: blocos de botões
• caso contrário (6-100 opções ou mais de 100 sem filtragem assíncrona): menu de seleção estática, dividido em 100 opções por menu

/think

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

Gráficos nativos

O bloco público data_visualization do Block Kit do Slack renderiza gráficos de linhas, barras, áreas e pizza nas mensagens. O OpenClaw mapeia o bloco chart de presentation portátil para esse formato nativo; nenhum escopo OAuth adicional, upload de arquivo, renderizador de imagens ou configuração do Slack é necessário além do acesso normal chat:write para mensagens.

{  "blocks": [    {      "type": "chart",      "chartType": "bar",      "title": "Receita trimestral",      "categories": ["1º tri", "2º tri"],      "series": [{ "name": "Receita", "values": [120, 145] }],      "xLabel": "Trimestre"    }  ]}

Os limites do Slack são aplicados antes da renderização nativa:

• título e rótulos opcionais dos eixos: 50 caracteres
• pizza: 1-12 segmentos positivos
• linha/barra/área: 1-12 séries com nomes exclusivos e 1-20 categorias compartilhadas
• rótulos de segmentos, categorias e séries: 20 caracteres
• cada série deve conter um valor finito para cada categoria; valores que não sejam de gráficos de pizza podem ser negativos

Cada gráfico nativo também inclui uma representação textual no nível superior para leitores de tela, notificações, espelhamento de sessões e clientes que não conseguem renderizar o bloco. Envios de apresentação padrão para outros canais do OpenClaw recebem os mesmos dados determinísticos do gráfico como texto, a menos que anunciem suporte nativo a gráficos. Se o Slack rejeitar o gráfico com invalid_blocks durante uma implantação gradual, o OpenClaw remove os blocos de dados nativos rejeitados, mantém os controles adjacentes e envia a representação completa do gráfico como texto visível.

Atualmente, o Slack aceita até dois blocos data_visualization por mensagem. Quando uma apresentação contém mais de dois gráficos válidos, o OpenClaw mantém a ordem e continua a renderização nativa em mensagens de acompanhamento, com no máximo dois gráficos em cada mensagem.

O lançamento para desenvolvedores do Slack documenta o bloco como um recurso do Block Kit voltado a aplicativos e não publica nenhuma restrição de plano pago. A linguagem de elegibilidade para Business+/Enterprise se aplica à geração automática de gráficos por IA do Slackbot, que é separada do envio, por um aplicativo, de um gráfico já estruturado do Block Kit. Os gráficos são blocos exclusivos de mensagens, não conteúdo do App Home, de modais ou do Canvas.

Tabelas nativas

O bloco atual data_table do Block Kit do Slack renderiza linhas e colunas estruturadas nas mensagens. O OpenClaw mapeia um bloco explícito e portátil table de presentation para data_table; ele não usa o bloco table legado do Slack. Nenhum escopo OAuth adicional nem configuração do Slack é necessário além do acesso normal chat:write para mensagens.

{  "blocks": [    {      "type": "table",      "caption": "Pipeline aberto",      "headers": ["Conta", "Etapa", "ARR"],      "rows": [        ["Acme", "Ganho", 125000],        ["Globex", "Revisão", 82000]      ],      "rowHeaderColumnIndex": 0    }  ]}

O OpenClaw mapeia cabeçalhos e células de strings para células raw_text do Slack. Células numéricas são mapeadas para raw_number, preservando o valor numérico finito para classificação e filtragem nativas. rowHeaderColumnIndex, quando presente, marca essa coluna de índice zero como cabeçalhos de linha do Slack.

Os limites publicados pelo Slack para data_table são aplicados antes da renderização nativa:

• 1-20 colunas
• 1-100 linhas de dados, além da linha de cabeçalho
• o mesmo número de células em cada linha
• no máximo 10.000 caracteres agregados em todas as células das tabelas de uma mensagem

Vários blocos de tabela válidos podem ser renderizados nativamente enquanto a mensagem permanecer dentro do limite agregado de caracteres. Uma tabela que não puder ser renderizada dentro do limite nativo se tornará um texto determinístico completo, em vez de perder linhas ou células. Se esse texto exceder uma mensagem do Slack, os envios e as respostas aos comandos de barra usam blocos de texto ordenados. As edições de tabelas falham com um erro de tamanho explícito, em vez de truncar silenciosamente linhas de uma mensagem existente.

Cada tabela nativa produzida por uma apresentação portátil também inclui uma representação textual no nível superior para leitores de tela, notificações, espelhamento de sessões e clientes que não conseguem renderizar o bloco. Os valores brutos de gráficos e tabelas permanecem literais no fallback, portanto dados de células como <@U123> não se tornam uma menção do Slack. Se o Slack rejeitar blocos nativos de gráficos ou tabelas com invalid_blocks, o OpenClaw remove todos os blocos de dados nativos em uma única etapa de recuperação limitada, mantém blocos adjacentes válidos, como botões e seleções, e envia o texto completo e visível dos gráficos e tabelas com a formatação do Slack desabilitada. A entrega de comandos de barra controla o orçamento de cinco chamadas de response_url do Slack durante todo o comando. Antes de cada lote de respostas, ela seleciona um plano completo que cabe nas chamadas restantes ou falha antes de publicar esse lote.

Somente blocos de tabela presentation explícitos são promovidos a tabelas nativas. Tabelas Markdown com barras verticais continuam sendo texto criado pelo autor; o OpenClaw não tenta inferir a estrutura da tabela nem os tipos das células. Produtores nativos confiáveis existentes do Slack podem continuar a passar blocos brutos por channelData.slack.blocks; o OpenClaw deriva o texto de fallback de células data_table brutas válidas, enquanto blocos personalizados malformados podem ser reduzidos à legenda ou ao fallback geral do Block Kit. Saídas portáteis de agentes, da CLI e de plugins devem usar presentation.

Respostas interativas

O Slack pode renderizar controles de resposta interativos criados por agentes, mas esse recurso está desabilitado por padrão. Para novas saídas de agentes, da CLI e de plugins, prefira os botões ou blocos de seleção compartilhados de presentation. Eles usam o mesmo caminho de interação do Slack e também se adaptam 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 no Block Kit do Slack e encaminham cliques ou seleções pelo caminho existente de eventos de interação do Slack. Mantenha-as para prompts antigos e alternativas específicas do Slack; use a apresentação compartilhada para novos controles portáteis.

As APIs do compilador de diretivas também estão obsoletas para novos códigos produtores:

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

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

Observações:

• Esta é uma interface legada específica do Slack. Outros canais não convertem diretivas do Block Kit do Slack em seus próprios sistemas de botões.
• Os valores dos callbacks interativos são tokens opacos gerados pelo OpenClaw, não valores brutos criados pelo agente.
• Se os blocos interativos gerados excederem os limites do Block Kit do Slack, o OpenClaw usa como fallback 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 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, os inputs normalizados e o objeto stateValues bruto completo do Slack. O roteamento apenas por ID de callback é 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 precisar produzir um evento de sistema visível ao agente. O agente recebe um evento de sistema Slack interaction: ... compacto e com dados confidenciais removidos. 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 o 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 e interações, em vez de usar como fallback a interface Web ou o terminal.

• Aprovações de execução e de plugins podem ser renderizadas como solicitações nativas do Block Kit do Slack.
• channels.slack.execApprovals.* continua sendo a configuração de habilitação e roteamento para mensagens diretas/canais do cliente nativo de aprovação de execução.
• As mensagens diretas de aprovação de execução usam channels.slack.execApprovals.approvers ou commands.ownerAllowFrom.
• As aprovações de plugins 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 é roteado para a sessão de origem do Slack ou para um destino do Slack.
• As mensagens diretas de aprovação de plugins usam os aprovadores de plugins do Slack definidos em channels.slack.allowFrom, no allowFrom da conta nomeada ou na rota padrão da conta.
• A autorização do aprovador continua sendo aplicada: aprovadores exclusivos de execução não podem aprovar solicitações de plugins, a menos que também sejam aprovadores de plugins.

Isso usa a mesma superfície compartilhada de botões de aprovação que outros canais. Quando interactivity está habilitada nas configurações do seu aplicativo Slack, as solicitações de aprovação são renderizadas como botões do Block Kit diretamente na conversa. Quando esses botões estão presentes, eles são a UX de aprovação principal; o OpenClaw só deve incluir um comando manual /approve quando o resultado da ferramenta indicar que as aprovações pelo 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 as 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 processar aprovações nativas de Plugin por esse caminho de cliente nativo quando os 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 nativo de aprovação. Defina enabled: true para forçar a ativação das aprovações nativas quando os aprovadores forem resolvidos. Desabilitar as aprovações de execução do Slack não desabilita a entrega de aprovações nativas de Plugin no Slack habilitada por meio de approvals.plugin; a entrega de aprovações de Plugin usa os aprovadores de Plugin do Slack.

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

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

A configuração nativa do Slack só é necessária quando você deseja substituir os aprovadores, adicionar filtros ou habilitar a 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 as solicitações de aprovação de execução também precisarem ser encaminhadas para outros chats ou destinos explícitos fora da banda. O encaminhamento compartilhado de approvals.plugin também é separado; a entrega nativa do Slack só suprime esse fallback quando o Slack pode processar a solicitação de aprovação de Plugin nativamente.

O /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 conhecer o modelo completo de encaminhamento de aprovações.

Eventos e comportamento operacional

• Edições e exclusões de mensagens são mapeadas para eventos do sistema.
• Transmissões de threads (respostas de thread com "Also send to channel") são processadas como mensagens normais de usuário.
• Eventos de adição e remoção de reações são mapeados para eventos do sistema.
• Entrada e saída de membros, criação e renomeação de canais e eventos de adição e remoção de itens fixados são mapeados para eventos do sistema.
• channel_id_changed pode migrar chaves de configuração de canais quando configWrites está habilitado.
• Os metadados de tópico/finalidade do canal são tratados como contexto não confiável e podem ser injetados no contexto de roteamento.
• A mensagem inicial da thread e a propagação do contexto do histórico inicial da thread são filtradas pelas listas configuradas de remetentes permitidos, quando aplicável.
• Ações de blocos, atalhos e interações com modais emitem eventos estruturados de sistema Slack interaction: ... com campos de payload detalhados:
  • ações de blocos: 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 mensagens: contexto do callback, ator, canal, thread e mensagem selecionada
  • eventos modais view_submission e view_closed com metadados do canal roteado e entradas de formulário

Defina atalhos globais ou de mensagens na configuração do seu aplicativo Slack e use qualquer ID de callback que não esteja vazio. O OpenClaw confirma o recebimento de payloads de atalhos correspondentes, aplica a mesma política de remetente de DM/canal usada por outras interações do Slack e enfileira o evento sanitizado para a sessão do agente roteada. IDs de acionamento e URLs de resposta são removidos 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 mídia dos anexos

O Slack pode anexar mídias baixadas ao turno do agente quando os downloads de arquivos do Slack são bem-sucedidos e os limites de tamanho permitem. Clipes de áudio podem ser transcritos, arquivos de imagem podem passar pelo caminho de compreensão de mídia ou diretamente para um modelo de resposta com recursos de visão, e outros arquivos permanecem disponíveis como contexto de arquivo para download.

Tipos de mídia compatíveis

Pipeline de entrada

Quando chega uma mensagem do Slack com arquivos anexados:

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 quando o download é bem-sucedido.
3. Os caminhos e tipos de conteúdo das mídias baixadas são adicionados ao contexto de entrada.
4. Os clipes de áudio são encaminhados ao pipeline compartilhado de transcrição; os caminhos de modelos e ferramentas compatíveis com imagens podem usar anexos de imagem do mesmo contexto.
5. Outros arquivos permanecem disponíveis como metadados de arquivo ou referências de mídia para ferramentas capazes de processá-los.

Herança de anexos da mensagem raiz da thread

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

• Se a própria resposta não tiver mídia direta e a mensagem raiz incluída tiver arquivos, o Slack poderá carregar os arquivos da raiz como contexto de início da thread.
• Os arquivos da raiz são carregados somente durante a inicialização de uma sessão de thread nova ou redefinida. Respostas posteriores contendo apenas texto reutilizam o contexto da sessão existente e não anexam novamente os arquivos da raiz como novas mídias.
• Os anexos diretos da resposta têm precedência sobre os anexos da mensagem raiz.
• Uma mensagem raiz que tenha apenas arquivos e nenhum texto é representada por um espaço reservado de anexo para que o fallback ainda possa incluir seus arquivos.

Processamento de vários anexos

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

• Cada anexo é processado de forma independente pelo pipeline de mídia.
• As referências das mídias baixadas 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 demais.

Limites de tamanho, download e modelo

• Limite de tamanho: 20 MB por arquivo por padrão. Configurável por meio de channels.slack.mediaMaxMb.
• Limite de transcrição de áudio: tools.media.audio.maxBytes também se aplica quando o arquivo baixado é enviado a um provedor de transcrição ou à CLI.
• Falhas de download: Arquivos que o Slack não consegue fornecer, URLs expiradas, arquivos inacessíveis, arquivos acima do limite de tamanho e respostas HTML de autenticação/login do Slack são ignorados em vez de serem informados como formatos incompatíveis.
• Modelo de visão: A análise de imagens usa o modelo de resposta ativo quando ele é compatível com visão ou o modelo de imagem configurado em agents.defaults.imageModel.

Limitações conhecidas

Documentação relacionada

• Pipeline de compreensão de mídia
• Áudio e mensagens de voz
• Ferramenta de PDF

Relacionados