Integração com Discord

O Discord deixou de ser apenas uma plataforma para gamers e se tornou o hub de comunidades online mais versátil do mundo. Desenvolvedores, criadores de conteúdo, empresas e entusiastas organizam suas comunidades lá. Com o OpenClaw, você transforma seu servidor Discord em um ambiente inteligente e automatizado, com um bot que entende linguagem natural, gerencia o servidor e conecta com dezenas de outras ferramentas.

Diferente de bots simples baseados em comandos fixos, o OpenClaw usa inteligência artificial para compreender o contexto das conversas e executar ações complexas de forma natural.

O Que É Possível Fazer

• Responder perguntas em canais e DMs com base no contexto do seu servidor e documentos configurados
• Comandos slash personalizados — crie atalhos para ações frequentes da sua comunidade
• Moderação inteligente — detecte spam, toxicidade e gerencie comportamentos automaticamente
• Notificações cross-platform — receba alertas do GitHub, Twitch, YouTube e outros serviços diretamente em canais específicos
• Gerenciar cargos e permissões via conversa natural
• Criar eventos de game night, lives e reuniões da comunidade
• Responder em threads mantendo discussões organizadas
• Integrar com CI/CD — atualizações de deploy e build direto no canal de devs

Como Configurar

Passo 1: Criar o Bot no Developer Portal

1. Acesse o Discord Developer Portal
2. Clique em “New Application” e dê um nome ao seu bot
3. No menu lateral, vá em “Bot” e clique em “Add Bot”
4. Em “Privileged Gateway Intents”, ative:
   • Message Content Intent — para o bot ler o conteúdo das mensagens
   • Server Members Intent — para gerenciar membros
5. Clique em “Reset Token” e copie o token gerado (guarde em local seguro)

Passo 2: Convidar o Bot para seu Servidor

1. Ainda no Developer Portal, vá em “OAuth2 > URL Generator”
2. Em “Scopes”, selecione: bot e applications.commands
3. Em “Bot Permissions”, selecione as permissões necessárias:
   • Send Messages, Read Message History
   • Manage Messages (para moderação)
   • Manage Roles, Manage Channels (se quiser automação de servidor)
4. Copie a URL gerada e abra no navegador
5. Selecione o servidor onde deseja adicionar o bot e autorize

Passo 3: Conectar ao OpenClaw

openclaw channel add discord --token SEU_TOKEN_AQUI

Passo 4: Configurar Comportamento

channels:
  discord:
    enabled: true
    token: "SEU_TOKEN"
    prefix: "!"              # prefixo para comandos (opcional)
    mentionOnly: false       # responder apenas quando mencionado
    allowedChannels:         # limitar a canais específicos
      - "suporte"
      - "bot-commands"
    ignoredChannels:
      - "off-topic"
      - "memes"

Passo 5: Testar

No servidor Discord, envie uma mensagem no canal configurado ou mencione o bot:

@SeuBot qual é o objetivo desta comunidade?

Exemplos Práticos

1. Servidor de Desenvolvimento — Alertas de CI/CD

Configure o bot para postar no canal #dev-updates sempre que houver atividade no repositório:

Commits na branch main → poste resumo no #dev-updates
Quando CI falhar → alerte no #alertas-urgentes com detalhes do erro
Quando PR for aberto → notifique no #code-review com link e descrição

2. Comunidade de Jogos — Boas-vindas Automáticas

Quando alguém entrar no servidor:
- Envie mensagem de boas-vindas personalizada no #bem-vindos
- Explique as regras e canais principais
- Adicione o cargo "Novo Membro" automaticamente

3. Servidor Educacional — Suporte aos Alunos

Bot responde no canal #duvidas com base na documentação do curso
Encaminha para professores quando a dúvida é muito específica
Cria threads automáticas para manter discussões organizadas

4. Comunidade de Criadores — Curadoria de Conteúdo

Quando alguém compartilhar link de artigo em #links:
- Busque resumo do artigo
- Poste resumo em 3 bullets como resposta
- Adicione reação  automaticamente

5. Servidor Corporativo — Gestão de Projetos

Toda segunda-feira às 9h, poste no #equipe:
- Resumo das tarefas abertas no Jira
- PRs aguardando revisão no GitHub
- Agenda da semana do Google Calendar

Dicas Avançadas

Modo menção apenas: Para servidores grandes, configure o bot para responder somente quando for @mencionado, evitando interferir em conversas normais.

Cargos como controle de acesso: Use o sistema de cargos do Discord para definir quem pode pedir certas ações ao bot. Por exemplo, apenas membros com o cargo “Admin” podem criar canais via bot.

Threads para contexto: O Discord permite threads em canais. O OpenClaw mantém o contexto dentro de uma thread, ideal para conversas mais longas sem poluir o canal principal.

Webhooks para integrações externas: Configure webhooks no Discord para receber notificações de serviços externos sem precisar do bot ativo o tempo todo. Use isso com o GitHub para alertas de commit.

Slowmode em canais movimentados: Em canais com muita atividade, ative o slowmode para evitar spam e dar tempo ao bot de processar as mensagens adequadamente.

Consulte o glossário de termos para entender conceitos como webhooks, intents e tokens de API.

FAQ

O bot pode responder em múltiplos servidores ao mesmo tempo? Sim. Um único bot do Discord pode estar em vários servidores simultaneamente. As configurações podem ser diferentes para cada servidor.

Há risco de o bot ser banido do Discord? Desde que você siga os Termos de Serviço do Discord e não use o bot para spam ou comportamentos abusivos, não há risco. Bots que simulam usuários humanos (selfbots) são proibidos — o OpenClaw usa a API oficial de bots.

O bot pode falar por voz nos canais de voz? Atualmente o OpenClaw foca em mensagens de texto. Integração com canais de voz requer bibliotecas adicionais e está no roadmap.

Como impedir que o bot responda a outros bots? Configure ignoreBotsMessages: true nas configurações do canal Discord. O OpenClaw ignorará automaticamente mensagens de outros bots.

Posso limitar o bot a certos cargos? Sim. Use as configurações allowedRoles e blockedRoles para definir quais cargos podem interagir com o bot.

Próximos Passos

• Canais suportados pelo OpenClaw — veja todos os canais disponíveis
• Integração com GitHub — notificações de repositório no Discord
• Como usar o OpenClaw — guia completo de configuração
• Guias de automação para comunidades — receitas prontas para servidores Discord
• Blog — dicas de bots para Discord — artigos e tutoriais

Próximo: Notion