​

Slack

​

Configuração rápida

{
  channels: {
    slack: {
      enabled: true,
      mode: "socket",
      appToken: "xapp-...",
      botToken: "xoxb-...",
    },
  },
}

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

openclaw gateway

{
  channels: {
    slack: {
      enabled: true,
      mode: "http",
      botToken: "xoxb-...",
      signingSecret: "your-signing-secret",
      webhookPath: "/slack/events",
    },
  },
}

​

Checklist de manifesto e escopo

{
  "display_information": {
    "name": "OpenClaw",
    "description": "Slack connector for OpenClaw"
  },
  "features": {
    "bot_user": {
      "display_name": "OpenClaw",
      "always_online": true
    },
    "app_home": {
      "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",
        "users:read"
      ]
    }
  },
  "settings": {
    "socket_mode_enabled": true,
    "event_subscriptions": {
      "bot_events": [
        "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"
      ]
    }
  }
}

​

Modelo de token

• botToken + appToken são obrigatórios para Socket Mode.
• O modo HTTP exige botToken + signingSecret.
• botToken, appToken, signingSecret e userToken aceitam strings em texto simples ou objetos SecretRef.
• Os tokens na configuração substituem o fallback por variável de ambiente.
• O fallback por variável de ambiente SLACK_BOT_TOKEN / SLACK_APP_TOKEN se aplica somente à conta padrão.
• userToken (xoxp-...) é somente de configuração (sem fallback por variável de ambiente) e usa por padrão o comportamento somente leitura (userTokenReadOnly: true).
• Opcional: adicione chat:write.customize se quiser que as mensagens de saída usem a identidade do agente ativo (username e ícone personalizados). icon_emoji usa a sintaxe :emoji_name:.

• A inspeção da 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 meio de SecretRef ou outra fonte de segredo não inline, mas o caminho atual de comando/tempo de execução não conseguiu resolver o valor real.
• No modo HTTP, signingSecretStatus é incluído; em Socket Mode, o par obrigatório é botTokenStatus + appTokenStatus.

​

Ações e controles

​

Controle de acesso e roteamento

​

Threads, sessões e tags de resposta

• DMs são roteadas como direct; canais como channel; MPIMs como group.
• 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>.
• Respostas em thread podem criar sufixos de sessão de thread (:thread:<threadTs>) quando aplicável.
• 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 0 para desativar).

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

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

​

Reações de confirmação

• channels.slack.accounts.<accountId>.ackReaction
• channels.slack.ackReaction
• messages.ackReaction
• fallback para emoji da identidade do agente (agents.list[].identity.emoji, senão ”👀”)

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

​

Streaming de texto

• off: desativa o streaming de visualização ao vivo.
• partial (padrão): substitui o texto de visualização pela saída parcial mais recente.
• block: acrescenta atualizações de visualização em blocos.
• progress: mostra texto de status de progresso durante a geração e, em seguida, envia o texto final.

• Uma thread de resposta deve estar disponível para que o streaming de texto nativo apareça. A seleção de thread ainda segue replyToMode. Sem isso, a visualização normal de rascunho é usada.
• Mídia e cargas não textuais usam o fallback para entrega normal.
• Se o streaming falhar no meio da resposta, o OpenClaw usa o fallback para entrega normal das cargas restantes.

{
  channels: {
    slack: {
      streaming: "partial",
      nativeStreaming: false,
    },
  },
}

• channels.slack.streamMode (replace | status_final | append) é migrado automaticamente para channels.slack.streaming.
• booleano channels.slack.streaming é migrado automaticamente para channels.slack.nativeStreaming.

​

Fallback de reação de digitação

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

• O Slack espera shortcodes (por exemplo, "hourglass_flowing_sand").
• A reação é best-effort, e a limpeza é tentada automaticamente após a conclusão da resposta ou do caminho de falha.

​

Mídia, fragmentação e entrega

​

Comandos e comportamento de Slash

• O modo automático de comando nativo fica desativado para Slack (commands.native: "auto" não habilita comandos nativos do Slack).
• Habilite manipuladores de comando nativos do Slack com channels.slack.commands.native: true (ou global commands.native: true).
• Quando os comandos nativos estiverem habilitados, registre comandos Slash correspondentes no Slack (nomes /<command>), com uma exceção:
  • registre /agentstatus para o comando de status (o Slack reserva /status)
• Se os comandos nativos não estiverem habilitados, você poderá executar um único comando Slash configurado por meio de channels.slack.slashCommand.
• Os menus nativos de argumentos agora adaptam sua estratégia de renderização:
  • até 5 opções: blocos de botões
  • 6-100 opções: menu de seleção estática
  • mais de 100 opções: seleção externa com filtragem assíncrona de opções quando os handlers de opções de interatividade estiverem disponíveis
  • se valores de opção codificados excederem os limites do Slack, o fluxo usa o fallback para botões
• Para cargas longas de opções, os menus de argumento de comando Slash usam um diálogo de confirmação antes de despachar um valor selecionado.

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

• agent:<agentId>:slack:slash:<userId>

​

Respostas interativas

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

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

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

• Esta é uma interface específica do Slack. Outros canais não traduzem diretivas de 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 pelo agente.
• Se os blocos interativos gerados excederem os limites do Slack Block Kit, o OpenClaw usa o fallback para a resposta de texto original em vez de enviar uma carga inválida de blocos.

​

Aprovações de exec no Slack

• As aprovações de exec usam channels.slack.execApprovals.* para roteamento nativo em DM/canal.
• Aprovações de plugin ainda podem ser resolvidas pela mesma superfície nativa de botões do Slack quando a solicitação já cai no Slack e o tipo de id de aprovação é plugin:.
• A autorização do aprovador continua sendo aplicada: apenas usuários identificados como aprovadores podem aprovar ou negar solicitações pelo Slack.

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

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

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

​

Eventos e comportamento operacional

• Edições/exclusões de mensagem/transmissões de thread são mapeadas para eventos do sistema.
• Eventos de adicionar/remover reação são mapeados para eventos do sistema.
• Eventos de entrada/saída de membro, criação/renomeação de canal e adicionar/remover fixação são mapeados para eventos do sistema.
• channel_id_changed pode migrar chaves de configuração de canal quando configWrites estiver 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 inicial de contexto do histórico da thread são filtrados pelas listas de permissões de remetente configuradas quando aplicável.
• Ações de bloco e interações de modal emitem eventos estruturados do sistema Slack interaction: ... com campos de carga avançados:
  • ações de bloco: valores selecionados, rótulos, valores de seletor e metadados workflow_*
  • eventos de modal view_submission e view_closed com metadados de canal roteados e entradas de formulário

​

Ponteiros para a referência de configuração

• Configuration reference - Slack Campos de Slack de alto sinal:
  • modo/autenticação: mode, botToken, appToken, signingSecret, webhookPath, accounts.*
  • acesso a DM: dm.enabled, dmPolicy, allowFrom (legado: dm.policy, dm.allowFrom), dm.groupEnabled, dm.groupChannels
  • alternância de compatibilidade: dangerouslyAllowNameMatching (último recurso; mantenha desativado, a menos que seja necessário)
  • acesso a canal: groupPolicy, channels.*, channels.*.users, channels.*.requireMention
  • threading/histórico: replyToMode, replyToModeByChatType, thread.*, historyLimit, dmHistoryLimit, dms.*.historyLimit
  • entrega: textChunkLimit, chunkMode, mediaMaxMb, streaming, nativeStreaming
  • operações/recursos: configWrites, commands.native, slashCommand.*, actions.*, userToken, userTokenReadOnly

​

Solução de problemas

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

openclaw pairing list slack

​

Relacionado

• Pairing
• Groups
• Security
• Channel routing
• Troubleshooting
• Configuration
• Slash commands