Skill Slack para OpenClaw

Visão geral do skill Slack para OpenClaw

O skill Slack conecta o OpenClaw ao seu workspace do Slack, permitindo que seu agente de IA envie mensagens, gerencie reações, fixe itens e leia conversas — tudo por meio de comandos em linguagem natural. Em vez de alternar entre seu terminal e o Slack, você pode pedir ao OpenClaw para lidar com tarefas rotineiras de mensagens em segundos.

O Slack é uma das plataformas de comunicação em equipe mais utilizadas, e sua integração com o OpenClaw desbloqueia fluxos de trabalho automatizados poderosos. Seja para postar notificações de deploy, reagir a mensagens ou fixar decisões importantes, o skill Slack do OpenClaw transforma operações de múltiplas etapas em conversas simples.

Fluxo de trabalho típico:

1. Peça ao OpenClaw para enviar uma atualização de deploy no canal #releases.
2. O agente chama a API do Slack via o token de bot configurado.
3. A mensagem é postada instantaneamente — sem necessidade de trocar de contexto.

O skill suporta dois modos de conexão: Socket Mode (recomendado para desenvolvimento e equipes pequenas) e HTTP Events API (melhor para deploys em produção atrás de um firewall). Ambos os modos usam o mesmo token de bot e fornecem funcionalidades idênticas.

Pré-requisitos para o skill Slack

Antes de instalar o skill Slack, certifique-se de ter:

• OpenClaw instalado e em execução (v1.0+)
• Um workspace do Slack onde você tenha permissão para instalar aplicativos
• Um aplicativo Slack criado em api.slack.com/apps com os escopos OAuth necessários
• clawhub CLI instalado para gerenciamento de skills — instalar com clawhub

Escopos OAuth necessários (Bot Token)

Ao criar seu aplicativo Slack, adicione estes escopos de bot token:

| Escopo | Finalidade | |--------|-----------| | chat:write | Enviar e editar mensagens | | channels:history | Ler histórico de mensagens do canal | | channels:read | Listar e ver informações do canal | | im:history | Ler histórico de mensagens diretas | | im:write | Enviar mensagens diretas | | reactions:read | Listar reações em mensagens | | reactions:write | Adicionar reações de emoji | | pins:read | Listar itens fixados | | pins:write | Fixar e desafixar mensagens | | emoji:read | Acessar lista de emojis personalizados | | app_mentions:read | Responder a @menções |

Opcional: adicione chat:write.customize para personalizar o nome de exibição do bot por mensagem, ou files:read e files:write para operações com arquivos.

Verifique sua configuração:

# Verificar versão do OpenClaw
openclaw --version

# Verificar se o clawhub está instalado
clawhub --version

Como instalar o skill Slack

Instale o skill Slack com um único comando:

npx clawhub@latest install slack

Para verificar a instalação:

clawhub list

Você deve ver slack na lista de skills instalados. O skill é publicado por steipete no ClawHub e recebe atualizações regulares.

Configuração do skill Slack

O skill Slack requer um Bot Token e, para o Socket Mode, um App Token. O OpenClaw lê esses tokens automaticamente das variáveis de ambiente.

Configuração do ambiente

# Obrigatório: Bot Token (começa com xoxb-)
export SLACK_BOT_TOKEN=xoxb-your-bot-token-here

# Obrigatório para Socket Mode (começa com xapp-)
export SLACK_APP_TOKEN=xapp-your-app-token-here

Importante: Nunca codifique tokens diretamente em arquivos de configuração. Use variáveis de ambiente ou um gerenciador de segredos como 1Password ou Bitwarden.

Modos de conexão

Socket Mode (padrão):

• Requer SLACK_BOT_TOKEN e SLACK_APP_TOKEN
• Nenhuma URL pública necessária — ideal para desenvolvimento local
• Inicie com openclaw gateway

HTTP Events API:

• Requer SLACK_BOT_TOKEN e um Signing Secret
• Configure um endpoint webhook (padrão: /slack/events)
• Melhor para ambientes de produção atrás de um proxy reverso

Controle de acesso

O OpenClaw fornece controle de acesso granular para interações do Slack:

• Política de DM: pairing (padrão), allowlist, open ou disabled
• Política de canal: open, allowlist ou disabled
• Menção obrigatória: Canais exigem menção @bot por padrão

Para ambientes de equipe, a política de DM pairing é recomendada. Os usuários devem executar openclaw pairing approve slack <code> antes que o bot responda a seus DMs. Consulte a lista de verificação de segurança para dicas adicionais de hardening.

Exemplos de uso do skill Slack

1. Postar uma notificação de deploy

Você: "Envie uma mensagem no #releases dizendo que a versão 2.4.0 foi implantada em produção sem tempo de inatividade."

O agente chama sendMessage com o canal de destino e o conteúdo da mensagem. A notificação aparece instantaneamente no canal com a identidade do bot.

2. Reagir a uma decisão da equipe

Você: "Adicione uma reação de marca de verificação à última mensagem em #engineering-decisions."

O agente lê a mensagem mais recente no canal especificado usando readMessages, depois aplica uma reação ✅ via react. Ótimo para confirmar decisões ou marcar tarefas como revisadas.

3. Fixar uma atualização importante

Você: "Fixe a mensagem sobre o roadmap do Q1 em #product."

O agente pesquisa nas mensagens recentes por conteúdo correspondente a "roadmap do Q1", depois usa pinMessage para fixá-la. Itens fixados permanecem acessíveis no topo do canal para toda a equipe.

4. Ler e resumir atividade do canal

Você: "Resuma o que aconteceu hoje em #support."

O agente usa readMessages para buscar as mensagens do dia, depois analisa e resume os tópicos principais, perguntas e resoluções. Funciona bem com o skill Summarize para conversas mais longas.

Segurança e melhores práticas

O skill Slack pode enviar mensagens e modificar conteúdo no seu workspace. Siga estas diretrizes para manter a segurança:

• Use o mínimo privilégio. Conceda apenas os escopos OAuth que você realmente precisa. Se só precisa ler canais, pule chat:write e pins:write.
• Ative o modo pairing. A política de DM pairing padrão impede que usuários não autorizados interajam com o bot em mensagens diretas.
• Revise antes de enviar. O OpenClaw solicita confirmação antes de enviar mensagens por padrão. Não desative essa função em workspaces de produção.
• Limite o acesso a canais. Use a política de canal allowlist para restringir o bot a canais específicos em vez de conceder acesso a todo o workspace.
• Faça rotação dos tokens regularmente. Regenere seu bot token periodicamente e revogue tokens não utilizados na página de gerenciamento de aplicativos Slack.
• Audite a atividade de mensagens. Verifique os logs de auditoria do seu workspace Slack para revisar mensagens enviadas pelo bot.

Resolução de erros comuns do skill Slack

"not_authed" ou "invalid_auth"

Seu bot token está ausente ou inválido.

# Verificar se o token está definido
echo $SLACK_BOT_TOKEN

# Re-exportar se necessário
export SLACK_BOT_TOKEN=xoxb-your-new-token

Se o token foi regenerado recentemente, certifique-se de atualizá-lo em todos os ambientes onde é usado.

"channel_not_found"

O bot não consegue acessar o canal especificado. Isso geralmente significa:

1. O bot não foi convidado para o canal — digite /invite @your-bot-name no canal.
2. O ID do canal está incorreto — use a API do Slack ou o menu de contexto do canal para obter o ID correto.
3. O canal é privado e o bot não tem o escopo groups:read.

"missing_scope"

O bot token está sem um escopo OAuth necessário.

1. Vá para api.slack.com/apps → seu aplicativo → OAuth & Permissions.
2. Adicione o escopo ausente indicado na mensagem de erro.
3. Reinstale o aplicativo no seu workspace para aplicar os novos escopos.