Pré-requisitos
- Uma conta no Discord
- Um servidor do Discord onde você tenha permissão de Gerenciar Servidor
- Uma instância Claw (crie uma aqui)
Guia de Configuração
Criar um Aplicativo no Discord
- Acesse o Discord Developer Portal
- Clique em New Application
- Dê um nome a ele (ex: “Meu Bot de IA”) e clique em Create
Criar um Bot
- No seu aplicativo, vá para a aba Bot
- Clique em Add Bot → Yes, do it!
- Em Privileged Gateway Intents, habilite:
- Message Content Intent (obrigatório)
- Server Members Intent (recomendado)
- Clique em Reset Token para gerar um token de bot
- Copie o token — você precisará dele a seguir
Convidar o Bot para seu Servidor
- Vá para a aba OAuth2 → URL Generator
- Em Scopes, selecione:
bot,applications.commands - Em Bot Permissions, selecione:
Send Messages,Read Message History - Copie a URL gerada e abra-a em seu navegador
- Selecione seu servidor e clique em Authorize
Configurar no Painel da LemonData
- Acesse seu Painel Claw
- Clique no ícone de configurações em sua instância
- Abra a aba IM Integrations
- Expanda a seção Discord
- Cole seu Bot Token
- Clique em Save
Uso em Servidores
Configurações de Grupo
Configure o comportamento do servidor (guild) na aba IM Integrations do seu Painel:| Configuração | Opções | Descrição |
|---|---|---|
| Group Policy | Open (padrão) / Allowlist / Disabled | Controla o acesso aos canais do servidor |
| Require @mention | On / Off | O bot responde apenas quando mencionado com @ (recomendado) |
| Group IDs | Lista de IDs de guild | Restringir a servidores específicos (vazio = todos os servidores) |
O Discord usa allowlists de usuários por servidor em vez de uma allowlist de grupo global. Para filtragem avançada de usuários por servidor, configure diretamente no arquivo de configuração do OpenClaw.
Política de DM
Controle quem pode enviar mensagens diretas para o seu bot:| Política | Comportamento |
|---|---|
| Pairing (padrão) | Novos usuários recebem um código de pareamento — insira-o na WebUI para autorizar |
| Allowlist | Apenas IDs de usuário que você especificar podem enviar DMs para o bot |
| Open | Qualquer pessoa pode enviar DMs para o bot (use com cautela) |
Resolução de Problemas
O bot está online, mas não responde
O bot está online, mas não responde
- Certifique-se de que o Message Content Intent está habilitado no Developer Portal
- Verifique se o token do bot está correto
- Verifique se o bot tem permissão para ler e enviar mensagens no canal
O bot aparece como offline
O bot aparece como offline
- Verifique o status da sua instância no painel (deve estar verde/em execução)
- Tente reiniciar a instância
- Verifique se o token não foi redefinido no Developer Portal
Erros 409 Conflict nos logs
Erros 409 Conflict nos logs
- Isso acontece quando duas instâncias tentam usar o mesmo token de bot
- Certifique-se de que apenas uma instância Claw esteja configurada com este token