Como conectar o OpenClaw ao Discord

Resposta curta. No Discord Developer Portal, crie uma aplicação, abra Bot, aperte Reset Token para obter o token e ative Message Content Intent. Convide o bot para um servidor em que você esteja, ative o Developer Mode no Discord e copie o seu próprio ID de usuário. Depois dê o token ao OpenClaw e permita só o seu ID de usuário. Na PlayNHost são dois campos na página Agente, e um reinício; o painel instala o conector do Discord do OpenClaw para você.

Verificado em 6 de novembro de 2026, correto para o OpenClaw 2026.11.1.

Este guia segue a documentação de configuração do Discord do OpenClaw e o painel da PlayNHost como ele funciona hoje.

Passo 1: crie a aplicação e o bot do Discord

1. Abra o Discord Developer Portal, aperte New Application e dê um nome a ela.
2. Abra Bot na barra lateral e defina o Username do bot com o nome do seu agente.
3. Ainda em Bot, em Privileged Gateway Intents, ative:
   • Message Content Intent: obrigatório aqui. O OpenClaw pede isso ao Discord, e o Discord recusa a conexão ("disallowed intents") quando está desativado.
   • Server Members Intent: recomendado pelo OpenClaw, necessário para listas de permitidos por cargo e para associar nomes a IDs.
   • Presence Intent: opcional, só para atualizações de presença.
4. Aperte Reset Token e copie o token. Apesar do nome, o primeiro clique cria o seu primeiro token. Mantenha-o privado.

Passo 2: convide o bot e permita DMs

1. Abra OAuth2 e depois o OAuth2 URL Generator. Marque os escopos bot e applications.commands.
2. Em Bot Permissions, marque pelo menos View Channels, Send Messages, Read Message History, Embed Links e Attach Files (Add Reactions é opcional).
3. Abra a URL gerada, escolha o seu servidor e aperte Continue. Um servidor privado só com você e o bot é o mais simples.
4. Deixe o bot mandar mensagem para você: clique com o botão direito no ícone do servidor, abra Privacy Settings e ative Direct Messages.

Passo 3: copie o seu ID de usuário do Discord

No Discord, abra User Settings, depois Developer, e ative Developer Mode (no celular: App Settings, Advanced). Depois clique com o botão direito no seu próprio avatar ou nome e escolha Copy User ID. É um número longo (a PlayNHost aceita de 17 a 20 dígitos).

A documentação do Discord do OpenClaw usa o Developer Mode para isso, e o painel também: ao contrário da configuração do Telegram, o console não pede que você leia o seu ID na resposta de um bot.

Passo 4 na PlayNHost: cole o token e o seu ID

1. Abra o seu servidor em panel.playnhost.com, depois a aba Agente. Defina uma chave de provedor de IA em Provedor de IA se ainda não o fez (veja qual chave de provedor de IA usar).
2. Em Apps de chat, aperte Definir em Token do bot do Discord, cole o token e aperte Salvar. O painel confere o formato; se você colar algo errado, aparece "That is not a valid discord bot token." (esse não é um token de bot do Discord válido).
3. Em Quem pode falar com ele, digite o seu ID em IDs de usuário do Discord e aperte Salvar. Vários IDs vão em uma linha, separados por vírgulas.
4. Aperte Iniciar, ou Reiniciar agora se o agente já estiver rodando. O Discord é um plugin separado do OpenClaw, então o primeiro início com um token do Discord o instala uma vez. Entre outras linhas, o console mostra (em inglês):

   [PlayNHost] Installing the Discord connector 2026.11.1
   [PlayNHost] Starting OpenClaw 2026.11.1
   [PlayNHost] Your agent is running
   [PlayNHost] Discord: only user 123456789012345678 can message your agent.

   No nosso teste, a instalação do conector levou cerca de 30 segundos. Os inícios seguintes o reutilizam e o atualizam quando o próprio OpenClaw é atualizado.
5. Mande uma mensagem direta ao seu bot no Discord. O seu agente responde. As outras contas do Discord são ignoradas.

Se você deixar IDs de usuário do Discord vazio, o console diz "Discord: nobody can message your agent yet" (ninguém pode falar com o seu agente ainda) e explica como copiar o seu ID. Até você adicioná-lo, qualquer pessoa que mande DM ao bot é ignorada; o OpenClaw responde a uma primeira mensagem com um código de pareamento: ignore-o, não há nada para aprovar, e coloque no lugar o seu ID de usuário no painel Agente.

O que a PlayNHost configura por você

• Os DMs do Discord usam dmPolicy: "allowlist" com os IDs do painel Agente (ou pairing enquanto a lista estiver vazia), e esses IDs passam a ser os donos de comandos do OpenClaw.
• Os canais de servidor continuam fechados: o groupPolicy padrão do OpenClaw é allowlist, e nenhum servidor está nessa lista até que um seja adicionado às configurações do OpenClaw. Use mensagens diretas.
• O token chega ao OpenClaw como DISCORD_BOT_TOKEN no ambiente dele. Um token gravado no arquivo de configurações do OpenClaw teria prioridade sobre esse, então o início remove aquele.
• O mesmo servidor também pode conversar no Telegram: defina os dois tokens e as duas listas de IDs. Veja conectar o OpenClaw ao Telegram.

Passo 4 na sua própria máquina

1. Confira se o plugin do Discord está lá com openclaw plugins list. Na nossa instalação de teste do pacote npm 2026.11.1 ele não vinha incluído; isto o adicionou:

   openclaw plugins install npm:@openclaw/discord

2. Coloque o token no ambiente do Gateway (nunca em um chat) e aponte a configuração para ele, permitindo só você mesmo:

   export DISCORD_BOT_TOKEN="YOUR_BOT_TOKEN"
   cat > discord.patch.json5 <<'JSON5'
   {
     channels: {
       discord: {
         enabled: true,
         token: { source: "env", provider: "default", id: "DISCORD_BOT_TOKEN" },
         dmPolicy: "allowlist",
         allowFrom: ["123456789012345678"],
       },
     },
     commands: {
       ownerAllowFrom: ["discord:123456789012345678"],
     },
   }
   JSON5
   openclaw config patch --file ./discord.patch.json5 --dry-run
   openclaw config patch --file ./discord.patch.json5
   openclaw gateway

   A parte commands faz de você o dono para os comandos exclusivos do dono, o que uma lista de permitidos escrita à mão não faz. Para uma instalação como serviço, coloque DISCORD_BOT_TOKEN em ~/.openclaw/.env para o serviço tê-lo, e reinicie o serviço em vez de rodar openclaw gateway.
3. Ou mantenha o modo pairing padrão: mande um DM ao bot e depois aprove o código dentro de uma hora:

   openclaw pairing list discord
   openclaw pairing approve discord <CODE>

Quando ele não responde

Ainda não configurou? Crie um servidor OpenClaw.

A PlayNHost não é afiliada à OpenClaw Foundation. O OpenClaw é um software de código aberto sob a licença MIT.