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 passe de um único agente para uma agência 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 no seu navegador, executa comandos no terminal, agenda tarefas cron, monitora suas caixas de entrada, redige o trabalho e publica o resultado onde você preferir: Telegram, Discord, Slack, o tópico de e-mail que você está lendo agora.

Construído pela @NousResearch e é open source com 150.000 estrelas no GitHub. Atualmente está em #1 no OpenRouter em uso global de tokens.

É o framework no qual construí toda a minha operação de marketing nas últimas semanas, e o artigo que você está prestes a ler é como eu o 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) devem 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 eu pessoalmente executo 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 acontecendo agora
• As compensações honestas e onde isso ainda falha

Não estou vendendo nada para você 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 é executado.

Versão mais longa: o Hermes é um framework construído 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 runtime serverless. E você pode conversar 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. Padrões opinativos, baterias inclusas, produtivo no primeiro dia com configuração mínima, o agente faz mais trabalho de pensamento para 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 inclusos se acumulam. Cada projeto que inicio com o Hermes é um onde o agente já sabe fazer mais de 100 coisas antes mesmo 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 perto o mesmo problema de desconexão do gateway ou travamentos.

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

• #1 no OpenRouter em uso global de tokens (entre todos os modelos e frameworks na plataforma)
• 150.000 estrelas no GitHub no repositório do Hermes
• 123 habilidades inclusas 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 única 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 capacidade a cada semana.

Como funciona (a versão amigável)

Todo agente Hermes tem três coisas.

Um cérebro. A memória vive 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 seu cliente, as correções da semana passada, tudo isso é carregado antes do primeiro prompt. As sessões são armazenadas em SQLite, a recuperação entre sessões é pesquisável em texto completo.

Uma personalidade. O soul.md é onde a vibe vive. Conciso. Sarcástico. Direto. Formal. Rápido ou pensativo. 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 inclusas
• Integração MCP: qualquer serviço externo que fale 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 da própria CLI

E onde o agente pode viver.

• Seu laptop (local)
• Um contêiner Docker (isolado, portátil, do jeito que eu uso o meu)
• Uma sessão SSH em um VPS (para que funcione mesmo quando seu laptop estiver 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 se observa trabalhando, escreve novas habilidades à medida que aprende o formato 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 reensinar tudo na semana seguinte.

A regra que digo para quem está começando com o Hermes é esta: não tente escrever suas próprias habilidades no primeiro dia. Execute trabalho real, deixe o agente observar e deixe o arcabouço 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 cuida de 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 de anúncio, sprint de conteúdo) contra 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, memorandos de voz e torna tudo pesquisável. Quando pergunto "o que dissemos para aquele cliente sobre preços no mês passado", recebo a resposta em 3 segundos, em vez de 30 minutos de procura
• Um agente de SEO que executa o pipeline completo, desde a semente de palavra-chave até o 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 um formato longo (este artigo, por exemplo) e o atomiza no LinkedIn, X e Threads, com ganchos específicos para cada plataforma
• Um agente orquestrador que não produz trabalho em si, apenas roteia solicitações para o especialista certo com base no que estou pedindo

O modelo que publiquei que resumiu tudo:

O agente de SEO em particular merece destaque, porque é o que lancei publicamente e o que melhor se alinha à arquitetura no resto deste artigo. Cinco camadas, tudo dentro de um único contêiner Docker, 21 etapas da semente de palavra-chave ao artigo publicado.

As 21 etapas aparecem 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 a semente de palavra-chave e roteia 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, captura de 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 ângulo e posicionamento, briefing de estratégia visual, esboço, rascunho, geração de imagem, geração de fluxograma, QA visual e de artigo.
7. Distribuição: preparação para publicação, esquema, links internos, sindicalização, análise, monitoramento.
8. Um único contêiner Docker contém todos os três subagentes. Eles compartilham ambiente, memória e ferramentas. Os subperfis alternam o 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 da 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 cadeia.

Cada outro agente especializado na empresa funciona 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 o mesmo formato 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 em nossa sede @EspressioAI em Lisboa para uma noite do Hermes Agent recentemente. @yeahfortommy da Nous conduziu um Q&A, Simão do noticed .so mostrou um arcabouço 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, avisarei 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 cada parte do sistema.
• A sala de controle do agente é o plano de controle lateral. Não é um agente pelo qual você conversa. É uma pasta em /root/vps-agents que documenta e governa toda a frota. Você a abre, edita, inspeciona, ou pede ao Claude, Codex ou Hermes para usá-la quando estiver gerenciando o sistema.
• Os agentes Hermes são os trabalhadores. Alguns são especialistas (SEO, dev, CMO, operações). 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 tiver um orquestrador em ação.

Tudo se parece com isso:

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 eles fazem, quais portas usam, quais credenciais referenciam, 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 roteia 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 apenas documenta 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 se construir. Preencha o SOUL.md com a voz que deseja, o MEMORY.md com os fatos estáveis sobre seu negócio e o 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 diretamente com cada um. 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 ter provado que seus especialistas são úteis. Crie dois ou três, execute-os diretamente e só adicione um orquestrador quando sentir necessidade de 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 rotear 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 manuais. Ele não precisa perguntar nada disso a você, ele lê.

Melhor para: trabalho multifuncional, delegação, resumo 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 se torna 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 pelo 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 são executados via cron. Verificações de integridade do servidor são acionadas diariamente. A verificação de backup é executada sem você pedir. Fluxos de trabalho de negócios entre agentes são iniciados em cronograma.

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 é como um departamento de marketing no seu terminal. Ele não precisa de você para começar o dia. Ele aparece para trabalhar sozinho, arquiva relatórios, verifica a si mesmo e só te avisa para as decisões que exigem bom gosto.

A hierarquia de controle

Um princípio para manter em mente à medida que você sobe nos níveis.

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

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 rotear 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á-lo para você.

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

Você pode cloná-lo manualmente, mas a ideia é 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 inclusas vinculadas a ~/.claude/skills no VPS
• Um agente Hermes registrado, manual 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 fluxos de produção. Eles começam bagunçados. 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 contra trabalho real, corrigindo o desvio a cada vez. O arcabouço observa cada correção e começa a escrever a habilidade à medida que aprende o formato. Na terceira execução, o agente já está fazendo a maior parte do que você quer sem instruções.
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 ser executado via cron e o que deve ser acionado manualmente.
4. Implante em um VPS com agendamento. Depois que sobreviver a uma semana de execuções reais sem você precisar monitorar, envie-o para seu próprio contêiner Docker em seu VPS, defina o cron e afaste-se.

Aprendi esse padrão depois de perder 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ê precisa cultivá-lo. 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 o framework. 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 pessoalmente uso hoje:

• Claude Opus 4.7 para o trabalho criativo: copywriting, voz, geração de ganchos, 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 múltiplas etapas, automação de navegador, raspagem, qualquer coisa onde as etapas precisam ser precisas e a saída previsível.

Eu uso ambos. Opus escreve. 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. Muito focado em conteúdo e copy? Comece com Claude Opus 4.7. Muito focado 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.

Compensações honestas

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

1. Os padrões inclusos também são opiniões. O Hermes vem com padrões fortes para como a memória funciona, como as habilidades são escritas, como o agente usa ferramentas. Essa é a proposta. Mas também significa que, se você quer primitivas com controle explícito sobre cada etapa, o Hermes vai parecer pesado. O OpenClaw é a melhor escolha para esse gosto. Escolha a ferramenta que combina com 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 é um framework que torna um bom modelo excelente. Ele 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 rascunho, processamento em lote).

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

Recursos

Se você está começando hoje, aqui está o que eu leria em 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 já vem incluso.
• 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 com o runtime do Codex, o nível gratuito do DeepSeek V4 Flash no Nous Portal, as habilidades de pretexto, tudo veio primeiro pelo feed dele.
• @NousResearch no X: a conta oficial, anúncios oficiais de funcionalidades.
• Os encontros: há encontros do Hermes acontecendo presencialmente agora (Lisboa, Ventura, mais cidades). Vale a pena comparecer 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 valor disso. Agradeço por ler o artigo inteiro.

-- Shann