Integração do Clawdbot com Discord

Visão Geral da Integração do Clawdbot com Discord

A integração do Clawdbot com Discord permite que você traga assistência alimentada por IA para seus servidores Discord usando o gateway oficial do bot Discord. Está pronto para DMs e canais de texto de guildas.

Por Que Usar Clawdbot com Discord?

Discord é a plataforma líder para jogos e comunicação comunitária. Integrar Clawdbot com Discord oferece:

Configuração Rápida (Iniciante)

1. Crie um bot Discord e copie o token do bot
2. Nas configurações do aplicativo Discord, habilite Message Content Intent (e Server Members Intent se necessário)
3. Configure o token via env (DISCORD_BOT_TOKEN=...) ou config (channels.discord.token)
4. Convide o bot para seu servidor com permissões de mensagem
5. Inicie o gateway
6. O acesso por DM é por pareamento por padrão; aprove o código de pareamento no primeiro contato

Configuração mínima:

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

Configurando Clawdbot Discord

Pré-requisitos

Antes de conectar Clawdbot ao Discord, certifique-se de ter:

• Clawdbot instalado no seu dispositivo
• Uma conta Discord
• Acesso ao Portal de Desenvolvedores do Discord
• Permissões de administrador do servidor

Passo 1: Criar um Aplicativo Discord

Configure seu aplicativo Clawdbot Discord:

1. Vá para o Portal de Desenvolvedores do Discord
2. Clique em "New Application"
3. No seu aplicativo: Bot → Add Bot
4. Copie o Token do Bot

Passo 2: Habilitar Intents do Gateway

Habilite os intents que o Clawdbot precisa:

• Message Content Intent — Necessário para ler o conteúdo das mensagens
• Server Members Intent — Necessário para listas permitidas ou buscas de nomes

Passo 3: Gerar URL de Convite

Use o Gerador de URL OAuth2 no Portal de Desenvolvedores:

Permissões necessárias para Clawdbot Discord:

• Read Messages/View Channels
• Send Messages
• Embed Links
• Read Message History
• Add Reactions
• Use Slash Commands

Passo 4: Configurar Clawdbot Discord

Adicione seu bot Discord ao Clawdbot:

Variável de ambiente:

DISCORD_BOT_TOKEN=YOUR_BOT_TOKEN

Arquivo de configuração (~/.clawdbot/clawdbot.json):

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

Se tanto env quanto config estiverem definidos, config tem precedência.

Passo 5: Iniciar o Gateway

clawdbot gateway --port 18789

O Discord inicia automaticamente quando um token está disponível e channels.discord.enabled não é false.

Passo 6: Verificar Conexão

Verifique o status do seu Clawdbot Discord:

clawdbot channels status discord

Como Funciona

• Chats diretos se fundem na sessão principal do agente (padrão agent:main:main)
• Canais de guilda permanecem isolados como agent:<agentId>:discord:channel:<channelId>
• DMs em grupo são ignorados por padrão; habilite via channels.discord.dm.groupEnabled
• O roteamento é determinístico: respostas sempre retornam ao canal de origem

Recursos do Clawdbot Discord

Controle de Acesso DM

Chats diretos são seguros por padrão via channels.discord.dm.policy:

Exemplo (lista permitida rígida):

{
  "channels": {
    "discord": {
      "dm": {
        "policy": "allowlist",
        "allowFrom": ["user:123456789"]
      }
    }
  }
}

Configuração de Canais de Guilda

Defina regras por guilda ou por canal:

{
  "channels": {
    "discord": {
      "guilds": {
        "<guild_id>": {
          "channels": ["bot-commands", "ai-chat"],
          "requireMention": true
        }
      }
    }
  }
}

Comandos Slash

Clawdbot Discord suporta comandos slash nativos:

Comandos nativos padrão são "auto" (ativados para Discord/Telegram). Substitua com:

{
  "channels": {
    "discord": {
      "commands": {
        "native": true
      }
    }
  }
}

Histórico de Contexto da Guilda

Defina channels.discord.historyLimit (padrão 20) para incluir as últimas N mensagens da guilda como contexto ao responder a uma menção. Defina 0 para desabilitar.

Reações

O agente pode acionar reações via a ferramenta discord (controlada por channels.discord.actions.*).

Configuração do Clawdbot Discord

Exemplo de Configuração Completa

{
  "channels": {
    "discord": {
      "enabled": true,
      "token": "YOUR_BOT_TOKEN",
      "dm": {
        "policy": "pairing",
        "groupEnabled": false
      },
      "guilds": {
        "*": {
          "requireMention": true
        }
      },
      "historyLimit": 20
    }
  }
}

Gravações de Configuração

Por padrão, Discord pode gravar atualizações de configuração acionadas por /config set|unset. Desabilite com:

{
  "channels": {
    "discord": {
      "configWrites": false
    }
  }
}

Armazenamento de Credenciais do Clawdbot Discord

Clawdbot armazena credenciais do Discord de forma segura:

~/.clawdbot/credentials/discord/bot_token
~/.clawdbot/credentials/discord/servers.json

Seus dados do Clawdbot Discord permanecem na sua máquina local.

Solução de Problemas do Clawdbot Discord

Bot Offline

Se Clawdbot Discord aparece offline:

1. Verifique o token: clawdbot channels verify discord
2. Verifique a conexão do gateway
3. Revise os logs: cat /tmp/clawdbot/discord.log

Comandos Slash Não Funcionam

Se os comandos slash do Clawdbot Discord falham:

1. Registre novamente os comandos via configuração
2. Verifique as permissões do bot
3. Verifique o registro de comandos específicos do servidor

Erros de Permissão

Se Clawdbot Discord não tem permissões:

1. Revise a posição da função do bot nas configurações do servidor
2. Verifique permissões específicas do canal
3. Convide novamente com as permissões corretas

Resolução de Nomes

A resolução nome → id usa busca de membros da guilda e requer Server Members Intent. Se o bot não consegue buscar membros, use ids ou menções <@id>.

Melhores Práticas do Clawdbot Discord

1. Use o Modo de Pareamento: Seguro por padrão com códigos de pareamento para DMs
2. Defina Limites de Canal: Restrinja Clawdbot Discord aos canais apropriados
3. Configure Funções: Use acesso baseado em funções para Clawdbot Discord
4. Monitore a Atividade: Revise os logs do Clawdbot Discord regularmente
5. Use Comandos Slash: Melhor UX do que comandos de texto

Casos de Uso do Clawdbot Discord

Suporte Comunitário

Implante Clawdbot Discord como um bot de suporte:

• Responda FAQs automaticamente
• Escale problemas complexos
• Forneça assistência 24/7

Comunidades de Jogos

Use Clawdbot Discord para servidores de jogos:

• Busca de informações de jogos
• Coordenação de equipes
• Agendamento de eventos

Comunidades de Desenvolvedores

Clawdbot Discord para servidores de desenvolvedores:

• Assistência com código
• Busca de documentação
• Triagem de bugs

Próximos Passos

• Integração do Clawdbot com WhatsApp - Conecte Clawdbot ao WhatsApp
• Integração do Clawdbot com Telegram - Configure Clawdbot no Telegram
• Guia de Configuração do Clawdbot - Guia de instalação completo