Discord com IA fica mais útil quando deixa de ser apenas um bot respondendo perguntas soltas e vira uma mesa operacional para comunidade, suporte, equipe técnica ou produto digital. Em servidores ativos, muita coisa importante nasce em canais e threads: dúvidas repetidas, pedidos de suporte, incidentes pequenos, feedback de usuários, decisões de moderação, links úteis e mensagens que deveriam virar tarefa. O problema é que o Discord também é rápido demais. Uma conversa boa some no histórico, um alerta fica enterrado e uma ação sensível pode ser tomada sem contexto.

O OpenClaw ajuda a transformar esse fluxo em rotina verificável. Ele pode ler canais permitidos, resumir threads, responder perguntas frequentes, preparar mensagens, acionar skills e pedir aprovação antes de publicar algo sensível. A diferença para um bot tradicional é que o agente não depende apenas de comandos rígidos: ele entende contexto, conversa em linguagem natural e pode cruzar Discord com GitHub, documentação, calendário, CRM, arquivos ou alertas externos.

Este guia mostra como configurar um bot Discord com OpenClaw sem perder controle humano. O caminho recomendado é começar com leitura e resumo, depois liberar respostas em canais específicos, depois criar rotinas recorrentes e só então permitir ações mais fortes, sempre com políticas de aprovação claras. Se você está comparando canais de equipe, leia também os guias de Slack com IA e Microsoft Teams com IA. O padrão é o mesmo: o agente observa, organiza e sugere; ações que afetam cliente, reputação, produção, dinheiro ou dados precisam de confirmação.

Por que usar OpenClaw no Discord?

Diferente de bots tradicionais que seguem scripts rígidos, um bot OpenClaw no Discord:

  • Entende contexto: Lembra conversas anteriores e mantém coerência
  • Responde naturalmente: Usa linguagem humana, não respostas enlatadas
  • Executa ações: Pode pesquisar na web, gerar imagens, criar arquivos
  • Aprende com você: Adapta-se ao seu estilo através dos arquivos SOUL.md e AGENTS.md
  • Funciona 24/7: Responde mesmo quando você está offline

Casos de uso populares:

  • Suporte técnico em servidores de projetos open source
  • Moderação inteligente de comunidades
  • Assistente para estudos em grupos de estudo
  • Bot de informações para servidores de jogos
  • Automação de tarefas administrativas

Discord como painel de comunidade, não só chat

O melhor primeiro uso do Discord com IA é organizar o que já acontece no servidor. Em vez de pedir para o bot “fazer tudo”, escolha um canal, um tipo de mensagem e uma saída esperada. Isso reduz risco e facilita medir se o OpenClaw está ajudando de verdade.

Um primeiro comando seguro:

@OpenClaw resuma as threads dos canais #suporte e #bugs nas últimas 24 horas. Separe em dúvidas resolvidas, bugs prováveis, perguntas sem resposta e itens que precisam de aprovação humana. Não publique em outros canais.

Esse comando é bom porque define fonte, período, formato e limite. Ele não promete moderação automática, não apaga mensagens e não responde em nome da equipe. Depois que o resumo estiver confiável, você pode evoluir para rascunhos:

@OpenClaw prepare uma resposta para esta dúvida usando a documentação do projeto. Explique em português simples, inclua o link da seção relevante e aguarde minha aprovação antes de publicar.

Para comunidades técnicas, esse fluxo economiza tempo sem transformar o agente em autoridade final. O OpenClaw encontra contexto e prepara a resposta. A equipe decide se publica, ajusta ou cancela.

Um desenho prático tem quatro peças:

  • Discord como painel de comunidade, suporte ou equipe.
  • OpenClaw como agente que lê, resume, rascunha e executa rotinas autorizadas.
  • Fontes externas como GitHub, documentação, roadmap, CRM ou base de conhecimento.
  • Política de aprovação para limitar moderação, mensagens oficiais e ações externas.

Esse desenho também combina com o uso de madrugada. O agente pode revisar tickets, mensagens e alertas enquanto a equipe dorme, mas entregar um recibo pela manhã: o que foi respondido automaticamente, o que ficou em rascunho, o que precisa de humano e qual canal está com mais ruído. É a lógica do Diário Noturno aplicada a servidor de comunidade.

Política de aprovação para Discord

Discord tem uma armadilha: como a conversa é informal, é fácil liberar permissões demais “só para testar”. Para um bot de IA, isso é ruim. O ideal é escrever uma política simples antes de conectar o OpenClaw a canais movimentados.

Uma política inicial pode ser:

Tipo de açãoO agente pode fazer sozinho?Aprovação necessária
Resumir threads públicasSimNão
Responder FAQ em canal de testeSim, com escopo limitadoNão
Publicar anúncio oficialNãoSim
Apagar mensagemNãoSim
Banir, silenciar ou advertir usuárioNãoSim
Abrir issue no GitHubComo rascunhoSim
Enviar DM para membroNãoSim

Essa tabela não precisa ser perfeita no primeiro dia. Ela precisa ser explícita. O risco não é só técnico; é reputacional. Um bot que responde rápido demais em canal público pode parecer spam, criar conflito com membros ou publicar algo que deveria ter ficado como rascunho.

Comece com três zonas:

  1. Canais de leitura: o OpenClaw lê e resume, mas não publica.
  2. Canais de teste: o OpenClaw responde com escopo limitado para administradores.
  3. Canais públicos: o OpenClaw só publica depois de aprovação ou em FAQs muito bem delimitadas.

Se o bot ficar mudo depois dessa configuração, pode não ser erro. Pode ser a política funcionando. O guia OpenClaw não responde mostra como diferenciar falha real de canal, modelo, permissão ou aprovação pendente.

Pré-requisitos

Antes de começar, você precisa:

  1. OpenClaw instalado e funcionando (veja nosso guia de instalação)
  2. Uma conta Discord
  3. Acesso ao Discord Developer Portal
  4. Um servidor Discord onde você seja administrador (ou crie um novo para testes)

Passo 1: Criar a Aplicação no Discord Developer Portal

1.1 Acessar o Portal

Acesse discord.com/developers/applications e faça login com sua conta Discord.

1.2 Criar Nova Aplicação

Clique em New Application no canto superior direito.

Dê um nome para sua aplicação (por exemplo, “Meu Assistente IA” ou o nome do seu agente). Este nome aparecerá nos convites, mas pode ser diferente do nome do bot.

1.3 Criar o Bot

No menu lateral, clique em Bot.

Clique em Add Bot e confirme.

Agora você tem um bot! Personalize:

  • Username: Nome que aparece no Discord
  • Icon: Avatar do bot (opcional, mas recomendado)

1.4 Copiar o Token

Na seção Bot, clique em Reset Token (ou Copy se o token estiver visível).

⚠ IMPORTANTE: Este token é como uma senha. Nunca compartilhe publicamente, não commite em repositórios Git, não cole em chats.

Guarde o token em local seguro — você precisará dele na configuração.

1.5 Habilitar Intents

Ainda na página do Bot, role até Privileged Gateway Intents e habilite:

  • Message Content Intent — Obrigatório para ler mensagens
  • Server Members Intent — Recomendado para allowlists e menções

Clique em Save Changes.

Sem o Message Content Intent, o bot conectará mas não conseguirá ler o conteúdo das mensagens.

Passo 2: Gerar URL de Convite

2.1 Configurar OAuth2

No menu lateral, vá em OAuth2URL Generator.

Em Scopes, marque:

  • bot
  • applications.commands (necessário para comandos slash)

2.2 Definir Permissões

Em Bot Permissions, marque as permissões mínimas necessárias:

Essenciais:

  • ✅ View Channels
  • ✅ Send Messages
  • ✅ Read Message History
  • ✅ Embed Links
  • ✅ Attach Files

Recomendadas:

  • ✅ Add Reactions
  • ✅ Use External Emojis

Evite marcar Administrator — é excessivo e representa risco de segurança.

2.3 Copiar URL e Convidar

Copie a URL gerada no final da página.

Abra essa URL em uma nova aba, selecione o servidor onde quer adicionar o bot e autorize.

O bot agora aparece na lista de membros do servidor (provavelmente offline).

Passo 3: Obter IDs do Discord

O OpenClaw usa IDs numéricos para identificar servidores, canais e usuários. Veja como obter:

3.1 Habilitar Modo Desenvolvedor

  1. Discord → Configurações do Usuário (ícone de engrenagem)
  2. Avançado → Ative Modo Desenvolvedor

3.2 Copiar IDs

Com o Modo Desenvolvedor ativo, clique com botão direito em:

  • Nome do servidor → Copiar ID do Servidor (Guild ID)
  • Canal (ex: #geral) → Copiar ID do Canal
  • Usuário → Copiar ID do Usuário

Anote esses IDs — você usará na configuração.

Passo 4: Configurar OpenClaw

4.1 Configuração Básica

Adicione ao seu config.json5:

{
  channels: {
    discord: {
      enabled: true,
      token: "SEU_TOKEN_AQUI",
    },
  },
}

Alternativa via variável de ambiente (recomendado para produção):

export DISCORD_BOT_TOKEN="seu_token_aqui"

4.2 Configuração Completa

Para controle total, use esta configuração expandida:

{
  channels: {
    discord: {
      enabled: true,
      // Token via env var DISCORD_BOT_TOKEN ou aqui
      // token: "...",
      
      // Política de canais de servidor
      groupPolicy: "allowlist",
      
      // Configurações de DM
      dm: {
        enabled: true,
        policy: "pairing", // pairing | allowlist | open
        allowFrom: ["SEU_USER_ID"],
      },
      
      // Configurações por servidor
      guilds: {
        "SEU_GUILD_ID": {
          slug: "meu-servidor",
          requireMention: true, // Só responde se mencionado
          users: ["SEU_USER_ID"], // Allowlist de usuários
          channels: {
            "CHANNEL_ID_GERAL": {
              allow: true,
              requireMention: true,
            },
            "CHANNEL_ID_AJUDA": {
              allow: true,
              requireMention: false, // Responde a tudo
              systemPrompt: "Seja conciso e técnico.",
            },
          },
        },
      },
      
      // Ações permitidas
      actions: {
        reactions: true,
        polls: true,
        messages: true,
        threads: true,
      },
    },
  },
}

4.3 Explicação das Opções

dm.policy:

  • pairing: Novos usuários recebem código de pareamento (mais seguro)
  • allowlist: Apenas usuários em allowFrom podem usar
  • open: Qualquer um pode usar (cuidado!)

requireMention:

  • true: Bot só responde quando @mencionado
  • false: Bot responde a todas as mensagens no canal

groupPolicy:

  • allowlist: Apenas canais listados em guilds
  • open: Todos os canais (perigoso em servidores grandes)
  • disabled: Ignora todos os canais de servidor

Passo 5: Iniciar e Testar

5.1 Reiniciar OpenClaw

openclaw gateway restart

Ou se estiver usando systemd:

sudo systemctl restart openclaw

5.2 Verificar Conexão

openclaw channels status

Deve mostrar:

discord: connected
  - Guilds: 1
  - DM policy: pairing

5.3 Testar no Discord

No canal configurado, envie:

@SeuBot olá, como você está?

Se configurou requireMention: false, qualquer mensagem funcionará.

Recursos Avançados

Comandos Slash Nativos

OpenClaw registra automaticamente comandos slash no Discord:

  • /status — Ver status do bot
  • /help — Lista de comandos
  • /config — Configurações (se habilitado)

Reações Inteligentes

O bot pode reagir a mensagens. Configure em actions.reactions: true.

No AGENTS.md, instrua quando reagir:

## Reações Discord

Use reações para:
- ✅ Confirmar que entendeu
-  Aprovar sugestões
-  Indicar que está processando

Criação de Enquetes

Com actions.polls: true, o bot pode criar enquetes:

@Bot crie uma enquete: "Qual linguagem devemos usar?" com opções Python, Go, Rust

Threads Automáticas

Configure actions.threads: true para o bot criar e responder em threads, mantendo conversas organizadas.

Histórico de Contexto

{
  channels: {
    discord: {
      historyLimit: 20, // Últimas 20 mensagens como contexto
    },
  },
}

Isso permite que o bot entenda conversas em andamento.

Segurança e Boas Práticas

Proteja o Token

Nunca:

  • Commite o token em repositórios Git
  • Cole em canais públicos
  • Compartilhe em screenshots

Sempre:

  • Use variáveis de ambiente
  • Restrinja permissões do arquivo de config (chmod 600)
  • Rotacione tokens periodicamente

Configure Allowlists

Em produção, sempre use allowlists:

{
  channels: {
    discord: {
      dm: {
        policy: "allowlist",
        allowFrom: ["123456789", "987654321"],
      },
      guilds: {
        "GUILD_ID": {
          users: ["123456789", "987654321"],
        },
      },
    },
  },
}

Evite Administrator

A permissão Administrator dá acesso total. Use apenas as permissões necessárias listadas anteriormente.

Monitore Uso

Verifique logs regularmente:

journalctl -u openclaw -f | grep discord

Troubleshooting

Bot conecta mas não responde

Causas comuns:

  1. Message Content Intent não habilitado

    • Volte ao Developer Portal → Bot → Habilite Message Content Intent
  2. Canal não está na allowlist

    • Adicione o canal em guilds.GUILD_ID.channels
  3. requireMention ativo mas não mencionou

    • Mencione o bot: @NomeDoBot mensagem
  4. Usuário não está na allowlist

    • Adicione o ID do usuário em users

“Used disallowed intents”

Habilite os intents necessários no Developer Portal:

  • Message Content Intent
  • Server Members Intent

Bot fica offline

Verifique:

openclaw status
openclaw channels status --probe

Se necessário, force reinício:

openclaw gateway restart --force

Mensagens não chegam

Execute diagnóstico:

openclaw doctor

Exemplo Completo de Configuração

Aqui está uma configuração de produção para um servidor de suporte:

{
  channels: {
    discord: {
      enabled: true,
      // Token via DISCORD_BOT_TOKEN
      
      groupPolicy: "allowlist",
      historyLimit: 15,
      
      dm: {
        enabled: true,
        policy: "pairing",
        allowFrom: ["ADMIN_USER_ID"],
      },
      
      guilds: {
        "MEUSERVIDOR_ID": {
          slug: "suporte-produto",
          requireMention: true,
          users: ["*"], // Todos podem usar
          reactionNotifications: "own",
          
          channels: {
            "CANAL_GERAL_ID": {
              allow: true,
              requireMention: true,
            },
            "CANAL_SUPORTE_ID": {
              allow: true,
              requireMention: false,
              systemPrompt: "Você é um agente de suporte. Seja prestativo, conciso e sempre tente resolver o problema. Se não souber, diga que vai escalar para a equipe.",
              skills: ["docs", "search"],
            },
            "CANAL_DEV_ID": {
              allow: true,
              requireMention: true,
              users: ["DEV1_ID", "DEV2_ID"],
              skills: ["code", "git"],
            },
          },
        },
      },
      
      actions: {
        reactions: true,
        polls: true,
        messages: true,
        threads: true,
        pins: true,
        moderation: false, // Desabilitado por segurança
      },
      
      retry: {
        attempts: 3,
        minDelayMs: 500,
        maxDelayMs: 30000,
      },
    },
  },
}

Conclusão

Integrar OpenClaw com Discord transforma seu servidor em um ambiente interativo e inteligente. Diferente de bots tradicionais, você tem um assistente que realmente entende contexto, aprende com interações e pode executar ações complexas.

Comece com a configuração básica, teste em um servidor privado, e vá adicionando recursos conforme sua necessidade. A flexibilidade do OpenClaw permite desde um simples bot de Q&A até um sistema completo de suporte automatizado.

Próximos Passos


Dúvidas? Entre na nossa comunidade Discord e pergunte!