--- title: "Discord Developer Portal: Como Criar um Bot com IA e OpenClaw" url: "https://openclaw.ia.br/blog/discord-developer-portal-criar-bot-openclaw/" markdown_url: "https://openclaw.ia.br/blog/discord-developer-portal-criar-bot-openclaw.MD" description: "Aprenda a usar o Discord Developer Portal para criar um bot, gerar o token, configurar intents e permissões e conectar o Discord ao OpenClaw com segurança." date: "2026-07-24" author: "OpenClaw Brasil" --- # Discord Developer Portal: Como Criar um Bot com IA e OpenClaw Aprenda a usar o Discord Developer Portal para criar um bot, gerar o token, configurar intents e permissões e conectar o Discord ao OpenClaw com segurança. O **Discord Developer Portal** é o painel oficial para criar e configurar bots do Discord. Nele, você registra uma aplicação, cria o usuário do bot, gera o token de acesso, ativa os *intents* necessários e monta o link para convidá-lo ao seu servidor. Depois, esse token pode ser conectado ao OpenClaw para transformar o bot em um assistente de IA capaz de responder perguntas, resumir conversas, consultar documentos e executar automações. A resposta curta é: acesse `discord.com/developers/applications`, clique em **New Application**, abra a seção **Bot**, configure as permissões mínimas e copie o token para um gerenciador de segredos — nunca para uma mensagem, repositório ou captura de tela. Este guia explica cada etapa e mostra como evitar os erros mais comuns de token, intents, autorização e bot offline. ## Resposta rápida: o que você precisa configurar | Etapa | Onde fica no portal | O que fazer | |---|---|---| | Criar aplicação | Applications | Clicar em **New Application** e escolher um nome | | Criar/configurar bot | Bot | Confirmar o usuário do bot, nome e imagem | | Gerar token | Bot | Usar **Reset Token** quando necessário e guardar o valor com segurança | | Ativar intents | Bot → Privileged Gateway Intents | Ativar somente os recursos exigidos pelo seu caso | | Definir instalação | Installation ou OAuth2 | Selecionar escopos `bot` e `applications.commands` | | Escolher permissões | OAuth2 / instalação | Começar com leitura e envio de mensagens; ampliar só quando necessário | | Convidar ao servidor | URL gerada | Abrir o link e selecionar um servidor no qual você seja administrador | | Conectar ao OpenClaw | Sua instalação | Informar o token por variável segura ou configuração protegida | | Testar | Discord | Mencionar o bot em um canal autorizado | Você não precisa dar permissão de administrador ao bot para começar. Para um assistente que apenas lê mensagens quando mencionado e responde em texto, permissões como **View Channels**, **Send Messages** e **Read Message History** costumam ser suficientes. Moderação, cargos e canais devem ser habilitados separadamente, apenas se a automação realmente usar essas ações. ## O que é o Discord Developer Portal? O portal de desenvolvedores é diferente do aplicativo comum do Discord. O aplicativo é onde pessoas conversam e administram servidores. O Developer Portal é onde desenvolvedores controlam aplicações que usam a API oficial da plataforma. Cada aplicação pode ter um bot associado. Esse bot funciona como uma identidade própria: aparece na lista de membros, recebe eventos autorizados, responde por API e pode oferecer *slash commands*. O painel também reúne configurações de OAuth2, instalação, webhooks, comandos, verificação e limites da aplicação. No caso do [OpenClaw no Discord](/canais/discord/), o portal cria a identidade e a credencial do bot; o OpenClaw fornece o comportamento inteligente. É ele que conecta o canal a um modelo como Claude, GPT, Gemini ou [Ollama local](/modelos/ollama/), aplica regras, consulta arquivos e decide quando pedir aprovação humana. Em outras palavras: - **Discord Developer Portal:** cria a aplicação, o bot, o token e as permissões; - **OpenClaw:** recebe a mensagem e orquestra a resposta ou ação; - **modelo de IA:** interpreta o pedido e gera texto ou instruções; - **seu servidor Discord:** define em quais canais e para quais membros o bot funciona. ## Antes de começar Separe quatro itens: 1. uma conta do Discord com acesso ao servidor de teste; 2. permissão para gerenciar ou adicionar aplicações nesse servidor; 3. uma instalação funcional do OpenClaw, seguindo o [guia de instalação](/instalacao/); 4. um local seguro para guardar o token, como variável de ambiente, cofre de segredos ou arquivo de configuração fora do Git. Faça o primeiro teste em um servidor separado ou em um canal como `#teste-bot`. Não conecte imediatamente um agente novo ao canal principal de uma comunidade grande. Um erro de permissão ou uma regra ampla demais pode fazer o bot responder fora de hora, ler canais desnecessários ou publicar conteúdo sem revisão. ## Passo 1: criar uma aplicação no Discord Developer Portal Acesse o endereço oficial: ```text https://discord.com/developers/applications ``` Entre com sua conta e clique em **New Application**. Escolha um nome reconhecível, como `OpenClaw Suporte`, `Assistente Comunidade` ou o nome da sua empresa. Aceite os termos exibidos e confirme. O nome da aplicação não precisa ser definitivo. Ele pode ser alterado depois. Mesmo assim, evite nomes que imitem uma marca ou um bot oficial que não pertence a você. Em ambientes de trabalho, use uma identificação que permita aos membros distinguir claramente automação e pessoa. Na área de informações gerais, você pode adicionar descrição e ícone. Uma descrição curta ajuda administradores a entender o propósito da aplicação: ```text Assistente de IA da comunidade para FAQ, resumos e triagem de suporte. ``` ## Passo 2: criar e personalizar o bot Abra a seção **Bot** no menu lateral. Dependendo da versão atual do painel, o usuário do bot pode ser criado automaticamente com a aplicação ou aparecer após uma confirmação. Defina: - nome visível; - avatar; - se o bot pode ser adicionado por outras pessoas; - comportamento de instalação pública ou privada. Para um bot interno, mantenha a instalação restrita à sua equipe sempre que possível. Um bot público exige mais cuidado com limites, abuso, isolamento entre servidores e armazenamento de dados. Não use um *selfbot*. Selfbot é uma automação que entra no Discord como se fosse uma conta humana comum. Esse caminho viola as regras da plataforma. A integração correta usa uma aplicação e um usuário de bot criados no Developer Portal. ## Passo 3: gerar e proteger o token do bot Na página **Bot**, localize a área de token. O portal pode exigir autenticação adicional antes de mostrar ou redefinir a credencial. Quando você usa **Reset Token**, o token anterior deixa de funcionar e precisa ser substituído na configuração do OpenClaw. O token funciona como uma senha completa do bot. Quem tiver esse valor pode operar a identidade dele. Portanto: - não cole o token em um canal do Discord; - não envie por e-mail ou mensageiro sem proteção; - não inclua em tutorial, print ou gravação de tela; - não faça commit em Git; - não deixe em um arquivo público do site; - não use o token real em exemplos de documentação. Use um marcador ao documentar a configuração: ```text DISCORD_BOT_TOKEN= ``` Se o token apareceu em público, trate-o como comprometido: volte ao Developer Portal, redefina a credencial e atualize a instalação. Apagar a mensagem ou o commit não é suficiente, porque cópias e históricos podem continuar existindo. ## Passo 4: escolher os Privileged Gateway Intents Os *gateway intents* definem quais categorias de eventos o bot pode receber. Na seção **Privileged Gateway Intents**, os nomes mais comuns são: - **Message Content Intent:** permite acesso ao conteúdo de mensagens em situações cobertas pela API; - **Server Members Intent:** libera eventos e informações adicionais sobre membros; - **Presence Intent:** fornece mudanças de presença, como online ou ausente. Para um assistente que precisa entender texto escrito em canais, o **Message Content Intent** costuma ser o ponto relevante. Para boas-vindas, gestão de membros ou automação baseada em entrada e saída, pode ser necessário o **Server Members Intent**. Presence geralmente não é necessário para FAQ, resumo ou suporte. Ative o mínimo necessário. Um bot que só responde a *slash commands* pode precisar de menos acesso do que um bot que acompanha toda a conversa. Essa redução melhora privacidade, simplifica auditoria e diminui o impacto de uma configuração errada. Aplicações grandes ou públicas podem estar sujeitas a exigências adicionais de verificação para determinados intents. Como regras e telas do Discord mudam, confira o texto atual exibido no próprio portal antes de planejar uma operação em muitos servidores. ## Passo 5: configurar OAuth2, instalação e permissões Abra **OAuth2**, **Installation** ou a área equivalente mostrada no painel atual. O objetivo é gerar uma URL de autorização para instalar o bot no servidor. Os escopos mais usados são: - `bot` — adiciona o usuário do bot; - `applications.commands` — habilita comandos de aplicação, incluindo *slash commands*. Depois, selecione as permissões. Para um piloto de perguntas e respostas: - View Channels; - Send Messages; - Read Message History; - Embed Links, se o bot envia cartões ou links formatados; - Attach Files, apenas se ele realmente entrega arquivos. Para criar threads, moderar mensagens, administrar cargos ou editar canais, existem permissões específicas. Não marque **Administrator** por conveniência. Administrador ignora diversas barreiras do servidor e aumenta muito o dano possível em caso de erro ou vazamento de token. ### Matriz de permissões por caso de uso | Caso de uso | Permissões adicionais prováveis | Recomendação | |---|---|---| | FAQ por menção | Ler histórico e enviar mensagens | Melhor ponto de partida | | Resumo de canal | Ver canal e ler histórico | Limite a canais autorizados | | Criar threads de suporte | Create Public/Private Threads | Teste em uma categoria separada | | Sinalizar spam | Ler e enviar mensagens | Deixe a remoção para aprovação humana | | Apagar mensagens | Manage Messages | Só após medir a classificação | | Gerenciar cargos | Manage Roles | Mantenha o cargo do bot abaixo dos cargos administrados | | Criar canais | Manage Channels | Alto impacto; use aprovação e lista permitida | ## Passo 6: convidar o bot para o servidor Copie a URL gerada e abra no navegador. Escolha o servidor, confirme as permissões e conclua a autorização. Você precisa ter poder de gerenciamento suficiente nesse servidor. Depois da instalação, o bot pode aparecer como offline. Isso é normal enquanto nenhum processo estiver conectado à API usando o token. O Developer Portal cria a identidade; ele não hospeda o código nem mantém o OpenClaw ligado. Crie um canal de teste e restrinja o acesso inicial. Uma configuração segura para a primeira hora é: - bot visível apenas no canal de teste; - resposta somente quando mencionado; - nenhuma permissão de moderação; - nenhum envio proativo; - nenhuma ferramenta externa capaz de apagar, publicar ou alterar dados. ## Passo 7: conectar o token ao OpenClaw Com o OpenClaw instalado, siga a [integração completa com Discord](/integracoes/discord/) para registrar o canal. O formato exato de configuração pode variar conforme a versão do OpenClaw, então use a documentação da versão instalada em vez de copiar comandos antigos sem conferir. O desenho esperado é: ```text Mensagem no Discord → bot autorizado pelo Developer Portal → canal Discord do OpenClaw → regras, memória e ferramentas → modelo de IA → resposta no canal autorizado ``` Configure uma lista explícita de servidores e canais permitidos. Para comunidades grandes, use o modo de menção: o agente só responde quando alguém escreve `@NomeDoBot`. Isso evita que ele interrompa conversas, responda a outros bots ou consuma recursos em todas as mensagens. Se você quer usar Claude como modelo, o guia de [Claude no Discord](/como-usar/claude-discord/) cobre esse recorte. Para manter prompts no seu ambiente, consulte [Ollama no Discord](/como-usar/ollama-discord/). A escolha do modelo não muda o token do bot; muda apenas o motor usado pelo OpenClaw para processar a solicitação. ## Passo 8: fazer um teste seguro Inicie ou reinicie o serviço do OpenClaw e observe os logs sem imprimir o token. No canal de teste, envie: ```text @SeuBot responda apenas: conexão funcionando ``` Depois valide quatro comportamentos: 1. o bot responde somente no canal permitido; 2. mensagens de outros bots são ignoradas; 3. uma pessoa sem o cargo autorizado não consegue pedir ações sensíveis; 4. o bot admite que não sabe quando a resposta não está na base. Só então avance para FAQ, resumo e integrações. Se o bot puder criar tickets, consultar GitHub ou ler documentos, libere uma ferramenta de cada vez e mantenha [aprovação humana](/blog/human-in-the-loop-ia-aprovacao-agentes-openclaw/) nas ações visíveis ou destrutivas. ## Erros comuns no Discord Developer Portal ### Bot aparece offline O portal não executa o bot. Verifique se o OpenClaw está ativo, se o canal Discord foi habilitado e se o token atual está na configuração. Se você usou **Reset Token**, a credencial antiga parou de funcionar. O guia de [bot Discord offline](/troubleshooting/discord-bot-offline/) reúne o diagnóstico específico. ### Bot entra no servidor, mas não responde As causas mais frequentes são: - Message Content Intent desativado quando o fluxo depende dele; - permissão de View Channel ou Send Messages ausente; - bot restrito a outro canal na configuração; - modo de menção ativo e a mensagem enviada sem `@bot`; - serviço do OpenClaw parado; - modelo de IA sem configuração válida. ### “Missing Permissions” ou “Missing Access” Revise dois níveis: permissões concedidas no convite e permissões do canal/categoria. Uma permissão geral pode ser negada explicitamente numa categoria. Para cargos, o cargo do bot precisa estar acima do cargo que ele tentará administrar. Veja também o guia de [erros de permissão no Discord](/troubleshooting/discord-permissoes-erro/). ### Link de convite não mostra o servidor Sua conta provavelmente não tem permissão para gerenciar esse servidor, ou a configuração de instalação da aplicação não permite o fluxo escolhido. Teste com um servidor seu e revise os escopos `bot` e `applications.commands`. ### Token inválido Copie novamente sem espaços extras e confirme que a configuração usa o token atual. Não publique o valor para pedir ajuda. Se houver dúvida sobre vazamento, redefina o token em vez de tentar reutilizá-lo. ### Bot responde a tudo e atrapalha o servidor Ative o modo de menção e uma lista de canais permitidos. Comece reativo, não proativo. Um assistente útil aparece quando chamado; um bot configurado para comentar qualquer frase vira ruído rapidamente. ## Configuração recomendada para os primeiros sete dias | Controle | Configuração inicial | |---|---| | Servidores | Um servidor de teste | | Canais | Um canal dedicado | | Gatilho | Somente menção ou slash command | | Ações | Responder FAQ e resumir | | Moderação | Apenas sinalizar; não apagar | | Cargos | Sem gestão automática | | Ferramentas externas | Nenhuma no primeiro teste | | Histórico | Retenção mínima necessária | | Revisão | Amostra diária das respostas | Depois de uma semana, meça taxa de resposta correta, mensagens ignoradas, tempo de resposta e quantas vezes um humano precisou corrigir o bot. Só amplie permissões quando houver uma necessidade observável. ## Ideias úteis de automação com OpenClaw e Discord Depois da configuração básica, o bot pode assumir tarefas delimitadas: - responder FAQ com base na documentação da comunidade; - resumir as últimas mensagens de um canal; - transformar uma discussão em checklist; - abrir um rascunho de ticket de suporte; - publicar alertas de build e deploy do GitHub; - preparar uma mensagem de boas-vindas; - criar um briefing semanal para moderadores; - encaminhar casos sensíveis para aprovação humana. A [integração do OpenClaw com Discord](/blog/integracao-discord-openclaw-guia-completo/) aprofunda os casos de uso. O Developer Portal continua sendo a fundação: sem token, intents e permissões corretos, nenhuma automação consegue operar de forma confiável. ## Perguntas frequentes ### Qual é o endereço oficial do Discord Developer Portal? O endereço oficial é `https://discord.com/developers/applications`. Confira o domínio antes de entrar ou gerar credenciais. Evite páginas que prometem criar bot e pedem seu token fora do domínio oficial. ### O Discord Developer Portal é gratuito? Criar uma aplicação e um bot no portal não exige pagamento. Você pode ter custos na infraestrutura que executa o OpenClaw e no modelo de IA escolhido. Um modelo local com Ollama elimina cobrança por token, mas ainda usa hardware e energia. ### Onde encontro o token do bot Discord? Na seção **Bot** da sua aplicação. O portal pode exigir autenticação adicional e oferecer a opção **Reset Token**. Guarde o valor como segredo e nunca o inclua em código público. ### Quais intents devo ativar para um bot com IA? Depende da função. Message Content costuma ser necessário quando o bot precisa interpretar mensagens comuns. Server Members pode ser necessário para entrada, saída e gestão de membros. Presence raramente é necessário para FAQ e suporte. Ative somente o mínimo. ### Preciso dar Administrator ao bot? Não. Para responder mensagens, permissões básicas de leitura e envio bastam na maioria dos casos. Administrator aumenta o risco e deve ser evitado. Conceda permissões específicas conforme cada automação for validada. ### Por que o bot fica offline mesmo depois de ser convidado? Porque convidar apenas adiciona a identidade ao servidor. Um processo precisa se conectar à API do Discord com o token. Verifique se o OpenClaw está rodando e se a integração Discord está habilitada. ### Posso usar o mesmo bot em vários servidores? Sim, se a configuração de instalação permitir. Porém, você deve isolar dados, canais, permissões e memória por servidor. Para um piloto interno, é mais seguro começar em um único servidor. ### Dá para conectar Claude, GPT ou Ollama ao mesmo bot? Sim. O bot do Discord é o canal; o OpenClaw escolhe o modelo. Você pode trocar ou rotear modelos sem criar outra aplicação, desde que a sua política de dados e as ferramentas estejam configuradas corretamente. ## Próximos passos O caminho mais seguro é incremental: 1. crie a aplicação no Discord Developer Portal; 2. gere e proteja o token; 3. ative apenas os intents necessários; 4. convide o bot com permissões mínimas; 5. [instale o OpenClaw](/instalacao/); 6. conecte a [integração Discord](/integracoes/discord/); 7. teste em um canal isolado e somente por menção; 8. adicione FAQ, resumo e ferramentas uma de cada vez. Se o bot não responder, não redefina tudo no escuro. Verifique token atual, processo ativo, intents, permissões do canal e lista de canais permitidos, nessa ordem. Com essa base, o Discord Developer Portal deixa de ser um painel confuso e vira o ponto de controle de um assistente de IA útil, limitado e auditável.