Passo a Passo: Hermes Agent no WhatsApp

Todos os comandos estão nesta página para você seguir do começo ao fim. Não precisa saber programar: copie os blocos na ordem e responda apenas as perguntas indicadas.

Windows • PowerShell • QR Code • Baileys • OpenRouter

Receba avisos de novos vídeos
Entre no grupo de WhatsApp para receber os avisos: https://chat.whatsapp.com/KaZ8qx2krwR73icGl7EZ8w
Abrir grupo do WhatsApp

O caminho inteiro em uma visão

A ordem é importante. Primeiro crie a chave, depois instale, escolha o modelo, defina o nome, conecte o QR Code e ligue o gateway.

1OpenRouter

Crie a chave gratuita e guarde-a com segurança.

2Instalação

Use o instalador oficial do projeto.

3Modelo

Escolha OpenRouter e um modelo marcado :free.

4Identidade

Escolha o nome e salve o prompt do agente.

5WhatsApp

Execute hermes whatsapp e escaneie o QR Code.

6Gateway

Deixe hermes gateway aberto para responder.

Crie a chave do OpenRouter antes do terminal

Abra openrouter.ai e crie sua conta.
Entre em Settings → Keys.
Crie uma chave e copie-a. Ela normalmente começa com sk-or-.

Não mostre a chave na gravação e não envie a chave para ninguém. Ela é como uma senha.

Agora abra um PowerShell novo e copie este bloco. Quando aparecer a pergunta, cole a chave e pressione Enter.

PowerShell — salvar a chave sem exibi-la

$chaveSegura = Read-Host 'Cole sua chave sk-or- aqui e pressione Enter' -AsSecureString
$ponteiro = [Runtime.InteropServices.Marshal]::SecureStringToBSTR($chaveSegura)
try {
  $chave = [Runtime.InteropServices.Marshal]::PtrToStringBSTR($ponteiro)
  [Environment]::SetEnvironmentVariable('OPENROUTER_API_KEY', $chave, 'User')
  $env:OPENROUTER_API_KEY = $chave
}
finally {
  [Runtime.InteropServices.Marshal]::ZeroFreeBSTR($ponteiro)
}
Write-Host 'Chave carregada e salva no usuário do Windows.' -ForegroundColor Green

Instalar Hermes oficialmente

PowerShell — instalação oficial

iex (irm https://hermes-agent.nousresearch.com/install.ps1)

Se a instalação fizer perguntas, aceite os padrões com Enter. Se o Windows pedir autorização, responda S ou Y, conforme o idioma da tela.

PowerShell — conferir instalação

hermes --version

Se “hermes não é reconhecido”, feche o PowerShell, abra outro e repita o teste.

Escolher um modelo gratuito

O catálogo do OpenRouter muda. Use o menu oficial e escolha OpenRouter e um modelo com :free e pelo menos 64K de contexto.

PowerShell — menu de modelo

hermes model

Na lista, openrouter/free é um roteador de modelos gratuitos. Também pode aparecer um modelo individual como qwen/qwen3.8-27b:free. Escolha o que estiver disponível no seu catálogo.

Teste a conversa:

PowerShell — teste rápido

hermes chat --provider openrouter --model 'qwen/qwen3.8-27b:free'

Digite Responda apenas: funcionando. Saia com Ctrl+C. Se escolher outro modelo, use o modelo que apareceu no seu menu.

Escolher nome e salvar o prompt

Troque AGENTE DA SUA EMPRESA somente dentro das aspas. Exemplo: ATENDIMENTO LOJA EXEMPLO.

PowerShell — nome exibido nas respostas

$nomeAgente = 'AGENTE DA SUA EMPRESA'
hermes config set whatsapp.reply_prefix $nomeAgente
Write-Host "Nome configurado: $nomeAgente" -ForegroundColor Green

O programa não precisa se apresentar como Hermes. Este comando define o prefixo que aparecerá nas mensagens.

PowerShell — criar identidade do agente

$hermesHome = if ($env:HERMES_HOME) { $env:HERMES_HOME } else { "$env:LOCALAPPDATA\hermes" }
New-Item -ItemType Directory -Path $hermesHome -Force | Out-Null
$prompt = @'
# Identidade do agente

Você é o atendente virtual da empresa.

## Regras
- Fale em português do Brasil, com clareza e paciência.
- Explique assuntos técnicos para pessoas iniciantes.
- Seja direto, educado e útil.
- Nunca invente informações; diga quando não souber.
- Não peça nem revele senhas, chaves de API ou dados bancários.
- Quando faltar informação importante, faça uma pergunta curta.
'@
Set-Content -LiteralPath (Join-Path $hermesHome 'SOUL.md') -Value $prompt -Encoding UTF8
Write-Host "Prompt salvo em: $(Join-Path $hermesHome 'SOUL.md')" -ForegroundColor Green

Conectar o WhatsApp com QR Code

Para um primeiro teste, use o modo self-chat, conversando com você mesmo. Para um bot separado, use um número dedicado.

PowerShell — abrir o pareamento

$env:WHATSAPP_ENABLED = 'true'
$env:WHATSAPP_MODE = 'self-chat'
[Environment]::SetEnvironmentVariable('WHATSAPP_ENABLED', 'true', 'User')
[Environment]::SetEnvironmentVariable('WHATSAPP_MODE', 'self-chat', 'User')
hermes whatsapp

No celular: WhatsApp → Configurações → Aparelhos conectados → Conectar um aparelho. Aponte a câmera para o QR Code do terminal.

Depois informe o número que poderá controlar o agente. Digite apenas números, com código do país, sem + nem espaços.

PowerShell — controle de acesso

$meuNumero = Read-Host 'Digite SEU NUMERO DO WHATSAPP com código do país, somente números'
$env:WHATSAPP_ALLOWED_USERS = $meuNumero
[Environment]::SetEnvironmentVariable('WHATSAPP_ALLOWED_USERS', $meuNumero, 'User')
Write-Host 'Somente este número poderá controlar o agente.' -ForegroundColor Green

Não use * se você não quer liberar o agente para qualquer pessoa.

Ligar o gateway

PowerShell — deixar o agente respondendo

hermes gateway

Não feche essa janela. Envie uma mensagem pelo WhatsApp autorizado:

Olá. Responda em uma frase dizendo seu nome e como você pode me ajudar.

Se responder, está funcionando.

O que fica funcionando e o que para?

Continua funcionando quando:

o PowerShell permanece aberto;
o computador está ligado;
há internet;
a sessão do WhatsApp continua vinculada.

Para quando:

o terminal é fechado;
o computador é desligado;
o computador entra em suspensão;
o processo trava ou perde a sessão.

Para trabalhar 24 horas, o Hermes precisa ficar em um computador sempre ligado ou em um servidor. Faça primeiro o teste local; hospedagem pode ter custo.

Se alguma coisa der errado

Hermes não reconhecido: feche e abra o PowerShell novamente.
Erro 401: repita a etapa da chave e confira se ela começa com sk-or-.
Modelo não encontrado: rode hermes model e escolha outro modelo atual com :free.
QR ilegível: maximize o terminal; ele deve ter pelo menos 60 colunas.
Não responde: confirme que a janela com hermes gateway continua aberta.