Como conectar o Hermes Agent ao Discord

Resposta curta. Crie um aplicativo e um bot no Discord Developer Portal, ative o Message Content Intent e o Server Members Intent, copie o token do bot com Reset Token, convide o bot para o seu servidor e depois dê ao Hermes Agent o token e o seu ID de usuário do Discord. Só os IDs da lista de permitidos podem falar com ele. Na sua própria máquina, isso são DISCORD_BOT_TOKEN e DISCORD_ALLOWED_USERS em ~/.hermes/.env, ou hermes gateway setup. Na PlayNHost você cola o token e o seu ID na página Agente e reinicia.

Verificado em 7 de novembro de 2026, correto para o Hermes Agent v0.23.0.

Este guia usa a documentação de Discord e de segurança do Hermes Agent e o painel da PlayNHost como ele funciona hoje. O suporte ao Discord já vem embutido no gateway de mensagens do Hermes Agent.

Passo 1: crie o aplicativo e o bot

1. Abra o Discord Developer Portal, clique em New Application, dê um nome e clique em Create. Anote o Application ID na página General Information.
2. Abra Bot no menu da esquerda. Em Authorization Flow, ative Public Bot se quiser usar o link de convite do próprio Discord (passo 2), e deixe Require OAuth2 Code Grant desligado.
3. Em Privileged Gateway Intents, ative Message Content Intent e Server Members Intent e clique em Save Changes. A documentação do Hermes Agent marca os dois como obrigatórios: sem o Message Content Intent, o Discord recusa a conexão do bot e ele nunca fica online. O Presence Intent é opcional.
4. Em Token, clique em Reset Token e copie o token. O Discord o mostra uma única vez. Mantenha-o em segredo: quem o tiver controla o seu bot.

Passo 2: convide o bot para o seu servidor

Use Installation (Guild Install, Discord Provided Link, escopos bot e applications.commands, e as permissões listadas abaixo), ou monte o link você mesmo com o Application ID do passo 1:

https://discord.com/oauth2/authorize?client_id=YOUR_APP_ID&scope=bot+applications.commands&permissions=309237763136

309237763136 é o conjunto de permissões que a documentação do Hermes Agent recomenda: View Channels, Send Messages, Embed Links, Attach Files, Read Message History, Create Public Threads, Send Messages in Threads e Add Reactions. Abra o link, escolha o seu servidor e clique em Authorize. Você precisa da permissão Manage Server nesse servidor.

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

1. No Discord, abra Settings, Advanced, e ative Developer Mode.
2. Clique com o botão direito no seu próprio nome e escolha Copy User ID. É um número longo, como 284102345871466496.

Esse é o seu ID de usuário, não o Application ID do bot nem o ID de um servidor ou de um canal.

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

1. Abra o seu servidor em panel.playnhost.com e depois a aba Agente.
2. Em Provedor de IA, defina uma chave se ainda não fez isso (veja qual chave de provedor de IA usar).
3. Em Apps de chat, clique em Definir em Token do bot do Discord, cole o token e clique em Salvar. A linha passa a mostrar só os quatro últimos caracteres; o token nunca mais é exibido.
4. Em Quem pode falar com ele, cole o seu ID em IDs de usuário do Discord e clique em Salvar. Vários IDs vão em uma só linha, separados por vírgulas ou espaços.
5. Clique em Iniciar, ou em Reiniciar agora se o agente já estiver rodando (“As alterações valem na próxima vez que o seu agente iniciar.”). Quando ele está no ar, o console confirma:

   [PlayNHost] Your agent is running
   [PlayNHost] Discord: only user 284102345871466496 can message your agent.

6. Envie uma mensagem direta ao bot, ou mencione-o com @ em um canal que ele consiga ver. O seu agente responde: em mensagem direta, ali mesmo; em um canal, em um novo tópico sob a sua mensagem.

Se você começar com o campo IDs de usuário do Discord vazio, o console diz “Discord: nobody can message your agent yet” e pede que você envie uma mensagem ao bot: uma mensagem direta de alguém que não está na lista é ignorada, e o console então imprime uma linha com o ID de quem enviou para você adicionar. O Developer Mode é o jeito mais rápido.

Telegram e Discord podem rodar ao mesmo tempo no mesmo agente: defina os dois tokens e as duas listas de IDs.

Como o Hermes Agent se comporta no Discord

• Mensagens diretas: ele responde a todas as mensagens, sem precisar de menção, com uma conversa por mensagem direta.
• Canais do servidor: ele responde só quando você o menciona com @, e por padrão abre um novo tópico a cada menção e responde ali. Pessoas diferentes no mesmo canal têm conversas separadas.
• Outras pessoas: na PlayNHost, só os IDs de usuário da página Agente recebem resposta. Permissões por cargo, chaves de permitir todos e acesso entre bots são desligados a cada inicialização.

Passo 4 na sua própria máquina

1. Rode o assistente de configuração e escolha Discord. A documentação do Hermes Agent diz que ele confere o token com o Discord, confere os intents, imprime o link de convite e se oferece para liberar você:

   hermes gateway setup

2. Ou adicione os valores à mão em ~/.hermes/.env:

   DISCORD_BOT_TOKEN=your-bot-token
   DISCORD_ALLOWED_USERS=284102345871466496

3. Inicie com hermes gateway. Para um gateway que continue rodando depois que você sair da sessão, veja como rodar o Hermes Agent 24/7.

Quando ele não responde

Na PlayNHost, o log do próprio Hermes Agent é .hermes/logs/gateway.log em Files. Quer o Telegram também? Veja conectar o Hermes Agent ao Telegram. Ainda não configurou? Crie um servidor Hermes Agent.

A PlayNHost não é afiliada à Nous Research. O Hermes Agent é um software de código aberto sob a licença MIT.