Como se tornar um Operador de Agente Hermes

Aprenda a operar e dominar o Hermes Agent. Configure o template da sala de controle do agente, configure agentes especialistas e evolua de um único agente para uma empresa de marketing completa em um único VPS.

A maioria das ferramentas de IA responde perguntas. O Hermes Agent executa seus fluxos de trabalho do início ao fim.

Ele navega pelo seu navegador, executa comandos no terminal, agenda tarefas cron, monitora suas caixas de entrada, redige o trabalho e publica o resultado onde você estiver: Telegram, Discord, Slack, no tópico de e-mail em que você está agora.

Criado por @NousResearch, é open source com 150.000 estrelas no GitHub. Atualmente ocupa o primeiro lugar no OpenRouter em uso global de tokens.

É a estrutura na qual construí toda a minha operação de marketing nas últimas semanas, e o artigo que você está prestes a ler é como eu a configuraria se estivesse começando hoje.

O que você vai aprender neste artigo

• O que é o Hermes Agent e por que profissionais de marketing (não apenas desenvolvedores) deveriam se importar
• A versão amigável da arquitetura: o cérebro, a personalidade, o conjunto de habilidades e como tudo vive em uma única pasta
• Os casos de uso que estou executando pessoalmente no Hermes, com as quatro postagens que publiquei sobre eles
• O modelo mental de quatro partes (você, sala de controle, agentes, barramento de tarefas opcional) e os quatro níveis de configuração, de "um agente no seu laptop" a "uma equipe de agentes totalmente automatizada em um VPS que você controla pelo celular"
• A metodologia de protótipo → produção que uso para transformar um fluxo de trabalho de marketing de uma ideia confusa em uma implantação autônoma
• Os recursos que eu gostaria de ter tido no primeiro dia: documentação, o atlas da comunidade, as pessoas a seguir, os encontros que estão acontecendo agora
• As concessões honestas e onde isso ainda falha

Não estou vendendo nada neste artigo. O Hermes é open source, o Nous Portal tem um nível gratuito, e a maior parte do ecossistema da comunidade também é gratuita. Faça um fork, modifique, torne-o seu.

O que é o Hermes Agent

Versão curta: um agente autônomo que se torna mais capaz quanto mais tempo funciona.

Versão mais longa: o Hermes é uma estrutura criada pela Nous Research que transforma um modelo em um operador persistente. Ele tem sua própria memória que sobrevive entre as sessões. Ele escreve suas próprias habilidades enquanto trabalha. Ele já vem com 123 habilidades integradas (fluxos de trabalho do GitHub, Obsidian, Google Workspace, Linear, Notion, Typefully, Perplexity, Deep Research, além de mais de 100 outras). Ele vive onde você o colocar: no seu laptop, em um contêiner Docker, em um VPS, em um ambiente serverless. E você pode falar com ele através de mais de 20 superfícies: Telegram, Discord, Slack, e-mail, modo de voz ou apenas seu terminal.

Se você já usou Claude Code ou OpenClaw, o Hermes tem o mesmo formato com uma filosofia diferente.

Hermes é como trilhos. Configurações padrão opinativas, baterias incluídas, produtivo no primeiro dia com configuração mínima, o agente faz mais pensamento por você.

OpenClaw é como Linux. Primitivas, garantias, controle explícito, o agente faz exatamente o que você mandou e nada mais.

Ambos são válidos. Eu uso o Hermes porque os padrões integrados se acumulam. Cada projeto que inicio com o Hermes é um onde o agente já sabe fazer mais de 100 coisas antes de eu escrever uma linha de configuração. Essa vantagem inicial vale a pena para mim. Também notei que o Hermes não tem nem de longe o mesmo problema de desconexão do gateway ou travamento.

A prova está nos números que a Nous Research acabou de atingir:

• Primeiro lugar no OpenRouter em uso global de tokens (entre todos os modelos e estruturas na plataforma)
• 150.000 estrelas no GitHub no repositório do Hermes
• 123 habilidades integradas antes do agente escrever uma própria
• Mais de 70 ferramentas integradas no gateway, além de mais de 300 modelos através de uma assinatura
• 6 alvos de implantação: local, Docker, SSH, Daytona, Singularity, Modal
• Mais de 20 superfícies de mensagens: Telegram, Discord, Slack, e-mail, voz

Se você é um profissional de marketing de IA e ainda não começou a usar o Hermes, está deixando de acumular capacidades a cada semana.

Como funciona (a versão amigável)

Cada agente Hermes tem três coisas.

Um cérebro. A memória fica em ~/.hermes/memories/. Dois arquivos, MEMORY.md e USER.md, são injetados no início da sessão. Sua rubrica de voz, suas notas de marca, a linguagem do cliente, as correções da semana passada, tudo isso carrega antes do primeiro prompt. As sessões são armazenadas em SQLite, e a recuperação entre sessões é pesquisável por texto completo.

Uma personalidade. O soul.md é onde a vibe vive. Conciso. Sarcástico. Direto. Formal. Rápido ou reflexivo. Você pode criar seis agentes e dar a cada um uma alma diferente, com o mesmo cérebro por baixo. Um é seu representante de vendas externas com energia de fechador. Outro é seu pesquisador que gosta de frases longas. Outro é seu assistente que mantém tudo curto.

Um conjunto de habilidades. 123 habilidades prontas para uso: PRs do GitHub, Obsidian, Google Workspace, Linear, Notion, Typefully, Perplexity, Deep Research, controle de navegador, raspagem web, visão, voz, agendamento. E o ciclo de aprendizado fechado: enquanto o agente trabalha, ele escreve novas habilidades ao longo do caminho. Sua própria biblioteca de habilidades cresce em cima das 123 sem que você precise escrever nenhuma delas.

Depois, há com o que o agente pode conversar.

• O gateway de ferramentas: uma assinatura, mais de 300 modelos, além de raspagem web e automação de navegador integradas
• Integração MCP: qualquer serviço externo que fale o Model Context Protocol se torna uma ferramenta que seu agente pode usar
• Mais de 20 superfícies de mensagens: Telegram, Discord, Slack, e-mail, voz, além do próprio CLI

E onde o agente pode viver.

• Seu laptop (local)
• Um contêiner Docker (isolado, portátil, do jeito que eu uso)
• Uma sessão SSH em um VPS (para funcionar mesmo quando seu laptop está fechado)
• Daytona, Singularity, Modal (serverless, se você não quiser gerenciar infraestrutura)

O ciclo de aprendizado fechado é o que torna isso diferente de um chatbot inteligente. O agente observa seu próprio trabalho, escreve novas habilidades à medida que aprende a forma do seu trabalho, refina sua memória periodicamente e recupera contexto passado entre sessões usando uma combinação de pesquisa de texto completo e sumarização por LLM. Você não precisa reensiná-lo na próxima semana.

A regra que digo para quem é novo no Hermes é esta: não tente escrever suas próprias habilidades no primeiro dia. Execute trabalho real, deixe o agente observar e deixe a estrutura escrever as habilidades. Você constrói uma biblioteca de habilidades personalizada mais rápido trabalhando do que escrevendo prompts.

O que estou executando no Hermes

Sou um profissional de marketing de IA, não um programador. A maior parte do que executo no Hermes é infraestrutura de marketing com alguma ferramenta interna ocasional. Aqui está a lista real:

• Um assistente pessoal que lida com questões profissionais e pessoais, vive no Telegram, sinaliza os quatro e-mails que valem a pena ler todas as manhãs, agenda meus lembretes, resume reuniões que perdi
• Uma bancada de prototipagem de fluxos de trabalho de marketing onde testo novos fluxos (ímã de leads, revisão de criativos publicitários, sprint de conteúdo) em trabalho real por 2 a 3 execuções antes de promovê-los
• Agentes de marketing especializados: SEO, vendas externas/desenvolvimento de negócios, revisão de design, redação de conteúdo, cada um com sua própria alma e seu próprio escopo
• Um cérebro da empresa que monitora Slack, chats, e-mails, transcrições, notas de voz, e torna tudo pesquisável. Quando pergunto "o que dissemos àquele cliente sobre preços no mês passado", recebo a resposta em 3 segundos em vez de 30 minutos de pesquisa
• Um agente de SEO que executa o pipeline completo, da semente de palavra-chave ao artigo publicado, em um único contêiner Docker, 21 etapas, sem intervenção humana até a revisão final
• Um agente de distribuição de conteúdo que pega uma peça de formato longo (este artigo, por exemplo) e a atomiza em LinkedIn, X, Threads, com hooks específicos para cada plataforma
• Um agente orquestrador que não produz trabalho em si, apenas encaminha solicitações para o especialista certo com base no que estou pedindo

O blueprint que postei resumindo:

O agente de SEO em particular merece um zoom, porque é o que publiquei publicamente e o que mapeia mais claramente para a arquitetura no resto deste artigo. Cinco camadas, tudo dentro de um contêiner Docker, 21 etapas da semente de palavra-chave ao artigo publicado.

As 21 etapas ficam assim no terminal:

As camadas acima deste pipeline:

1. Cérebro da empresa no topo: visão, marca, público, produtos. Cada agente lê a partir daqui.
2. Agente orquestrador Hermes: pega o tópico ou semente de palavra-chave e o encaminha para o agente de SEO.
3. Cérebro de SEO: manual de ranqueamento, regras de voz, formatos de conteúdo, guia de estilo visual, critérios de sucesso por formato. Todo o contexto específico de SEO vive aqui.
4. Três subagentes dentro do agente de SEO, cada um lidando com uma fase:
5. Pesquisa + ideação: semente de palavra-chave, snapshot SERP, extração de concorrentes, análise de intenção e formato, lacuna de conteúdo e visual, validação interna e externa
6. Produção: briefing de posicionamento e ângulo, briefing de estratégia visual, esboço, rascunho, geração de imagem, geração de fluxograma, QA visual e do artigo
7. Distribuição: preparação para publicação, schema, links internos, sindicalização, análise, monitoramento
8. Um contêiner Docker contém todos os três subagentes. Eles compartilham env, memória e ferramentas. Os subperfis mudam de contexto por fase. Um processo, um sistema de arquivos, um conjunto de credenciais.

Por que um contêiner em vez de três: o trabalho de SEO é sequencial. A pesquisa alimenta o briefing, o briefing alimenta a produção, a produção alimenta a distribuição. Cada etapa precisa de memória do que foi decidido upstream. Dividir em três contêineres significa transportar estado entre fronteiras, o que fica caro e quebra a corrente.

Cada outro agente especializado na empresa roda no mesmo template. Clone o template do agente de SEO, troque o cérebro (cérebro de SEO → cérebro de vendas externas, ou → cérebro de design, ou → cérebro de suporte), e você tem um novo agente para qualquer função com a mesma forma de cinco camadas.

As camadas não são decoração. Elas são a razão pela qual o agente não perde o contexto à medida que o trabalho se especializa. O cérebro da empresa permanece estável enquanto o trabalhador itera. As camadas do cérebro tornam o trabalhador descartável.

Também recebi a Nous Research na sede da @EspressioAI em Lisboa para uma noite do Hermes Agent recentemente. O @yeahfortommy da Nous conduziu um Q&A, o Simão da noticed .so mostrou uma estrutura de agente com pesquisa automática, e eu expliquei como estamos usando o Hermes para crescimento na Espressio.

Se você está em Lisboa e quer vir ao próximo, vou postar quando for agendado.

De um agente a uma frota completa

Antes dos níveis, o modelo mental.

A configuração tem quatro partes:

• Você é o operador. Você tem acesso direto a todas as partes do sistema.
• A sala de controle do agente é o plano de controle secundário. Não é um agente com o qual você conversa. É uma pasta em /root/vps-agents que documenta e governa toda a frota. Você a abre, edita, inspeciona ou pede para Claude, Codex ou Hermes usá-la quando estiver gerenciando o sistema.
• Os agentes Hermes são os trabalhadores. Alguns são especialistas (SEO, dev, CMO, ops). Um deles pode opcionalmente ser um orquestrador.
• O barramento de tarefas do agente é uma mesa de transferência opcional que fica entre o orquestrador e os especialistas. Você só precisa dele quando tem um orquestrador em jogo.

A coisa toda se parece com isto:

A divisão de armazenamento é mais importante do que as pessoas pensam:

A sala de controle contém as respostas para perguntas como: quais agentes existem, o que fazem, quais portas usam, a quais credenciais se referem, o que cada agente pode e não pode fazer, e como reiniciar, depurar ou reconstruir qualquer um deles. O runtime ativo contém o funcionamento real.

A sala de controle é o cérebro que define o sistema. O runtime ativo é o corpo que o executa. Você pode reconstruir o corpo a partir do cérebro. Você não pode reconstruir o cérebro a partir do corpo.

Dentro da sala de controle:

E dentro do runtime de cada agente em /srv/<nome-do-agente>/data/:

Três maneiras de interagir

• Caminho de controle é a camada meta. Usado ao adicionar agentes, revisar documentos, verificar portas, rotacionar chaves, depurar a configuração.
• Caminho direto é o mais rápido. Usado quando você já sabe qual agente faz o trabalho.
• Caminho orquestrado é o sintetizador. Usado quando você quer uma única porta de entrada que encaminha e combina trabalho entre vários especialistas.

Nível 1: Um agente

Você tem um agente Hermes. Só isso. A sala de controle ainda pode existir (recomendado), mas documenta apenas esse único agente.

Melhor para: configuração inicial, seu Hermes pessoal, documentação de instalação raiz, migração simples para Docker.

Um agente, vivido, com uma personalidade que você ajustou e uma memória que começou a ser construída. Preencha SOUL.md com a voz que você quer, MEMORY.md com os fatos estáveis sobre seu negócio e USER.md com os fatos estáveis sobre você. Conecte-o ao Telegram ou Discord para que ele viva onde você está. Comece a usá-lo em tarefas reais. Deixe-o tocar suas ferramentas. Deixe-o escrever suas próprias habilidades ao longo do caminho.

MEMORY.md contém os fatos estáveis (o que é seu negócio, quem são seus clientes, o que seus produtos fazem). USER.md contém os fatos estáveis sobre você (fuso horário, horário de trabalho, projetos recorrentes, formatos de saída preferidos). Ambos são refinados toda semana à medida que você corrige o agente em conversas reais.

Nível 2: Agentes especialistas diretos

Você tem vários agentes especializados, mas ainda fala com cada um diretamente. Ainda sem orquestrador.

A sala de controle documenta todos eles.

Melhor para: separação clara de funções, testar quais agentes são úteis, evitar orquestração prematura, manter credenciais com escopo por agente.

A armadilha a evitar aqui é buscar um orquestrador antes de provar que seus especialistas são úteis. Crie dois ou três, execute-os diretamente e só adicione um orquestrador quando perceber que quer uma única porta de entrada.

Quando criar um novo agente vs. ficar com o que você tem:

Padrão ruim: um mega-agente com todas as credenciais e todas as camadas de memória misturadas. Você perde isolamento, perde a capacidade de revogar acesso de forma limpa e o agente fica confuso sobre qual voz usar.

Nível 3: Orquestrador + especialistas

Você adiciona o hermes-orchestrator como uma porta de entrada. Ainda pode falar diretamente com os especialistas, mas o orquestrador pode encaminhar trabalho e sintetizar resultados.

O orquestrador lê a sala de controle para saber quais agentes existem, o que cada um faz, onde as filas de tarefas estão, o que requer aprovação, quais ações são proibidas e onde estão os documentos e runbooks. Ele não precisa perguntar nada disso a você, ele lê.

Melhor para: trabalho multifuncional, delegação, sumarização e síntese, uma interface principal para fluxos de trabalho com múltiplos agentes.

O orquestrador é o momento em que sua configuração deixa de ser uma coleção de agentes e começa a ser uma equipe. É também o momento em que a sala de controle mostra seu valor, porque o orquestrador é tão bom quanto os documentos que lê.

Como é uma verificação rápida da frota no meu laptop ou celular:

Nível 4: Equipe de agentes automatizada

Mesma forma do nível 3, mas com fluxos de trabalho recorrentes e automação mais forte. Relatórios semanais de SEO rodam em cron. Verificações de integridade do servidor são executadas diariamente. A verificação de backup ocorre sem você pedir. Fluxos de trabalho de negócios entre agentes são iniciados em horários programados.

Melhor para: relatórios semanais de SEO, operações de conteúdo, verificações de integridade do servidor, verificação de backup, fluxos de trabalho de negócios entre agentes.

O nível 4 é a aparência de um departamento de marketing no seu terminal. Ele não precisa que você inicie o dia. Ele aparece para trabalhar sozinho, arquiva relatórios, verifica a si mesmo e só te chama para as decisões que exigem bom gosto.

A hierarquia de controle

Um princípio para manter em mente enquanto você sobe os níveis.

A sala de controle é para configuração, documentos, runbooks e governança. Ela documenta quais agentes existem, o que fazem, onde rodam, a quais credenciais se referem, o que cada agente pode e não pode fazer. É o painel de administração da frota, incluindo o orquestrador. Não é onde você vai para fazer trabalho.

Para trabalhar, você fala diretamente com os agentes. Ou um especialista (quando você sabe qual agente é responsável pela tarefa) ou o orquestrador (quando você quer uma única porta de entrada para encaminhar entre especialistas).

O guia de configuração: Aponte seu agente para o repositório

Agora você entende a arquitetura. Aqui está como construí-la.

Publiquei um template público que contém a estrutura exata descrita acima, além das habilidades que seu agente precisa para configurá-la para você.

Ele está em github.com/shannhk/hermes-agent-control-room.

Você pode cloná-lo manualmente, mas a questão é que não precisa. Se você tem Claude Code ou Codex no seu laptop, os agentes fazem a maior parte do trabalho depois que você fornece uma chave de API da Hetzner.

O fluxo automatizado:

Em dez a quinze minutos você tem:

• Um VPS Hetzner novo com as ferramentas certas instaladas
• A sala de controle clonada em /root/agent-control-room no VPS
• As habilidades integradas vinculadas a ~/.claude/skills no VPS
• Um agente Hermes registrado, runbook preenchido, env-map escrito
• Um alias SSH no seu laptop para que ssh hermes conecte instantaneamente

A metodologia de protótipo → produção

A maioria dos fluxos de trabalho não começa como produção. Eles começam confusos. Um fluxo que executa pesquisa de SEO, redige um artigo, agenda no Typefully e publica no LinkedIn não existe totalmente formado na sua cabeça. Você o descobre executando-o.

O Hermes é o ambiente de prototipagem para isso. Aqui está o caminho de quatro etapas que uso para levar qualquer novo fluxo de trabalho de marketing da ideia à implantação autônoma:

1. Prototipe no Hermes. Abra seu agente Hermes principal, descreva o que deseja que aconteça e deixe-o tentar. Ele vai errar a maior parte na primeira execução. Tudo bem.
2. Execute 2 a 3 vezes em trabalho real, corrigindo os desvios cada vez. A estrutura observa cada correção e começa a escrever a habilidade à medida que aprende a forma. Na terceira execução, o agente está fazendo a maior parte do que você quer sem orientação.
3. Ajuste fino em um espaço de trabalho dedicado. Puxe o fluxo de trabalho para um espaço de trabalho separado do Claude Code (ou um agente Hermes novo, se preferir), aperte os prompts, trave o roteamento, adicione tratamento de erros, decida o que deve rodar em cron e o que deve ser acionado.
4. Implante em um VPS com agendamento. Depois que ele sobreviver uma semana de execuções reais sem você precisar supervisionar, envie-o para seu próprio contêiner Docker no seu VPS, configure o cron e se afaste.

Aprendi esse padrão depois de passar alguns fins de semana tentando escrever agentes de produção do zero. Você não pode escrever um agente de produção do zero. Você tem que cultivar um. O Hermes torna a parte do cultivo rápida.

1. Prototipe no Hermes
2. Ajuste fino em um espaço de trabalho dedicado
3. Implante autônomo em um VPS

Os modelos que executo no Hermes

O Hermes fornece a estrutura. O modelo subjacente é sua escolha. Através do gateway de ferramentas, você pode rotear para mais de 300 modelos com uma única assinatura, alternando por agente ou por tarefa.

O que eu executo pessoalmente hoje:

• Claude Opus 4.7 para o trabalho criativo: copywriting, voz, geração de hooks, redação de conteúdo, qualquer coisa onde gosto e qualidade de escrita importam
• Codex (GPT 5.5) para o trabalho estruturado: codificação, planejamento, fluxos de trabalho com várias etapas, automação de navegador, raspagem, qualquer coisa onde as etapas precisam ser precisas e a saída previsível

Eu executo ambos. O Opus escreve. O Codex constrói e planeja. O Hermes torna o roteamento fácil: você aponta cada agente para o modelo que se adequa ao trabalho que ele faz.

Se você só pode executar um, a resposta depende do tipo de trabalho que sua frota está fazendo. Pesado em conteúdo e copy? Comece com Claude Opus 4.7. Pesado em infraestrutura, automação e fluxos de trabalho de engenharia? Comece com Codex. Você sempre pode adicionar o segundo modelo mais tarde através do mesmo gateway de ferramentas.

Concessões honestas

Não vou fingir que o Hermes é perfeito. Três concessões reais.

1. Os padrões integrados também são opiniões. O Hermes vem com padrões fortes sobre como a memória funciona, como as habilidades são escritas, como o agente usa ferramentas. Essa é a proposta inteira. Mas também significa que, se você quer primitivas com controle explícito sobre cada etapa, o Hermes parecerá pesado. O OpenClaw é a melhor opção para esse gosto. Escolha a ferramenta que corresponde à sua filosofia.

1. Os níveis 3 e 4 têm uma curva de aprendizado real. Docker, VPS, SSH, a estrutura de pastas da sala de controle, as habilidades do orquestrador, nada disso é "instalar e usar". Você não deve pular para o nível 3 se já não estiver usando o Hermes no nível 1 diariamente.

1. O modelo ainda importa. O Hermes é uma estrutura que torna um bom modelo excelente. Ela não transforma um modelo pequeno em um estrategista. Use os modelos mais fortes que puder pagar para o trabalho que importa (seu orquestrador, seu agente de estratégia, seu cérebro). Use modelos mais baratos para o trabalho que não importa tanto (raspagem de pesquisa, geração de rascunhos, processamento em lote).

Nada disso é mágica. É uma estrutura que compensa porque a memória persiste, as habilidades se acumulam e os agentes permanecem com escopo definido. Aplique-a a um modelo de tamanho inadequado e você terá uma equipe confusa. Aplique-a ao modelo certo e você terá uma equipe.

Recursos

Se você está começando hoje, aqui está o que eu leria na ordem.

• A documentação oficial: hermes-agent.nousresearch.com/docs. Comece com o guia de instalação, depois leia a página de habilidades para entender o que vem pronto para uso.
• O template da sala de controle (meu repositório): github.com/shannhk/hermes-agent-control-room. A estrutura exata que descrevi acima, pronta para clonar. Template control-room-first para gerenciar agentes Hermes de um único agente VPS a equipes especializadas e fluxos de trabalho orquestrados. Faça um fork e torne-o seu.
• hermesatlas.com: O mapa curado pela comunidade de mais de 100 ferramentas open source, plugins, espaços de trabalho e integrações construídas no Hermes. Categorizado por domínio (provedores de memória, espaços de trabalho, registros de habilidades, implantação, orquestração). Também inclui o Hermes Handbook, um guia passo a passo para iniciantes. Atualizações semanais, newsletter gratuita.
• @Teknium no X: Fundador da Nous Research. Publica atualizações do Hermes quase diariamente. A integração do runtime Codex, o nível gratuito do DeepSeek V4 Flash no Nous Portal, as habilidades pretext, tudo veio através do feed dele primeiro.
• @NousResearch no X: A conta oficial, anúncios oficiais de recursos.
• Os encontros: Há encontros do Hermes acontecendo pessoalmente agora (Lisboa, Ventura, mais cidades). Vale a pena aparecer se houver um perto de você. Você aprende mais em 90 minutos de conversas paralelas do que em uma semana de leitura.

Espero que tenha tirado algum proveito disso. Agradeço por ter lido tudo.

-- Shann