🦞
Integracao de Canal

Conectar OpenClaw ao Slack

Adicione o OpenClaw ao seu workspace do Slack. Obtenha assistencia de IA em canais, threads ou DMs com suporte a comandos slash.

💼 Por que Usar o Slack?
  • ✓Conexao WebSocket — Mensagens em tempo real via Slack Bot API + Socket Mode
  • ✓Comandos Slash — Interface de comando /clawd nativa
  • ✓Suporte a Threads — Mantenha conversas organizadas com contexto de historico
  • ✓Formatacao Rica — Respostas formatadas com reacoes e pins
  • ✓Acesso Flexivel — DMs, canais publicos e canais privados
Requisitos
  • •Token de Bot do Slack — Comeca com xoxb-...
  • •Token de App do Slack — Comeca com xapp-... (para Socket Mode)
  • •App do Slack — Com escopos OAuth apropriados configurados

Passos de Configuracao

1

Criar um App do Slack

Acesse o portal de API do Slack e crie uma nova aplicacao:

  • • Acesse api.slack.com/apps
  • • Clique em "Create New App"
  • • Escolha "From scratch"
  • • De um nome (ex: "OpenClaw") e selecione seu workspace
2

Adicionar Escopos de Token do Bot

Configure permissoes OAuth para seu bot:

  • • Va para "OAuth & Permissions" na barra lateral
  • • Em "Bot Token Scopes", adicione:
  • - app_mentions:read — Ler mencoes
  • - channels:history — Ver mensagens do canal
  • - channels:read — Ver info do canal
  • - chat:write — Enviar mensagens
  • - im:history — Ver historico de DM
  • - im:read — Ver info de DM
  • - im:write — Iniciar conversas de DM
  • - reactions:write — Adicionar reacoes
  • - users:read — Ver info do usuario
3

Habilitar Socket Mode

Socket Mode permite comunicacao em tempo real sem uma URL publica:

  • • Va para "Socket Mode" na barra lateral
  • • Ative "Enable Socket Mode"
  • • Gere um App-Level Token com escopo connections:write
  • • Copie o token (comeca com xapp-...)
4

Instalar App no Workspace

Instale o app e obtenha seu Token de Bot:

  • • Va para "Install App" na barra lateral
  • • Clique em "Install to Workspace"
  • • Autorize as permissoes solicitadas
  • • Copie o Bot User OAuth Token (comeca com xoxb-...)
5

Configurar OpenClaw

Adicione a configuracao do Slack ao seu openclaw.json:

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

Convidar Bot para Canais

Adicione o bot aos canais onde voce quer que ele responda:

  • • Abra o canal no Slack
  • • Digite /invite @OpenClaw
  • • Ou clique no nome do canal -> Integracoes -> Adicionar apps
  • • Reinicie o OpenClaw com openclaw restart e teste mencionando o bot.
Recursos

Suporte a Threads

Mantem contexto de conversa dentro de threads com escopo de historico configuravel.

Reacoes com Emoji

Bot pode adicionar reacoes para reconhecer mensagens ou indicar status.

Fixar Mensagens

Fixe respostas importantes para referencia facil depois.

Comandos Slash

Use /clawd para consultas rapidas de IA de qualquer lugar.

Info do Membro

Consulte informacoes de membros do workspace quando necessario.

Suporte a DM

Conversas privadas um-a-um com o bot.

Configuracao Avancada

Opcoes completas de configuracao para integracao com Slack:

{
  "channels": {
    "slack": {
      "enabled": true,
      "botToken": "xoxb-...",
      "appToken": "xapp-...",
      "dm": {
        "enabled": true,
        "policy": "pairing",
        "allowFrom": ["U123", "U456"]
      },
      "channels": {
        "#general": {
          "allow": true,
          "requireMention": true,
          "users": ["U123"]
        }
      },
      "historyLimit": 50,
      "slashCommand": {
        "enabled": true,
        "name": "clawd"
      },
      "actions": {
        "reactions": true,
        "messages": true,
        "pins": true
      }
    }
  }
}
  • dm.enabled — Permitir mensagens diretas para o bot
  • dm.policy — Politica de acesso a DM ("pairing" ou "open")
  • dm.allowFrom — Array de IDs de usuarios permitidos a enviar DM
  • channels — Objeto de configuracao por canal
  • requireMention — Responder apenas quando @mencionado
  • historyLimit — Numero de mensagens a incluir para contexto
  • slashCommand — Configurar opcoes de comando slash
  • actions — Habilitar/desabilitar reacoes, mensagens e pins
Politicas de Canal

Modo Allowlist

Responder apenas em canais explicitamente configurados. Melhor para ambientes controlados.

Modo Aberto

Responder em todos os canais onde o bot e convidado. Use requireMention para controlar respostas.

Como Obter IDs de Usuario do Slack

Do Perfil:

Clique no nome do usuario -> Ver perfil -> Clique nos tres pontos (...) -> Copiar ID do membro

Do Admin do Slack:

Configuracoes do Workspace -> Gerenciar Membros -> Exportar lista de membros como CSV

⚠️ Solucao de Problemas

Bot nao responde em canais?

Certifique-se de que o bot foi convidado ao canal e tem os escopos corretos. Verifique se requireMention esta habilitado.

Erros de conexao Socket Mode?

Verifique se seu App Token (xapp-...) esta correto e tem o escopo connections:write.

Comando slash nao aparece?

Va para "Slash Commands" nas configuracoes do seu app Slack e crie o comando manualmente, apontando para Socket Mode.

Erros de permissao negada?

Reinstale o app no seu workspace apos adicionar novos escopos. Algumas mudancas de escopo requerem reinstalacao.

Slack Conectado!

Agora configure mais canais ou melhore seu bot com skills personalizadas.

Adicionar DiscordExplorar Skills