HERMES AGENT: O GUIA COMPLETO. Do Zero ao Funcionário de IA com Autoaperfeiçoamento

Estou executando o Hermes Agent 24 horas por dia, 7 dias por semana, há meses. Aqui está tudo o que aprendi: instalação, modelos, casos de uso, o painel que 99% das pessoas usam errado, autoaperfeiçoamento, segurança. Tudo isso.

Marque isto como favorito. Você vai precisar quando começar a construir.

Índice

1. O Que o Hermes Agent Realmente É
2. Hermes vs OpenClaw vs Claude Code
3. Instalação
4. Seleção de Modelos — O Que Usar para Cada Coisa
5. Plataforma de Mensagens
6. Primeiras Coisas a Fazer
7. O Painel
8. Casos de Uso
9. Autoaperfeiçoamento — A Vantagem Real
10. Segurança
11. Apêndice: Referência Completa de Comandos

CAMADA 1 — O QUE O HERMES AGENT REALMENTE É

O Hermes Agent é um funcionário de IA autônomo 24 horas por dia, 7 dias por semana, criado pela Nous Research.

Um agente que trabalha enquanto você dorme, descobre tarefas de forma proativa alinhadas aos seus objetivos e melhora a cada sessão.

Três coisas o diferenciam de todo o resto:

Memória. Tudo vive em arquivos markdown no seu computador — não na nuvem, não em uma caixa preta. Na sua máquina. Você pode ler, editar, excluir. Transparência total.

Autoaperfeiçoamento. Cada tarefa concluída é revisada. O que funcionou. O que não funcionou. Como fazer melhor da próxima vez. Ele edita suas próprias habilidades após cada sessão.

Recuperação de sessão. Cada conversa que você já teve é registrada com pesquisa de texto completo FTS5 e sumarização por LLM. Pergunte sobre o que você conversou há 3 meses. Ele sabe.

CAMADA 2 — HERMES vs OPENCLAW vs CLAUDE CODE

Três ferramentas. Três trabalhos diferentes. Aqui está onde cada uma se encaixa.

Hermes vs OpenClaw

O OpenClaw ficou inchado. Parece lento. E as atualizações quebram tudo — todas elas. Para quem vive com agentes de IA, isso é doloroso. Para quem é novo em agentes, é um impeditivo.

O Hermes é mais leve, mais rápido, e as atualizações não destroem sua configuração. Essa confiabilidade por si só já é motivo para mudar agora.

Vantagens adicionais do Hermes:

• Multiagente integrado via Kanban (v0.12.0+) — agentes pegam tarefas de um quadro, trabalham em paralelo, passam adiante quando bloqueados
• Nous Portal com modelos selecionados integrados
• 166 habilidades rastreadas (87 inclusas + 79 opcionais) em mais de 26 categorias
• Mais de 20 plataformas de mensagens: Telegram, Discord, Slack, WhatsApp, Signal, Matrix, Teams e mais

Hermes vs Claude Code vs Codex

Ferramentas diferentes. Trabalhos diferentes. Use ambos.

Hermes = seu funcionário de uso geral. Tarefas do dia a dia. Pesquisa. Documentos. Planilhas. Administração do computador. Consultor de negócios. Protótipos. Tudo que precisa melhorar continuamente ao longo do tempo. Pense nele como seu Chefe de Gabinete.

Claude Code / Codex = sessões de codificação focadas e profundas. Aplicativos complexos de grande escala. Testes de ponta a ponta. Duas janelas abertas lado a lado. Você está totalmente focado. É aí que você recorre ao Claude Code ou Codex.

O Hermes cuida de todo o resto para que você possa se aprofundar quando precisar.

CAMADA 3 — INSTALAÇÃO

Um comando. Só isso.

Linux / macOS / WSL2:

Windows (nativo, PowerShell) — beta inicial:

Android (Termux): o mesmo comando curl do Linux — o instalador detecta o Termux automaticamente.

Após a instalação, comece com:

A configuração rápida te guia pela seleção de modelos e plataforma de mensagens.

Se você tiver o OpenClaw instalado: receberá uma opção para importar memórias. Recomendação: comece do zero. Dois agentes separados com memórias e habilidades separadas é melhor do que mesclar tudo.

CAMADA 4 — SELEÇÃO DE MODELOS

Três níveis. A escolha certa depende do que você está fazendo, não apenas do orçamento.

Caro — claude-opus-4 / claude-sonnet-4

Melhor para: raciocínio complexo, tarefas /goal longas, escrita diferenciada, função de consultor de negócios. O Claude lida com ambiguidade melhor do que qualquer outro modelo. Quando o Hermes precisa tomar decisões no meio da tarefa — opus-4. Quando você quer velocidade com 90% da qualidade do opus — sonnet-4.

Um detalhe: a Anthropic desativou o OAuth para agentes. Chave de API necessária — você paga por token. Orçamento: algumas centenas de dólares por mês com uso intenso.

Moderado — GPT-5.5

Melhor para: tarefas de codificação, prototipagem, uso diário com orçamento limitado. O GPT-5.4 e anteriores eram quase inúteis dentro de agentes. O GPT-5.5 mudou isso. Funciona com sua assinatura existente do ChatGPT de $20/mês. Muito mais uso do que a Anthropic por uma fração do custo.

Comece por aqui se você é novo no Hermes. Mude para o Claude depois que souber quais tarefas precisam da atualização.

Acessível — Qwen 3.7 Max, Grok, Nous Portal

Qwen 3.7 Max — melhor para tarefas autônomas de longo prazo. 35 horas de execução contínua, mais de 1.000 chamadas de ferramentas sem perder o contexto. Modelo principal no seletor selecionado do OpenRouter (PR #32809). Use via OpenRouter ($0 por token no nível gratuito até os limites).

XAI Grok — melhor se você já paga pelo SuperGrok. OAuth funciona. Forte em tarefas relacionadas ao X e pesquisa. Combina bem com a habilidade xurl.

Nous Portal — $20/mês fixos, modelos selecionados, criado pela equipe do Hermes. Ponto de partida para quem quer uma única conta e sem gerenciamento de chaves de API.

Referência rápida de tarefa para modelo

Mude de modelos a qualquer momento:

Sem alterações de código, sem reinstalação. Perfis diferentes podem executar modelos diferentes simultaneamente.

CAMADA 5 — PLATAFORMA DE MENSAGENS

Telegram. Configure. Não pense demais nisso.

O Telegram é a única plataforma de mensagens que está ativamente construindo para agentes de IA. Tópicos. Comunicação agente a agente. Adicionando recursos constantemente. Gratuito.

Configuração: O Hermes te guia durante a instalação. Copie um token do BotFather do Telegram para o Hermes. Pronto. Cinco minutos no total.

Outras plataformas suportadas, se precisar: Discord, Slack, WhatsApp, Signal, Matrix, Mattermost, Email, SMS, DingTalk, Feishu, Microsoft Teams, Google Chat e mais. Mais de 20 no total a partir de um único processo de gateway.

CAMADA 6 — PRIMEIRAS COISAS A FAZER

Dia um com um novo funcionário: você diz a ele quem você é.

Passo 1: Conte ao Hermes sobre você

Envie isto como sua primeira mensagem (preencha seus dados):

Isso vai para a memória. Todas as tarefas proativas que o Hermes fizer a partir de agora serão filtradas por esses objetivos. Pule esta etapa e ele estará trabalhando às cegas.

Passo 2: Configure seu primeiro cron job

Cron jobs são tarefas autônomas agendadas. Em português claro. Sem código.

Acorde todas as manhãs com algo novo construído para você. Esse é o seu agente trabalhando.

Passo 3: Aprenda /goal

/goal é o comando mais poderoso do Hermes. Ele transforma o agente de um chatbot reativo em um trabalhador de segundo plano. Você define um objetivo, o Hermes divide em tarefas, executa autonomamente e continua até concluir.

Comandos principais do /goal:

Para o guia completo do /goal, incluindo 21 fluxos de trabalho prontos para copiar e colar para pesquisa, vendas, conteúdo, e-mail, operações e desenvolvimento → O Manual Completo do /goal do Hermes

Para um mergulho profundo em como escrever bons objetivos, configurar max_turns e evitar os erros mais comuns → Hermes /goal — O Guia Completo

CAMADA 7 — O PAINEL (99% USAM ERRADO)

Abre no navegador em localhost:9119.

Abra a aba Skills primeiro. É lá que está o valor real.

Aba Models

Troque de modelos instantaneamente. Sem necessidade de terminal. Defina modelos diferentes por perfil.

Aba Cron

Veja todas as tarefas agendadas. Crie tarefas complexas manualmente aqui com mais controle do que digitando no Telegram.

Aba Skills

Todas as habilidades que o Hermes aprendeu estão aqui. Navegue, ative/desative, leia o markdown.

Um agente bem utilizado: mais de 150 habilidades. Ele conhece seus fluxos de trabalho específicos pelo nome. Ele pode fazer coisas que você nunca ensinou explicitamente porque aprendeu observando você.

Habilidades integradas que você deve ativar imediatamente:

• Automação de navegador — permite que o Hermes navegue na web, extraia dados, interaja com páginas
• Uso do computador — permite que o Hermes controle sua tela, mova arquivos, abra aplicativos
• Geração de imagens — conecta-se aos modelos de imagem OpenAI ou Grok, gera assets no meio da tarefa
• Geração de vídeos — gera vídeos diretamente de suas conversas

Aba Plugins

Capacidades extras via chaves de API. Ative browser-use, fire-crawl, computer-use. Adicione qualquer chave de API que você já possui para estender o que o Hermes pode fazer.

Aba Profiles

Esta é a configuração multiagente.

Um perfil = um agente Hermes com suas próprias memórias, habilidades e modelo. Crie vários perfis para diferentes funções: Chefe de Gabinete, Diretor de Conteúdo, Agente de Pesquisa, Engenheiro de DevOps.

Execute-os simultaneamente. Cada um especializado. Cada um melhorando de forma independente.

Quadro Kanban — a tela mais poderosa

Como usar corretamente:

Todas as manhãs, anote sua lista de tarefas. Pegue todas as tarefas que um agente de IA pode realizar. Coloque-as no Triage. Afaste-se. Tome o café da manhã.

O que acontece automaticamente:

1. O Hermes pega cada tarefa do Triage
2. Divide em subtarefas
3. Move para To-Do
4. Atribui subtarefas a subagentes
5. Eles executam em paralelo

Quando o café da manhã termina, metade da sua lista de tarefas está concluída.

Status: Triage → To-Do → Ready → In Progress → Blocked → Done

O daemon é executado continuamente (v0.16+), verificando novas tarefas a cada 60 segundos. Sem polling baseado em cron, sem desperdício de tokens entre tarefas.

CAMADA 8 — CASOS DE USO

1. Tutor Diário

Encontrou um vídeo útil no YouTube? Não assista apenas e esqueça.

Dê uma olhada neste vídeo. Leia a transcrição. Então, todas as manhãs às 8h, lembre-me de um ou dois conceitos do vídeo e depois me pergunte sobre eles. [cole o link do YouTube]

O Hermes puxa a transcrição, extrai 10 conceitos-chave, agenda um cron job. Toda manhã às 8h: lição + teste enviados para o Telegram.

Use isso para cada vídeo educacional que você assistir. Você para de esquecer tudo.

1. Administrador de Computador

Instale o Tailscale (gratuito) em todos os seus dispositivos. Agora o Hermes pode se mover por todas as suas máquinas.

No seu celular, em qualquer lugar do mundo:

Pegue o arquivo agent.md do meu Mac Studio e coloque no meu MacBook Pro.

Pronto. Qualquer arquivo. Qualquer dispositivo. Sem SSH, sem Google Drive, sem transferência manual.

Também funciona para desenvolvedores: teste hosts locais em execução em outras máquinas sem estar fisicamente naquele computador.

1. Recuperação de Sessão

Lembre-me de toda ideia de negócio que discutimos no mês passado.

Toda conversa registrada. Toda ideia que você mencionou — recuperada sob demanda. Os links que você compartilhou há 2 meses. O que você estava construindo há 3 meses.

Nenhum outro agente de IA tem isso. Pesquisa de texto completo FTS5 com sumarização por LLM em todo o seu histórico.

1. Fluxo de Trabalho de Conteúdo no X com xurl

xurl é uma habilidade do Hermes que dá ao seu agente acesso direto ao X — pesquisando posts, lendo discussões, publicando conteúdo.

Por si só, é uma ferramenta de execução. Combinada com /goal, habilidades de pesquisa e memória, torna-se um sistema de conteúdo recorrente.

O fluxo de trabalho que funciona:

hermes goal "Todas as manhãs e noites, pesquise as discussões mais recentes sobre agentes de IA, analise em relação ao meu estilo de conteúdo, verifique tópicos já publicados, gere um thread, avalie a pontuação de viralidade e publique via xurl se passar no crivo."

Estruture em etapas: Coleta de Dados → Verificação de Estilo → Verificação de Repetição → Rascunho → Pontuação de Qualidade → Decisão de Publicação.

Erro chave: não deixe publicar automaticamente no primeiro dia. Revise as saídas manualmente por 5 a 7 execuções primeiro.

Para o fluxo de trabalho completo do xurl + /goal com configuração passo a passo → Como Fazer o Hermes + xurl Funcionarem de Verdade como um Sistema

1. Central de Comando

Peça ao Hermes para construir um painel personalizado para você:

Crie uma central de comando para mim onde possamos adicionar ferramentas para melhorar nossos fluxos de trabalho. Comece com: - Um pipeline de conteúdo onde eu possa adicionar ideias e você as desenvolva - Uma wiki de memória mostrando tudo em que trabalhamos - Uma página de documentos mostrando todos os artefatos que criamos

Sem necessidade de código. Descreva o que você quer. Ele constrói.

Adicione ferramentas conforme precisar. Seu painel se torna uma interface personalizada construída para a sua forma de trabalhar.

1. Construtor de Protótipos

Na academia. Teve uma ideia. Puxe o Telegram.

Crie uma landing page para [ideia]. Uma página. Seção Hero, 3 recursos, preços, CTA. Faça o deploy em localhost. Envie-me o link.

Volte em uma hora. O protótipo está pronto.

O Hermes conhece sua stack pela memória. Ele não pergunta qual framework você usa. Ele usa o que você sempre usa.

1. Consultor de Negócios

Estou pensando sobre [decisão ou problema]. Aqui está o contexto: [cole o contexto]. Quais são os 3 argumentos mais fortes a favor e contra? O que você faria?

Diferente do ChatGPT, o Hermes conhece seu negócio, seus objetivos, suas restrições. O conselho é filtrado pela sua situação real, não por um framework genérico.

1. Execuções /goal Noturnas

Dê ao Hermes uma tarefa complexa antes de dormir.

/goal crie um relatório de pesquisa de concorrentes sobre [concorrente 1], [concorrente 2], [concorrente 3]. Cubra: preços, conjunto de recursos, estratégia de conteúdo, posts de melhor desempenho nos últimos 30 dias, tamanho estimado da equipe, financiamento recente ou notícias. Formate como um documento markdown estruturado. Salve em arquivo.

Acorde com um relatório de pesquisa que levaria um dia inteiro para um analista humano.

Funciona para: refatoração de código, migrações de banco de dados, criação completa de aplicativos, auditorias de SEO, calendários de conteúdo.

Defina max_turns mais alto para tarefas noturnas complexas:

O padrão é 5-10. Aumente apenas quando a tarefa realmente precisar de mais etapas:

Não aumente sem motivo. Cada turno custa tokens.

1. Organograma Multiagente

O multiagente é onde o organograma se torna real.

Crie perfis separados para cada função:

Perfil: Chefe de Gabinete soul.md: Você coordena todos os outros agentes. Briefing matinal às 7h. Delegue pesquisa ao Diretor de Pesquisa. Delegue conteúdo ao Diretor de Conteúdo. Reporte-se com um resumo consolidado.

Perfil: Diretor de Pesquisa soul.md: Você encontra informações. Monitore o X em busca dos melhores posts em [nicho]. Acompanhe a atividade dos concorrentes. Envie um boletim de inteligência semanal.

Perfil: Diretor de Conteúdo soul.md: Você produz conteúdo. Rascunhe posts com base nos briefings de pesquisa. Reaproveite artigos em 5 formatos. Mantenha o calendário de conteúdo.

Um briefing matinal no Telegram. Múltiplos agentes trabalhando em paralelo. Você lê o resultado.

CAMADA 9 — AUTOAPERFEIÇOAMENTO (A VANTAGEM REAL)

O ciclo de autoaperfeiçoamento é o que nenhum outro agente tem.

O ciclo:

1. Você dá uma tarefa ao Hermes
2. Ele executa
3. Após a conclusão, ele revisa: o que funcionou, o que não funcionou, o caminho ideal
4. Ele salva isso como uma habilidade em ~/.hermes/skills/
5. Da próxima vez que você der a mesma tarefa, ele usa essa habilidade diretamente

Você o corrige uma vez. Ele nunca mais comete esse erro.

Seis meses depois, ele conhece seu trabalho melhor do que um assistente humano conheceria:

• Como você gosta que as coisas sejam formatadas
• Quais ferramentas funcionam para seus fluxos de trabalho específicos
• Qual tom você prefere em diferentes contextos
• Quais atalhos tomar e quais evitar

As habilidades são transparentes. Elas vivem como arquivos markdown no seu computador. Você pode abri-las, lê-las, editá-las. Sem caixa preta.

As atualizações adicionam novas habilidades automaticamente. Uso do computador. Geração de vídeos. Suporte ao Qwen 3.7 Max. Toda atualização da Nous Research expande o que ele pode fazer sem quebrar o que já funciona.

Para ver todas as ferramentas disponíveis e configurá-las:

Ative imediatamente: browser-automation, computer-use

CAMADA 10 — SEGURANÇA (A VISÃO HONESTA)

As preocupações de segurança com o Hermes são extremamente exageradas para uso básico.

Ele só faz o que você manda.

Peça para construir uma apresentação — ele constrói uma apresentação. Ele não vai abrir sua pasta de fotos. Peça para verificar um placar — ele verifica o placar. Ele não vaza suas mensagens para lugar nenhum.

O único evento de segurança catastrófico possível é se você mandar ele fazer algo catastrófico. Pense antes de escrever o prompt. Esse é o modelo básico de segurança.

O que você NÃO precisa para uso pessoal:

• Uma conta iCloud separada
• Uma conta Google dedicada
• Um VPS (recomendações de VPS de YouTubers de IA são conteúdo patrocinado — eles mesmos não usam)

O que você PRECISA:

• Bom senso
• Revisar os prompts antes de apertar Enter em algo destrutivo
• A regra básica no seu soul.md: "Nunca envie dinheiro para ninguém sem confirmação explícita"

Instale no seu computador principal. Use o bom senso. Só isso.

Se algo quebrar: abra a pasta do Hermes no Claude Code ou Codex, diga "Estou com este problema, por favor resolva." Resolve 100% dos problemas.

Para agentes de produção que lidam com sistemas sensíveis, o Hermes vem com uma stack de segurança adequada:

Camada 1 — Bitwarden Secrets Manager (gerenciamento de credenciais)

Um token de inicialização no .env. Todas as credenciais reais ficam no Bitwarden. Cada instância do Hermes puxa os segredos na inicialização. Gire uma chave uma vez no web app — todas as instâncias capturam na próxima reinicialização. Revogação instantânea pela interface web. Nível gratuito.

Camada 2 — iron-proxy egress firewall (proteção de credenciais)

Em vez de injetar credenciais reais no sandbox, o Hermes dá ao agente tokens de proxy opacos. O iron-proxy intercepta no limite da rede, troca pela credencial real, encaminha a solicitação. O sandbox nunca guarda a chave real. Comprometa o sandbox — o invasor obtém tokens que só funcionam por trás do proxy.

As duas camadas se compõem: gire no Bitwarden, propaga para todos os sandboxes automaticamente. Uma ação em uma interface web, propagação total em todo o parque.

Para a análise completa da arquitetura, incluindo como ela se compara ao CrewAI, LangGraph e LangChain → Hermes x Bitwarden — A Stack de Segurança que Agentes de IA Realmente Precisam

O Verdadeiro Insight

ChatGPT e Claude são poderosos. Cada conversa começa do zero. Sem memória. Sem melhoria. Sem contexto. Pare de usar um por uma semana e é como se vocês nunca tivessem se conhecido.

O Hermes se acumula.

Dia 1: ele não sabe nada sobre você. Mês 1: ele sabe como você trabalha e o que está construindo. Mês 6: ele sabe como você pensa, quais tarefas você faz todos os dias e a maneira ideal de fazer cada uma.

Memória. O ciclo de melhoria. Confiança. Essas três coisas são o gargalo nos agentes de IA. Os modelos estão resolvidos.

O Hermes Agent resolve os três. Código aberto. $0 pelo próprio agente.

A stack está pronta. Configure e use.

→ Siga — modelos de agentes de IA toda semana

→ Salve isto — os prompts de configuração valem a pena serem marcados como favoritos

→ Comente "HERMES" e eu enviarei o template completo do soul.md + cron job para o seu caso de uso

Recursos

Oficial:

• Documentação do Hermes Agent — instalação, configuração, referência completa da CLI
• Skills Hub — habilidades da comunidade, navegue e instale
• GitHub — código-fonte, issues, PRs

Meus artigos sobre Hermes:

• O Manual Completo do /goal do Hermes — 21 Fluxos de Trabalho — comandos /goal prontos para copiar e colar para cada função de negócio
• Hermes /goal — O Guia Completo — execução autônoma, max_turns, melhores práticas
• Como Fazer o Hermes + xurl Funcionarem de Verdade como um Sistema — fluxo de trabalho de conteúdo recorrente no X
• Hermes x Bitwarden — A Stack de Segurança que Agentes de IA Realmente Precisam — gerenciamento de credenciais de produção + firewall de saída

@NousResearch @Teknium