{"id":54725,"date":"2026-04-29T07:09:48","date_gmt":"2026-04-29T10:09:48","guid":{"rendered":"\/br\/tutoriais\/?p=54725"},"modified":"2026-04-29T07:09:50","modified_gmt":"2026-04-29T10:09:50","slug":"como-configurar-o-hermes-agent","status":"publish","type":"post","link":"\/br\/tutoriais\/como-configurar-o-hermes-agent","title":{"rendered":"Como configurar o Hermes Agent com o Docker"},"content":{"rendered":"<figure class=\"wp-block-image size-large\"><img decoding=\"async\" width=\"1024\" height=\"536\" src=\"https:\/\/www.hostinger.com\/br\/tutoriais\/wp-content\/uploads\/sites\/53\/2026\/04\/image-42-1024x536.png\" alt=\"\" class=\"wp-image-54735\" srcset=\"https:\/\/www.hostinger.com\/br\/tutoriais\/wp-content\/uploads\/sites\/53\/2026\/04\/image-42.png 1024w, https:\/\/www.hostinger.com\/br\/tutoriais\/wp-content\/uploads\/sites\/53\/2026\/04\/image-42-300x157.png 300w, https:\/\/www.hostinger.com\/br\/tutoriais\/wp-content\/uploads\/sites\/53\/2026\/04\/image-42-150x79.png 150w, https:\/\/www.hostinger.com\/br\/tutoriais\/wp-content\/uploads\/sites\/53\/2026\/04\/image-42-768x402.png 768w\" sizes=\"(max-width: 1024px) 100vw, 1024px\" \/><\/figure><p>Configurar o Hermes Agent significa implant&aacute;-lo como um cont&ecirc;iner Docker em um servidor privado virtual (VPS), rodar o assistente de configura&ccedil;&atilde;o para escolher um provedor de LLM e confirmar que tudo est&aacute; funcionando com uma r&aacute;pida sess&atilde;o de chat.<\/p><p>Hermes Agent &eacute; um agente de IA sempre ativo e auto-aprimorador. Ele aprende com suas intera&ccedil;&otilde;es e desenvolve habilidades reutiliz&aacute;veis ao longo do tempo. Depois que conclui uma tarefa, usa essa experi&ecirc;ncia para lidar melhor com outras semelhantes da pr&oacute;xima vez.<\/p><p>Voc&ecirc; pode instalar o Hermes Agent diretamente em um servidor usando o instalador curl nativo, mas o Docker funciona melhor para implanta&ccedil;&otilde;es de VPS. Isso mant&eacute;m o agente isolado do seu sistema host, e atualizar depois &eacute; t&atilde;o simples quanto puxar uma nova imagem.<\/p><p>Veja como configurar o Hermes Agent em um VPS usando o Docker:<\/p><ul class=\"wp-block-list\">\n<li><strong>Prepare seu gar&ccedil;om<\/strong>. Compre um VPS com pelo menos 2 n&uacute;cleos de CPU e 8 GB de RAM. Use uma distribui&ccedil;&atilde;o Linux como o Ubuntu.<\/li>\n\n\n\n<li><strong>Abra o cont&ecirc;iner<\/strong>. Use o cat&aacute;logo de aplica&ccedil;&otilde;es do Hostinger para uma instala&ccedil;&atilde;o com um clique, ou extraia a imagem do Docker manualmente se estiver usando outro provedor VPS.<\/li>\n\n\n\n<li><strong>Configure seu provedor de LLM<\/strong>. Execute o assistente de configura&ccedil;&atilde;o, selecione um provedor, insira sua chave API e escolha um modelo.<\/li>\n\n\n\n<li><strong>Teste uma conversa com CLI<\/strong>. Certifique-se de que o agente responda corretamente e possa usar ferramentas antes de adicionar qualquer outra coisa.<\/li>\n\n\n\n<li><strong>Adicione modelos, conecte um gateway e configure ferramentas<\/strong>. Configure provedores adicionais de LLM, adicione Telegram, Discord ou outras plataformas e ative os conjuntos de ferramentas que precisar.<\/li>\n\n\n\n<li><strong>Endure&ccedil;a sua miss&atilde;o<\/strong>. Configure a varredura de comandos do Tirith, configure listas de permiss&otilde;es do gateway e adicione regras de firewall para proteger sua configura&ccedil;&atilde;o.<\/li>\n<\/ul><h2 class=\"wp-block-heading\" id=\"h-1-prepare-seu-ambiente-vps\"><strong>1. Prepare seu ambiente VPS<\/strong><\/h2><p>Para rodar o<a href=\"https:\/\/www.hostinger.com\/tutorials\/what-is-hermes-agent\"> Hermes Agent<\/a>, voc&ecirc; precisa de um servidor com distribui&ccedil;&atilde;o Linux (Ubuntu funciona melhor), al&eacute;m de acesso root e uma conex&atilde;o de internet est&aacute;vel.<\/p><p>Mire em um plano VPS com pelo menos <strong>2 n&uacute;cleos de CPU<\/strong> e <strong>8 GB de RAM<\/strong>. Essa configura&ccedil;&atilde;o lida confortavelmente com o isolamento do Docker e o processo de gateway. O pr&oacute;prio container consome cerca de 1 GB de RAM, ou 2&ndash;4 GB se voc&ecirc; ativar a automa&ccedil;&atilde;o do navegador.<\/p><p>Ap&oacute;s comprar seu VPS, conecte-se a ele via SSH e atualize seus pacotes de sistema:<\/p><pre class=\"EnlighterJSRAW\" data-enlighter-language=\"generic\" data-enlighter-theme=\"\" data-enlighter-highlight=\"\" data-enlighter-linenumbers=\"\" data-enlighter-lineoffset=\"\" data-enlighter-title=\"\" data-enlighter-group=\"\">sudo apt update &amp;&amp; sudo apt upgrade -y<\/pre><p>Isso ajuda a evitar conflitos de depend&ecirc;ncia ao instalar os componentes do Docker e do Hermes Agent.<\/p><p>Voc&ecirc; tamb&eacute;m deve garantir e<a href=\"https:\/\/www.hostinger.com\/tutorials\/how-to-set-up-vps\"> preparar seu VPS<\/a>. Crie um usu&aacute;rio dedicado, ajuste permiss&otilde;es e ative a autentica&ccedil;&atilde;o por chave p&uacute;blica para um acesso mais seguro.<\/p><h2 class=\"wp-block-heading\" id=\"h-2-implantar-o-agente-hermes-com-docker\"><strong>2. Implantar o Agente Hermes com Docker<\/strong><\/h2><p>O Docker empacota o Hermes Agent e todas as suas depend&ecirc;ncias em um &uacute;nico container, ent&atilde;o voc&ecirc; n&atilde;o precisa instalar Python ou Node.js ou configurar manualmente vari&aacute;veis de ambiente.<\/p><p>Existem algumas maneiras de faz&ecirc;-lo rodar, dependendo do seu setup.<\/p><p>Se voc&ecirc; ainda n&atilde;o tem um VPS, a op&ccedil;&atilde;o mais r&aacute;pida e f&aacute;cil &eacute; usar o template <a href=\"https:\/\/www.hostinger.com\/vps\/docker\/hermes-agent\">Hermes Agent da Hostinger<\/a>. Escolha o plano que preferir, complete o pagamento e o sistema instala tudo automaticamente.<\/p><p>Durante a configura&ccedil;&atilde;o, voc&ecirc; criar&aacute; um nome de usu&aacute;rio e uma senha para acessar o terminal web do Hermes Agent.<\/p><p>Quando a instala&ccedil;&atilde;o terminar, voc&ecirc; chegar&aacute; ao <strong>Docker Manager<\/strong>, onde o Hermes Agent aparece como um projeto Docker. Clique em <strong>Abrir<\/strong> ao lado dele, depois fa&ccedil;a login usando as credenciais que voc&ecirc; criou anteriormente.<\/p><figure class=\"wp-block-image size-large\"><img decoding=\"async\" width=\"1024\" height=\"374\" src=\"https:\/\/www.hostinger.com\/br\/tutoriais\/wp-content\/uploads\/sites\/53\/2026\/04\/image-36-1024x374.png\" alt=\"\" class=\"wp-image-54730\" srcset=\"https:\/\/www.hostinger.com\/br\/tutoriais\/wp-content\/uploads\/sites\/53\/2026\/04\/image-36.png 1024w, https:\/\/www.hostinger.com\/br\/tutoriais\/wp-content\/uploads\/sites\/53\/2026\/04\/image-36-300x110.png 300w, https:\/\/www.hostinger.com\/br\/tutoriais\/wp-content\/uploads\/sites\/53\/2026\/04\/image-36-150x55.png 150w, https:\/\/www.hostinger.com\/br\/tutoriais\/wp-content\/uploads\/sites\/53\/2026\/04\/image-36-768x281.png 768w, https:\/\/www.hostinger.com\/br\/tutoriais\/wp-content\/uploads\/sites\/53\/2026\/04\/image-36-1536x561.png 1536w\" sizes=\"(max-width: 1024px) 100vw, 1024px\" \/><\/figure><p>Se voc&ecirc; j&aacute; possui um VPS Hostinger, pode implantar o Hermes Agent a partir do hPanel. V&aacute; em <strong>VPS &rarr; OS &amp; Panel &rarr; Sistema Operacional &rarr; Alterar o SO<\/strong>, procure por <strong>Hermes Agent<\/strong> e selecione para iniciar a instala&ccedil;&atilde;o.<\/p><figure class=\"wp-block-image size-large\"><img decoding=\"async\" width=\"1024\" height=\"271\" src=\"https:\/\/www.hostinger.com\/br\/tutoriais\/wp-content\/uploads\/sites\/53\/2026\/04\/image-35-1024x271.png\" alt=\"\" class=\"wp-image-54729\" srcset=\"https:\/\/www.hostinger.com\/br\/tutoriais\/wp-content\/uploads\/sites\/53\/2026\/04\/image-35.png 1024w, https:\/\/www.hostinger.com\/br\/tutoriais\/wp-content\/uploads\/sites\/53\/2026\/04\/image-35-300x79.png 300w, https:\/\/www.hostinger.com\/br\/tutoriais\/wp-content\/uploads\/sites\/53\/2026\/04\/image-35-150x40.png 150w, https:\/\/www.hostinger.com\/br\/tutoriais\/wp-content\/uploads\/sites\/53\/2026\/04\/image-35-768x203.png 768w, https:\/\/www.hostinger.com\/br\/tutoriais\/wp-content\/uploads\/sites\/53\/2026\/04\/image-35-1536x406.png 1536w\" sizes=\"(max-width: 1024px) 100vw, 1024px\" \/><\/figure><p>Quando a instala&ccedil;&atilde;o terminar, v&aacute; para o <strong>Docker Manager &rarr; Projetos<\/strong> e abra o terminal web do Hermes Agent da mesma forma.<\/p><p>Se voc&ecirc; estiver usando outro provedor de VPS,<a href=\"https:\/\/www.hostinger.com\/tutorials\/how-to-install-docker-on-ubuntu\"> instale o Docker<\/a> primeiro. Quando estiver pronto, crie um diret&oacute;rio de dados para o Hermes Agent e abra-o:<\/p><pre class=\"EnlighterJSRAW\" data-enlighter-language=\"generic\" data-enlighter-theme=\"\" data-enlighter-highlight=\"\" data-enlighter-linenumbers=\"\" data-enlighter-lineoffset=\"\" data-enlighter-title=\"\" data-enlighter-group=\"\">mkdir -p ~\/.hermes\n\ncd ~\/.hermes<\/pre><p>Depois, implante o cont&ecirc;iner de Agentes Hermes:<\/p><pre class=\"EnlighterJSRAW\" data-enlighter-language=\"generic\" data-enlighter-theme=\"\" data-enlighter-highlight=\"\" data-enlighter-linenumbers=\"\" data-enlighter-lineoffset=\"\" data-enlighter-title=\"\" data-enlighter-group=\"\">docker run -it --rm \\\n\n-v ~\/.hermes:\/opt\/data \\\n\nnousresearch\/hermes-agent setup<\/pre><p>A flag <strong>-v ~\/.hermes:\/opt\/data<\/strong> monta um diret&oacute;rio host no caminho de dados do cont&ecirc;iner. O Hermes Agent armazena seus arquivos de configura&ccedil;&atilde;o, chaves de API, sess&otilde;es, habilidades e mem&oacute;ria nesse diret&oacute;rio.<\/p><figure class=\"wp-block-image size-large\"><a href=\"\/br\/servidor-vps\" target=\"_blank\" rel=\"noreferrer noopener\"><img decoding=\"async\" width=\"1024\" height=\"300\" src=\"https:\/\/imagedelivery.net\/LqiWLm-3MGbYHtFuUbcBtA\/wp-content\/uploads\/sites\/53\/2023\/02\/BR-VPS-hosting_in-text-banner-1.png\/public\" alt=\"\" class=\"wp-image-32923\" srcset=\"https:\/\/imagedelivery.net\/LqiWLm-3MGbYHtFuUbcBtA\/wp-content\/uploads\/sites\/53\/2023\/02\/BR-VPS-hosting_in-text-banner-1.png\/w=1024,fit=scale-down 1024w, https:\/\/imagedelivery.net\/LqiWLm-3MGbYHtFuUbcBtA\/wp-content\/uploads\/sites\/53\/2023\/02\/BR-VPS-hosting_in-text-banner-1.png\/w=300,fit=scale-down 300w, https:\/\/imagedelivery.net\/LqiWLm-3MGbYHtFuUbcBtA\/wp-content\/uploads\/sites\/53\/2023\/02\/BR-VPS-hosting_in-text-banner-1.png\/w=150,fit=scale-down 150w, https:\/\/imagedelivery.net\/LqiWLm-3MGbYHtFuUbcBtA\/wp-content\/uploads\/sites\/53\/2023\/02\/BR-VPS-hosting_in-text-banner-1.png\/w=768,fit=scale-down 768w, https:\/\/imagedelivery.net\/LqiWLm-3MGbYHtFuUbcBtA\/wp-content\/uploads\/sites\/53\/2023\/02\/BR-VPS-hosting_in-text-banner-1.png\/w=1536,fit=scale-down 1536w\" sizes=\"(max-width: 1024px) 100vw, 1024px\" \/><\/a><\/figure><h2 class=\"wp-block-heading\" id=\"h-3-execute-o-assistente-de-configuracao\"><strong>3. Execute o assistente de configura&ccedil;&atilde;o<\/strong><\/h2><p>Depois que voc&ecirc; acessa o terminal web ou executa o container, o assistente de configura&ccedil;&atilde;o do Hermes Agent &eacute; iniciado automaticamente. Pergunta como voc&ecirc; quer configurar o agente.<\/p><p>Oferece dois caminhos:<\/p><ul class=\"wp-block-list\">\n<li><strong>Configura&ccedil;&atilde;o r&aacute;pida<\/strong>. Abrange o provedor, modelo e mensagens. Essa &eacute; a melhor op&ccedil;&atilde;o para a maioria dos usu&aacute;rios.<\/li>\n\n\n\n<li><strong>Configura&ccedil;&atilde;o completa<\/strong>. Adiciona sele&ccedil;&atilde;o de backend do terminal, configura&ccedil;&otilde;es de comportamento do agente, altern&acirc;ncia de ferramentas e configura&ccedil;&atilde;o de persona.<\/li>\n<\/ul><p>Vamos usar a <strong>configura&ccedil;&atilde;o r&aacute;pida<\/strong> aqui. Voc&ecirc; pode configurar todo o resto depois, assim nada fica travado. O mago guia voc&ecirc; por estes passos:<\/p><ul class=\"wp-block-list\">\n<li><strong>Escolha um provedor de LLM<\/strong>. Escolha entre OpenRouter, Anthropic, OpenAI, Nous Portal, Ollama ou um endpoint personalizado.<\/li>\n<\/ul><figure class=\"wp-block-image size-large\"><img decoding=\"async\" width=\"1024\" height=\"829\" src=\"https:\/\/www.hostinger.com\/br\/tutoriais\/wp-content\/uploads\/sites\/53\/2026\/04\/image-40-1024x829.png\" alt=\"\" class=\"wp-image-54734\" srcset=\"https:\/\/www.hostinger.com\/br\/tutoriais\/wp-content\/uploads\/sites\/53\/2026\/04\/image-40.png 1024w, https:\/\/www.hostinger.com\/br\/tutoriais\/wp-content\/uploads\/sites\/53\/2026\/04\/image-40-300x243.png 300w, https:\/\/www.hostinger.com\/br\/tutoriais\/wp-content\/uploads\/sites\/53\/2026\/04\/image-40-150x121.png 150w, https:\/\/www.hostinger.com\/br\/tutoriais\/wp-content\/uploads\/sites\/53\/2026\/04\/image-40-768x622.png 768w, https:\/\/www.hostinger.com\/br\/tutoriais\/wp-content\/uploads\/sites\/53\/2026\/04\/image-40-1536x1244.png 1536w\" sizes=\"(max-width: 1024px) 100vw, 1024px\" \/><\/figure><ul class=\"wp-block-list\">\n<li><strong>Digite sua chave de API<\/strong>. Cole a chave para o provedor escolhido.<\/li>\n\n\n\n<li><strong>Escolha um modelo<\/strong>. Selecione um dos modelos dispon&iacute;veis para o provedor escolhido.<\/li>\n<\/ul><figure class=\"wp-block-image size-large\"><img decoding=\"async\" width=\"1024\" height=\"354\" src=\"https:\/\/www.hostinger.com\/br\/tutoriais\/wp-content\/uploads\/sites\/53\/2026\/04\/image-37-1024x354.png\" alt=\"\" class=\"wp-image-54728\" srcset=\"https:\/\/www.hostinger.com\/br\/tutoriais\/wp-content\/uploads\/sites\/53\/2026\/04\/image-37.png 1024w, https:\/\/www.hostinger.com\/br\/tutoriais\/wp-content\/uploads\/sites\/53\/2026\/04\/image-37-300x104.png 300w, https:\/\/www.hostinger.com\/br\/tutoriais\/wp-content\/uploads\/sites\/53\/2026\/04\/image-37-150x52.png 150w, https:\/\/www.hostinger.com\/br\/tutoriais\/wp-content\/uploads\/sites\/53\/2026\/04\/image-37-768x266.png 768w, https:\/\/www.hostinger.com\/br\/tutoriais\/wp-content\/uploads\/sites\/53\/2026\/04\/image-37-1536x531.png 1536w\" sizes=\"(max-width: 1024px) 100vw, 1024px\" \/><\/figure><ul class=\"wp-block-list\">\n<li><strong>Conecte-se a uma plataforma de mensagens<\/strong>. Escolha Telegram, Discord, Slack, WhatsApp ou outra plataforma. Voc&ecirc; pode pular isso por enquanto e testar o chat da CLI primeiro.<\/li>\n<\/ul><p>O Hermes Agent armazena dados sens&iacute;veis, como chaves de API, em <strong>~\/.hermes\/.env<\/strong>, enquanto dados n&atilde;o sens&iacute;veis v&atilde;o para <strong>~\/.hermes\/config.yaml<\/strong>.<\/p><h2 class=\"wp-block-heading\" id=\"h-4-verificar-se-o-agente-hermes-esta-rodando\"><strong>4. Verificar se o agente Hermes est&aacute; rodando<\/strong><\/h2><p>Para verificar se o Hermes Agent est&aacute; rodando corretamente ap&oacute;s o assistente de configura&ccedil;&atilde;o, inicie uma sess&atilde;o de CLI e verifique se o agente consegue se comunicar com o modelo selecionado:<\/p><pre class=\"EnlighterJSRAW\" data-enlighter-language=\"generic\" data-enlighter-theme=\"\" data-enlighter-highlight=\"\" data-enlighter-linenumbers=\"\" data-enlighter-lineoffset=\"\" data-enlighter-title=\"\" data-enlighter-group=\"\">hermes<\/pre><p>Voc&ecirc; deve ver um banner de boas-vindas com o modelo selecionado, ferramentas dispon&iacute;veis e habilidades carregadas.<\/p><figure class=\"wp-block-image size-large\"><img decoding=\"async\" width=\"1024\" height=\"856\" src=\"https:\/\/www.hostinger.com\/br\/tutoriais\/wp-content\/uploads\/sites\/53\/2026\/04\/image-39-1024x856.png\" alt=\"\" class=\"wp-image-54733\" srcset=\"https:\/\/www.hostinger.com\/br\/tutoriais\/wp-content\/uploads\/sites\/53\/2026\/04\/image-39.png 1024w, https:\/\/www.hostinger.com\/br\/tutoriais\/wp-content\/uploads\/sites\/53\/2026\/04\/image-39-300x251.png 300w, https:\/\/www.hostinger.com\/br\/tutoriais\/wp-content\/uploads\/sites\/53\/2026\/04\/image-39-150x125.png 150w, https:\/\/www.hostinger.com\/br\/tutoriais\/wp-content\/uploads\/sites\/53\/2026\/04\/image-39-768x642.png 768w, https:\/\/www.hostinger.com\/br\/tutoriais\/wp-content\/uploads\/sites\/53\/2026\/04\/image-39-1536x1283.png 1536w\" sizes=\"(max-width: 1024px) 100vw, 1024px\" \/><\/figure><p>Teste com um prompt que acione uma ferramenta, tipo &ldquo;O que tem no meu diret&oacute;rio atual?&rdquo; Isso confirma que o agente pode responder e executar comandos.<\/p><figure class=\"wp-block-image size-large\"><img decoding=\"async\" width=\"1024\" height=\"744\" src=\"https:\/\/www.hostinger.com\/br\/tutoriais\/wp-content\/uploads\/sites\/53\/2026\/04\/image-41-1024x744.png\" alt=\"\" class=\"wp-image-54736\" srcset=\"https:\/\/www.hostinger.com\/br\/tutoriais\/wp-content\/uploads\/sites\/53\/2026\/04\/image-41.png 1024w, https:\/\/www.hostinger.com\/br\/tutoriais\/wp-content\/uploads\/sites\/53\/2026\/04\/image-41-300x218.png 300w, https:\/\/www.hostinger.com\/br\/tutoriais\/wp-content\/uploads\/sites\/53\/2026\/04\/image-41-150x109.png 150w, https:\/\/www.hostinger.com\/br\/tutoriais\/wp-content\/uploads\/sites\/53\/2026\/04\/image-41-768x558.png 768w, https:\/\/www.hostinger.com\/br\/tutoriais\/wp-content\/uploads\/sites\/53\/2026\/04\/image-41-1536x1115.png 1536w\" sizes=\"(max-width: 1024px) 100vw, 1024px\" \/><\/figure><p>Para sair da sess&atilde;o, digite <strong>\/exit<\/strong>. Use <strong>Hermes<\/strong> para iniciar uma nova sess&atilde;o, ou retome a &uacute;ltima com <strong>Hermes &ndash; continue<\/strong>.<\/p><p>Se o agente retorna respostas vazias ou erros de conex&atilde;o, a causa mais comum &eacute; uma chave de API incorreta ou um provedor mal configurado.<\/p><p>Execute <strong>a configura&ccedil;&atilde;o do Hermes<\/strong> novamente para reconfigurar seu provedor e a chave da API. Alternativamente, use o comando <strong>Hermes Doctor<\/strong> para escanear todo o seu setup e identificar o problema.<\/p><h2 class=\"wp-block-heading\" id=\"h-5-configurar-outros-modelos-gateways-e-ferramentas\"><strong>5. Configurar outros modelos, gateways e ferramentas<\/strong><\/h2><p>Quando o chat CLI funcionar, voc&ecirc; pode adicionar outro modelo, conectar uma plataforma de mensagens e configurar as ferramentas que seu fluxo de trabalho precisa.<\/p><p>Para adicionar um novo provedor de LLM junto ao que voc&ecirc; configurou antes, execute o modelo <strong>Hermes<\/strong>. Ele guia voc&ecirc; pela sele&ccedil;&atilde;o do provedor e pela entrada da chave da API, assim como o assistente de configura&ccedil;&atilde;o.<\/p><p>Depois de configurar v&aacute;rios provedores, alterne entre eles durante a sess&atilde;o com o comando <strong>\/model<\/strong> dentro do chat.<\/p><p>O gateway de mensagens permite que voc&ecirc; se comunique com o Agente Hermes por meio de plataformas como Telegram, Discord, Slack, WhatsApp, Signal ou e-mail, em vez da linha de c&oacute;digo.<\/p><p>Use <strong>a configura&ccedil;&atilde;o do gateway Hermes<\/strong> para conectar sua plataforma preferida e siga as instru&ccedil;&otilde;es na tela.<\/p><figure class=\"wp-block-image size-large\"><img decoding=\"async\" width=\"1024\" height=\"856\" src=\"https:\/\/www.hostinger.com\/br\/tutoriais\/wp-content\/uploads\/sites\/53\/2026\/04\/image-39-1024x856.png\" alt=\"\" class=\"wp-image-54731\" srcset=\"https:\/\/www.hostinger.com\/br\/tutoriais\/wp-content\/uploads\/sites\/53\/2026\/04\/image-39.png 1024w, https:\/\/www.hostinger.com\/br\/tutoriais\/wp-content\/uploads\/sites\/53\/2026\/04\/image-39-300x251.png 300w, https:\/\/www.hostinger.com\/br\/tutoriais\/wp-content\/uploads\/sites\/53\/2026\/04\/image-39-150x125.png 150w, https:\/\/www.hostinger.com\/br\/tutoriais\/wp-content\/uploads\/sites\/53\/2026\/04\/image-39-768x642.png 768w, https:\/\/www.hostinger.com\/br\/tutoriais\/wp-content\/uploads\/sites\/53\/2026\/04\/image-39-1536x1283.png 1536w\" sizes=\"(max-width: 1024px) 100vw, 1024px\" \/><\/figure><p>Depois de configurar, execute <strong>a corrida do gateway Hermes<\/strong> para iniciar o bot. Caso contr&aacute;rio, ele permanece configurado, mas inativo.<\/p><p>O Hermes Agent tamb&eacute;m inclui ferramentas integradas como execu&ccedil;&atilde;o de terminais, busca na web, acesso ao sistema de arquivos e gera&ccedil;&atilde;o de imagens. Abra a lista de ferramentas com as <strong>ferramentas Hermes<\/strong> e depois ative ou desative cada ferramenta conforme suas necessidades.<\/p><figure class=\"wp-block-image size-large\"><img decoding=\"async\" width=\"1024\" height=\"509\" src=\"https:\/\/www.hostinger.com\/br\/tutoriais\/wp-content\/uploads\/sites\/53\/2026\/04\/image-43-1024x509.png\" alt=\"\" class=\"wp-image-54737\" srcset=\"https:\/\/www.hostinger.com\/br\/tutoriais\/wp-content\/uploads\/sites\/53\/2026\/04\/image-43.png 1024w, https:\/\/www.hostinger.com\/br\/tutoriais\/wp-content\/uploads\/sites\/53\/2026\/04\/image-43-300x149.png 300w, https:\/\/www.hostinger.com\/br\/tutoriais\/wp-content\/uploads\/sites\/53\/2026\/04\/image-43-150x74.png 150w, https:\/\/www.hostinger.com\/br\/tutoriais\/wp-content\/uploads\/sites\/53\/2026\/04\/image-43-768x381.png 768w, https:\/\/www.hostinger.com\/br\/tutoriais\/wp-content\/uploads\/sites\/53\/2026\/04\/image-43-1536x763.png 1536w\" sizes=\"(max-width: 1024px) 100vw, 1024px\" \/><\/figure><p>Note que algumas ferramentas, como busca na web e gera&ccedil;&atilde;o de imagens, exigem suas chaves de API funcionais.<\/p><h2 class=\"wp-block-heading\" id=\"h-6-garanta-a-configuracao-do-seu-agente-hermes\"><strong>6. Garanta a configura&ccedil;&atilde;o do seu Agente Hermes<\/strong><\/h2><p>Proteger sua configura&ccedil;&atilde;o de Agente Hermes cobre tanto as prote&ccedil;&otilde;es embutidas do agente quanto as regras em n&iacute;vel de servidor que limitam o acesso externo.<\/p><p>O Agente Hermes vem com um scanner de seguran&ccedil;a chamado Tirith. Ele verifica todos os comandos do terminal antes da execu&ccedil;&atilde;o. Ele est&aacute; ativado por padr&atilde;o e procura riscos como inje&ccedil;&atilde;o r&aacute;pida, exfiltra&ccedil;&atilde;o de credenciais e padr&otilde;es de backdoor SSH.<\/p><p>Se Tirith sinalizar um comando, voc&ecirc; ver&aacute; um resumo do problema. Voc&ecirc; pode aprovar ou negar usando <strong>\/aprovar<\/strong> ou <strong>\/negar<\/strong>. Para controlar como as aprova&ccedil;&otilde;es funcionam, edite <strong>~\/.hermes\/config.yaml<\/strong>:<\/p><pre class=\"EnlighterJSRAW\" data-enlighter-language=\"generic\" data-enlighter-theme=\"\" data-enlighter-highlight=\"\" data-enlighter-linenumbers=\"\" data-enlighter-lineoffset=\"\" data-enlighter-title=\"\" data-enlighter-group=\"\">approvals:\n\n   mode: manual    # manual | smart | off\n\n   timeout: 60 # seconds to wait for user response (default: 60)<\/pre><ul class=\"wp-block-list\">\n<li><strong>manual<\/strong>. Pede aprova&ccedil;&atilde;o antes de cada comando potencialmente arriscado.<\/li>\n\n\n\n<li><strong>inteligente<\/strong>. Aprova automaticamente opera&ccedil;&otilde;es de baixo risco e solicita apenas opera&ccedil;&otilde;es perigosas.<\/li>\n\n\n\n<li><strong>estranho<\/strong>. Desativa todas as verifica&ccedil;&otilde;es de aprova&ccedil;&atilde;o.<\/li>\n<\/ul><p>O gateway de mensagens tamb&eacute;m precisa de prote&ccedil;&atilde;o. No mesmo arquivo <strong>config.yaml<\/strong>, adicione seu ID de usu&aacute;rio &agrave; lista de permitidos para cada plataforma para que s&oacute; voc&ecirc; possa enviar comandos para o bot.<\/p><p>Aqui est&aacute; um exemplo para o Telegram:<\/p><pre class=\"EnlighterJSRAW\" data-enlighter-language=\"generic\" data-enlighter-theme=\"\" data-enlighter-highlight=\"\" data-enlighter-linenumbers=\"\" data-enlighter-lineoffset=\"\" data-enlighter-title=\"\" data-enlighter-group=\"\">gateway:\n\n   telegram:\n\n      allowed_user_ids:\n\n         - 123456789<\/pre><p>Substitua <strong>123456789<\/strong> pelo seu ID real de usu&aacute;rio do Telegram. Voc&ecirc; pode conseguir por mensagem para <strong>@userinfobot<\/strong> no Telegram.<\/p><p>Para outras plataformas como Slack ou WhatsApp, substitua o <strong>Telegram<\/strong> pelo nome da plataforma e use o formato correto de ID de usu&aacute;rio para esse servi&ccedil;o.<\/p><p>No lado da rede, feche as portas <strong>8642<\/strong> (servidor API) e <strong>9119<\/strong> (dashboard) se voc&ecirc; usar apenas o Hermes Agent atrav&eacute;s de plataformas de chat. O gateway cria conex&otilde;es de sa&iacute;da, ent&atilde;o n&atilde;o precisa de tr&aacute;fego de entrada:<\/p><pre class=\"EnlighterJSRAW\" data-enlighter-language=\"generic\" data-enlighter-theme=\"\" data-enlighter-highlight=\"\" data-enlighter-linenumbers=\"\" data-enlighter-lineoffset=\"\" data-enlighter-title=\"\" data-enlighter-group=\"\">sudo ufw deny 8642\n\nsudo ufw deny 9119<\/pre><p>Para se manter atualizado, extraia a imagem mais recente e substitua o cont&ecirc;iner em execu&ccedil;&atilde;o:<\/p><pre class=\"EnlighterJSRAW\" data-enlighter-language=\"generic\" data-enlighter-theme=\"\" data-enlighter-highlight=\"\" data-enlighter-linenumbers=\"\" data-enlighter-lineoffset=\"\" data-enlighter-title=\"\" data-enlighter-group=\"\">docker pull nousresearch\/hermes-agent:latest\n\ndocker rm -f hermes\n\ndocker run -d \\\n\n   --name hermes \\\n\n   --restart unless-stopped \\\n\n   -v ~\/.hermes:\/opt\/data \\\n\n   nousresearch\/hermes-agent gateway run<\/pre><p>Todos os dados ficam no volume montado <strong>~\/.hermes<\/strong>, ent&atilde;o nada se perde durante as atualiza&ccedil;&otilde;es.<\/p><p>Para usu&aacute;rios de VPS Hostinger, voc&ecirc; pode atualizar o container diretamente pelo hPanel. No <strong>Docker Manager<\/strong>, encontre seu projeto Hermes Agent, clique no menu de <strong>tr&ecirc;s pontos<\/strong> e selecione <strong>Atualizar<\/strong>.<\/p><figure class=\"wp-block-image size-large\"><img decoding=\"async\" width=\"1024\" height=\"471\" src=\"https:\/\/www.hostinger.com\/br\/tutoriais\/wp-content\/uploads\/sites\/53\/2026\/04\/image-38-1024x471.png\" alt=\"\" class=\"wp-image-54732\" srcset=\"https:\/\/www.hostinger.com\/br\/tutoriais\/wp-content\/uploads\/sites\/53\/2026\/04\/image-38.png 1024w, https:\/\/www.hostinger.com\/br\/tutoriais\/wp-content\/uploads\/sites\/53\/2026\/04\/image-38-300x138.png 300w, https:\/\/www.hostinger.com\/br\/tutoriais\/wp-content\/uploads\/sites\/53\/2026\/04\/image-38-150x69.png 150w, https:\/\/www.hostinger.com\/br\/tutoriais\/wp-content\/uploads\/sites\/53\/2026\/04\/image-38-768x353.png 768w, https:\/\/www.hostinger.com\/br\/tutoriais\/wp-content\/uploads\/sites\/53\/2026\/04\/image-38-1536x706.png 1536w\" sizes=\"(max-width: 1024px) 100vw, 1024px\" \/><\/figure><p>Al&eacute;m disso, <a href=\"https:\/\/www.hostinger.com\/tutorials\/vps-security\">proteja seu VPS<\/a> desativando o login raiz do SSH, configurando o fail2ban para bloquear tentativas repetidas de login e instalando um scanner de malware para detectar amea&ccedil;as.<\/p><h2 class=\"wp-block-heading\" id=\"h-erros-comuns-ao-configurar-o-hermes-agent\"><strong>Erros comuns ao configurar o Hermes Agent<\/strong><\/h2><p>A maioria dos problemas comuns de configura&ccedil;&atilde;o do Hermes Agent inclui adicionar recursos antes de verificar o chat CLI, n&atilde;o montar o volume de dados, usar credenciais de API incorretas, pular a lista de permissos do gateway e executar comandos diretamente no host.<\/p><ul class=\"wp-block-list\">\n<li><strong>Adicionando recursos antes de verificar o chat da CLI<\/strong>. Conectar o Telegram, habilitar cron jobs ou integrar servi&ccedil;os de terceiros antes de confirmar que o chat CLI funciona torna a solu&ccedil;&atilde;o de problemas mais dif&iacute;cil. Se algo quebrar, voc&ecirc; n&atilde;o vai saber onde est&aacute; o problema. Teste o agente na CLI primeiro, confirme se ele responde e pode usar ferramentas, depois adicione outros recursos.<\/li>\n\n\n\n<li><strong>N&atilde;o montando o volume de dados<\/strong>. Se voc&ecirc; rodar o container sem <strong>-v ~\/.hermes:\/opt\/data<\/strong>, todos os dados (mem&oacute;ria, habilidades e configura&ccedil;&atilde;o) permanecem dentro do container. Quando o cont&ecirc;iner reinicia, tudo est&aacute; perdido. Sempre inclua a flag de volume ao rodar o container manualmente.<\/li>\n\n\n\n<li><strong>Usando credenciais de API incorretas ou expiradas<\/strong>. Se a chave API estiver errada ou expirada, o agente n&atilde;o pode se comunicar com o modelo. Confira a chave no painel do seu provedor ou gere uma nova. Depois, rode <strong>a configura&ccedil;&atilde;o do Hermes<\/strong> novamente para atualizar.<\/li>\n\n\n\n<li><strong>Pulando a lista de permiss&otilde;es do gateway<\/strong>. Se voc&ecirc; configurar um bot de mensagens sem adicionar <strong>allowed_user_ids<\/strong> no <strong>config.yaml<\/strong>, qualquer pessoa que encontrar o nome de usu&aacute;rio do seu bot pode interagir com ele. Adicione seu ID de usu&aacute;rio &agrave; lista de permiss&otilde;es para que s&oacute; voc&ecirc; possa acess&aacute;-lo.<\/li>\n\n\n\n<li><strong>Deixando o backend padr&atilde;o do terminal em um VPS<\/strong>. Por padr&atilde;o, o agente executa comandos de terminal diretamente no seu servidor. Em um VPS, isso pode afetar todo o seu sistema. Mude para um cont&ecirc;iner sandbox com o <strong>Hermes config Terminal.backend docker<\/strong> para que os comandos rodem em um ambiente isolado.<\/li>\n<\/ul><h2 class=\"wp-block-heading\" id=\"h-como-gerenciar-o-agente-hermes-apos-a-configuracao\"><strong>Como gerenciar o Agente Hermes ap&oacute;s a configura&ccedil;&atilde;o<\/strong><\/h2><p>Gerenciar o Hermes Agent ap&oacute;s a configura&ccedil;&atilde;o envolve manter o container e o gateway saud&aacute;veis, agendar tarefas recorrentes com o cron e usar o painel web para gerenciar sua instala&ccedil;&atilde;o.<\/p><ul class=\"wp-block-list\">\n<li><strong>Monitorando logs e sa&uacute;de do gateway<\/strong>. Os registros de cont&ecirc;ineres s&atilde;o o primeiro lugar para verificar quando algo parece errado. Execute <strong>logs docker hermes<\/strong> para revisar resultados recentes, ou <strong>logs docker -f hermes<\/strong> para acompanhar logs em tempo real. Para o gateway, use <strong>o status do gateway Hermes<\/strong> para ver quais plataformas est&atilde;o conectadas, e <strong>o gateway Hermes reinicie<\/strong> para reconectar as que ca&iacute;ram.<\/li>\n\n\n\n<li><strong>Agendar tarefas recorrentes<\/strong>. O cron planner embutido executa tarefas como resumos di&aacute;rios, backups noturnos e relat&oacute;rios semanais. Ele envia resultados para suas plataformas de mensagens conectadas. Defina os cronogramas com o <strong>hermes cron<\/strong>, e o agente cuida da execu&ccedil;&atilde;o automaticamente.<\/li>\n\n\n\n<li><strong>Acessando o painel web<\/strong>. O painel web &eacute; uma interface baseada em navegador para gerenciar a instala&ccedil;&atilde;o do seu Hermes Agent. Em vez de editar arquivos YAML ou executar comandos via CLI, voc&ecirc; pode configurar configura&ccedil;&otilde;es, gerenciar chaves de API, monitorar sess&otilde;es e agendar trabalhos cron a partir de uma interface visual. Comece com o comando abaixo e depois abra <strong>http:\/\/your-server-ip:9119<\/strong> no seu navegador:<\/li>\n<\/ul><pre class=\"EnlighterJSRAW\" data-enlighter-language=\"generic\" data-enlighter-theme=\"\" data-enlighter-highlight=\"\" data-enlighter-linenumbers=\"\" data-enlighter-lineoffset=\"\" data-enlighter-title=\"\" data-enlighter-group=\"\">docker run -d \\\n\n   --name hermes-dashboard \\\n\n   --restart unless-stopped \\\n\n   -v ~\/.hermes:\/opt\/data \\\n\n   -p 9119:9119 \\\n\n   nousresearch\/hermes-agent dashboard<\/pre><h2 class=\"wp-block-heading\" id=\"h-o-que-voce-pode-fazer-com-o-hermes-agent\"><strong>O que voc&ecirc; pode fazer com o Hermes Agent?<\/strong><\/h2><p>Com o Hermes Agent rodando no seu VPS, voc&ecirc; ganha um assistente de IA sempre ligado que pode acessar pelos seus canais de comunica&ccedil;&atilde;o preferidos a qualquer momento.<\/p><p>O que voc&ecirc; faz com ele depende das suas necessidades &ndash; seja voc&ecirc; um desenvolvedor, um sysadmin ou algu&eacute;m que quer um assistente pessoal rodando no seu pr&oacute;prio servidor.<\/p><p>Para tarefas de desenvolvimento, voc&ecirc; pode pedir ao agente para clonar um reposit&oacute;rio, criar um ambiente de staging e rodar testes, tudo a partir de uma mensagem do Telegram enquanto voc&ecirc; estiver longe da sua mesa.<\/p><p>Administradores de sistemas podem configurar trabalhos cron usando linguagem natural. Por exemplo, voc&ecirc; pode agendar um relat&oacute;rio semanal de uso de disco para ser entregue ao Slack toda segunda-feira de manh&atilde;, ou fazer com que o agente monitore um servi&ccedil;o e envie um alerta quando ele cair.<\/p><p>Para uso pessoal, voc&ecirc; pode pedir ao agente para enviar um briefing matinal com seu calend&aacute;rio, not&iacute;cias principais e notifica&ccedil;&otilde;es no GitHub antes do in&iacute;cio do seu dia.<\/p><p>Se voc&ecirc; quiser exemplos mais avan&ccedil;ados, incluindo pipelines de produ&ccedil;&atilde;o de conte&uacute;do, automa&ccedil;&atilde;o de implanta&ccedil;&atilde;o e fluxos de trabalho de pesquisa ou processamento de dados, confira os <a href=\"https:\/\/www.hostinger.com\/tutorials\/hermes-agent-use-cases\">casos de uso mais populares do Hermes Agent<\/a>.<\/p>\n","protected":false},"excerpt":{"rendered":"<p>Configurar o Hermes Agent significa implant&aacute;-lo como um cont&ecirc;iner Docker em um servidor privado virtual (VPS), rodar o assistente de configura&ccedil;&atilde;o para escolher um provedor de LLM e confirmar que tudo est&aacute; funcionando com uma r&aacute;pida sess&atilde;o de chat. Hermes Agent &eacute; um agente de IA sempre ativo e auto-aprimorador. Ele aprende com suas intera&ccedil;&otilde;es [&#8230;]<\/p>\n<p><a class=\"btn btn-secondary understrap-read-more-link\" href=\"\/br\/tutoriais\/como-configurar-o-hermes-agent\">Read More&#8230;<\/a><\/p>\n","protected":false},"author":634,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"rank_math_title":"Como configurar o Hermes Agent (guia passo a passo)","rank_math_description":"Aprenda a instalar o Hermes Agent em um VPS com o Docker, configur\u00e1-lo corretamente e gerenciar sua infraestrutura com efici\u00eancia.","rank_math_focus_keyword":"","footnotes":""},"categories":[4915],"tags":[],"class_list":["post-54725","post","type-post","status-publish","format-standard","hentry","category-vps"],"hreflangs":[{"locale":"pt-BR","link":"https:\/\/www.hostinger.com\/br\/tutoriais\/como-configurar-o-hermes-agent\/","default":1},{"locale":"pt-PT","link":"https:\/\/www.hostinger.com\/pt\/tutoriais\/como-configurar-o-hermes-agent\/","default":0}],"acf":[],"_links":{"self":[{"href":"https:\/\/www.hostinger.com\/br\/tutoriais\/wp-json\/wp\/v2\/posts\/54725","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.hostinger.com\/br\/tutoriais\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.hostinger.com\/br\/tutoriais\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.hostinger.com\/br\/tutoriais\/wp-json\/wp\/v2\/users\/634"}],"replies":[{"embeddable":true,"href":"https:\/\/www.hostinger.com\/br\/tutoriais\/wp-json\/wp\/v2\/comments?post=54725"}],"version-history":[{"count":1,"href":"https:\/\/www.hostinger.com\/br\/tutoriais\/wp-json\/wp\/v2\/posts\/54725\/revisions"}],"predecessor-version":[{"id":54738,"href":"https:\/\/www.hostinger.com\/br\/tutoriais\/wp-json\/wp\/v2\/posts\/54725\/revisions\/54738"}],"wp:attachment":[{"href":"https:\/\/www.hostinger.com\/br\/tutoriais\/wp-json\/wp\/v2\/media?parent=54725"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.hostinger.com\/br\/tutoriais\/wp-json\/wp\/v2\/categories?post=54725"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.hostinger.com\/br\/tutoriais\/wp-json\/wp\/v2\/tags?post=54725"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}