{"id":50094,"date":"2026-04-29T07:18:24","date_gmt":"2026-04-29T10:18:24","guid":{"rendered":"https:\/\/www.hostinger.com\/pt\/tutoriais\/como-configurar-o-hermes-agent\/"},"modified":"2026-05-08T10:33:24","modified_gmt":"2026-05-08T13:33:24","slug":"como-configurar-o-hermes-agent","status":"publish","type":"post","link":"\/pt\/tutoriais\/como-configurar-o-hermes-agent","title":{"rendered":"Como configurar o Hermes Agent (guia completo)"},"content":{"rendered":"<figure class=\"wp-block-image size-large\"><img decoding=\"async\" src=\"https:\/\/www.hostinger.com\/br\/tutoriais\/wp-content\/uploads\/sites\/53\/2026\/04\/image-42-1024x536.png\" alt=\"\" class=\"wp-image-54735\"><\/figure><p><strong>Como configurar o Hermes Agent<\/strong>: o processo consiste em realizar a implanta&ccedil;&atilde;o em um container Docker no seu VPS, utilizar o assistente para definir o provedor de LLM (Large Language Model) e realizar uma conversa de teste para garantir a estabilidade do sistema.<\/p><p>O Hermes Agent &eacute; um agente de IA que nunca para de aprender. Ele absorve conhecimento das suas intera&ccedil;&otilde;es para criar habilidades permanentes. Uma vez que uma tarefa &eacute; finalizada, essa experi&ecirc;ncia &eacute; usada para resolver casos parecidos com ainda mais efici&ecirc;ncia.<\/p><p>Embora seja poss&iacute;vel instalar o Hermes Agent com o comando curl (Client URL), o Docker &eacute; a melhor op&ccedil;&atilde;o para trabalhar em um VPS. Dessa forma garante o isolamento do agente em rela&ccedil;&atilde;o ao sistema principal e simplifica atualiza&ccedil;&otilde;es futuras &mdash; basta fazer o pull de uma nova imagem.<\/p><p>Resumo de como configurar o Hermes Agent em um VPS usando o Docker:<\/p><ul class=\"wp-block-list\">\n<li><strong>Prepare seu servidor<\/strong>: tenha 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>Fa&ccedil;a a implanta&ccedil;&atilde;o do container<\/strong>: use o assistente de aplica&ccedil;&otilde;es da Hostinger para instalar com um clique, ou extraia a imagem do Docker manualmente se estiver usando outro provedor de 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 o modelo.<\/li>\n\n\n\n<li><strong>Teste uma conversa com CLI<\/strong>: certifique-se de que o agente responde corretamente e possa usar ferramentas antes de adicionar qualquer outra coisa.<\/li>\n\n\n\n<li><strong>Adicione modelos e conecte gateways<\/strong>: configure provedores de LLM adicionais, integre o Telegram, Discord ou outras plataformas e ative os conjuntos de ferramentas necess&aacute;rios.<\/li>\n\n\n\n<li><strong>Reforce a seguran&ccedil;a da instala&ccedil;&atilde;o<\/strong>: configure o escaneamento de comandos Tirith, defina as <em>allowlists<\/em> do gateway e adicione regras de firewall para proteger seu sistema.<\/li>\n<\/ul><h2 class=\"wp-block-heading\" id=\"h-1-configurar-seu-ambiente-vps\"><strong>1. Configurar seu ambiente VPS<\/strong><\/h2><p>Para utilizar o<a href=\"\/pt\/tutoriais\/o-que-e-um-agente-da-hermes\" target=\"_blank\" rel=\"noreferrer noopener\"> Hermes Agent<\/a>, voc&ecirc; precisa de um servidor com distribui&ccedil;&atilde;o Linux (Ubuntu &eacute; o mais recomendado), al&eacute;m de acesso root e uma conex&atilde;o de internet est&aacute;vel.<\/p><p>Escolha 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 suporta o isolamento do Docker e o processo de gateway. O pr&oacute;prio container consome cerca de 1 GB de RAM, ou at&eacute; 2&ndash;4 GB se voc&ecirc; ativar a automa&ccedil;&atilde;o do navegador.<\/p><p>Ap&oacute;s comprar seu VPS, acesse via SSH e atualize os pacotes do 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 conflito de depend&ecirc;ncia ao instalar os componentes do Docker e do Hermes Agent.<\/p><p>&Eacute; importante <a href=\"\/pt\/tutoriais\/como-configurar-vps\" data-type=\"link\" data-id=\"https:\/\/www.hostinger.com\/br\/tutoriais\/como-configurar-vps\" target=\"_blank\" rel=\"noreferrer noopener\">refor&ccedil;ar a configura&ccedil;&atilde;o em seu VPS<\/a>: crie um usu&aacute;rio pr&oacute;prio para o servi&ccedil;o, ajuste as permiss&otilde;es de arquivos e use autentica&ccedil;&atilde;o por chave p&uacute;blica em vez de senhas para evitar acessos n&atilde;o autorizados.<\/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 facilita tudo ao isolar o Hermes Agent e o tudo que precisa para executar em um s&oacute; container. Voc&ecirc; pula a parte complicada de instalar o Python ou Node.js e n&atilde;o precisa se preocupar em configurar vari&aacute;veis de ambiente manualmente.<\/p><p>Existem diferentes formas de implantar o agente, tudo depende da sua estrutura atual.<\/p><p>Se voc&ecirc; ainda n&atilde;o tem seu VPS, a op&ccedil;&atilde;o mais r&aacute;pida e f&aacute;cil &eacute; usar o modelo <a href=\"\/pt\/vps\/docker\/hermes-agent\" target=\"_blank\" data-type=\"link\" data-id=\"https:\/\/www.hostinger.com\/br\/vps\/docker\/hermes-agent\" rel=\"noreferrer noopener\">Hermes Agent pronto pra uso<\/a> da Hostinger. 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>Gerenciador Docker <\/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\" src=\"https:\/\/www.hostinger.com\/br\/tutoriais\/wp-content\/uploads\/sites\/53\/2026\/04\/Gerenciador-Docker-1-1024x395.png\" alt=\"como configurar o hermes agent: Painel Hostinger de acesso e configura&ccedil;&atilde;o.\" class=\"wp-image-55020\"><\/figure><p>Se voc&ecirc; j&aacute; tem um VPS Hostinger, pode implantar o Hermes Agent a partir do hPanel. V&aacute; em <strong>VPS &rarr; SO e painel &rarr; Sistema Operacional &rarr; Mudar 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\" src=\"https:\/\/www.hostinger.com\/br\/tutoriais\/wp-content\/uploads\/sites\/53\/2026\/04\/Mudar-O-SO-1-1024x218.png\" alt=\"\" class=\"wp-image-55021\"><\/figure><p>Quando a instala&ccedil;&atilde;o terminar, v&aacute; para o <strong>Gerenciador Docker &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=\"\/pt\/tutoriais\/instalar-docker-ubuntu\" target=\"_blank\" rel=\"noreferrer noopener\"> 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 container do Hermes Agent:<\/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 container. 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=\"\/pt\/alojamento-vps\" target=\"_blank\" rel=\"noreferrer noopener\"><img decoding=\"async\" width=\"1024\" height=\"300\" src=\"https:\/\/blog.hostinger.io\/pt-tutoriais\/wp-content\/uploads\/sites\/26\/2023\/02\/BR-VPS-hosting_in-text-banner-1-1024x300.png\" alt=\"\" class=\"wp-image-32923\" srcset=\"https:\/\/www.hostinger.com\/pt\/tutoriais\/wp-content\/uploads\/sites\/26\/2023\/02\/BR-VPS-hosting_in-text-banner-1.png 1024w, https:\/\/www.hostinger.com\/pt\/tutoriais\/wp-content\/uploads\/sites\/26\/2023\/02\/BR-VPS-hosting_in-text-banner-1-300x88.png 300w, https:\/\/www.hostinger.com\/pt\/tutoriais\/wp-content\/uploads\/sites\/26\/2023\/02\/BR-VPS-hosting_in-text-banner-1-150x44.png 150w, https:\/\/www.hostinger.com\/pt\/tutoriais\/wp-content\/uploads\/sites\/26\/2023\/02\/BR-VPS-hosting_in-text-banner-1-768x225.png 768w, https:\/\/www.hostinger.com\/pt\/tutoriais\/wp-content\/uploads\/sites\/26\/2023\/02\/BR-VPS-hosting_in-text-banner-1-1536x450.png 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>: inclui a configura&ccedil;&atilde;o do provedor, do modelo e das mensagens, sendo a escolha ideal para a maior parte dos usu&aacute;rios.<\/li>\n\n\n\n<li><strong>Configura&ccedil;&atilde;o completa<\/strong>: inclui a sele&ccedil;&atilde;o de backend do terminal, ajustes de comportamento do agente, chaves para ativar\/desativar ferramentas e a configura&ccedil;&atilde;o de personas.<\/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 assistente 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\" src=\"https:\/\/www.hostinger.com\/br\/tutoriais\/wp-content\/uploads\/sites\/53\/2026\/04\/image-40-1024x829.png\" alt=\"\" class=\"wp-image-54734\"><\/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\" src=\"https:\/\/www.hostinger.com\/br\/tutoriais\/wp-content\/uploads\/sites\/53\/2026\/04\/image-37-1024x354.png\" alt=\"\" class=\"wp-image-54728\"><\/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 no 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-funcionando\"><strong>4. Verificar se o agente Hermes est&aacute; funcionando<\/strong><\/h2><p>Para verificar se o Hermes Agent est&aacute; funcionando 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 aviso 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\" src=\"https:\/\/www.hostinger.com\/br\/tutoriais\/wp-content\/uploads\/sites\/53\/2026\/04\/image-39-1024x856.png\" alt=\"\" class=\"wp-image-54733\"><\/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\" src=\"https:\/\/www.hostinger.com\/br\/tutoriais\/wp-content\/uploads\/sites\/53\/2026\/04\/image-41-1024x744.png\" alt=\"\" class=\"wp-image-54736\"><\/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 o comando <strong>hermes setup<\/strong> novamente para reconfigurar seu provedor e sua chave de API. Como alternativa, use o comando <strong>hermes doctor<\/strong> para escanear toda a configura&ccedil;&atilde;o 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 mais modelos, conectar uma plataforma de mensagens e configurar as ferramentas que seu workflow precisa.<\/p><p>Para adicionar um novo provedor de LLM junto ao que voc&ecirc; configurou antes, execute o comando <strong>hermes<\/strong>. Ele guia voc&ecirc; pela sele&ccedil;&atilde;o do provedor e a entrada da chave 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 Hermes Agent em plataformas como Telegram, Discord, Slack, WhatsApp, Signal ou e-mail, em vez da linha de c&oacute;digo.<\/p><p>Use o comando h<strong>ermes gateway setup<\/strong> para conectar a plataforma escolhida e siga as instru&ccedil;&otilde;es na tela.<\/p><figure class=\"wp-block-image size-large\"><img decoding=\"async\" src=\"https:\/\/www.hostinger.com\/br\/tutoriais\/wp-content\/uploads\/sites\/53\/2026\/04\/image-39-1024x856.png\" alt=\"\" class=\"wp-image-54731\"><\/figure><p>Depois de configurar, execute o <strong>hermes gateway run<\/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 o comando <strong>hermes tools<\/strong> e depois ative ou desative cada ferramenta conforme suas necessidades.<\/p><figure class=\"wp-block-image size-large\"><img decoding=\"async\" src=\"https:\/\/www.hostinger.com\/br\/tutoriais\/wp-content\/uploads\/sites\/53\/2026\/04\/image-43-1024x509.png\" alt=\"\" class=\"wp-image-54737\"><\/figure><p>Note que algumas ferramentas, como <strong>Web Search &amp; Scraping<\/strong>, exigem suas chaves de API funcionais.<\/p><h2 class=\"wp-block-heading\" id=\"h-6-proteja-a-configuracao-do-seu-hermes-agent\"><strong>6. Proteja a configura&ccedil;&atilde;o do seu Hermes Agent<\/strong><\/h2><p>Proteger seu Hermes Agent envolve configurar as prote&ccedil;&otilde;es integradas presente na ferramenta e definir regras no servidor para restringir acessos de fora.<\/p><p>O Hermes Agent vem com um scanner de seguran&ccedil;a chamado Tirith, que verifica cada comando de terminal antes da execu&ccedil;&atilde;o. Ele j&aacute; vem ativado por padr&atilde;o e busca riscos como inje&ccedil;&atilde;o de prompt, exfiltra&ccedil;&atilde;o de credenciais e padr&otilde;es de backdoor via SSH.<\/p><p>Se Tirith sinalizar um comando, voc&ecirc; ver&aacute; um resumo do problema. Voc&ecirc; pode aprovar ou negar usando <strong>\/approve<\/strong> ou <strong>\/deny<\/strong>. Para controlar como as aprova&ccedil;&otilde;es funcionam, edite em <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>smar<\/strong>t: aprova automaticamente opera&ccedil;&otilde;es de baixo risco e solicita apenas opera&ccedil;&otilde;es perigosas.<\/li>\n\n\n\n<li><strong>of<\/strong>f: 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 em 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 container 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 do VPS Hostinger, voc&ecirc; pode atualizar o container diretamente pelo hPanel. No <strong>Gerenciador Docker<\/strong>, acesse 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\" src=\"https:\/\/www.hostinger.com\/br\/tutoriais\/wp-content\/uploads\/sites\/53\/2026\/04\/Atualizar-o-Hermes-Agent-1-1024x449.png\" alt=\"Configurar Hermes Agent: Tela de atualiza&ccedil;&atilde;o automatica da Hostinger\" class=\"wp-image-55024\"><\/figure><p>Al&eacute;m disso, <a href=\"\/pt\/tutoriais\/vps-seguro\" target=\"_blank\" rel=\"noreferrer noopener\">proteja seu VPS<\/a> desativando o login root 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 servidor.<\/p><ul class=\"wp-block-list\">\n<li><strong>Adicionar recursos antes de verificar o chat da CLI<\/strong>: conectar o Telegram, habilitar tarefas cron 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 no CLI primeiro, confirme se ele responde e pode usar ferramentas, depois adicione outros recursos.<\/li>\n\n\n\n<li><strong>N&atilde;o montar o volume de dados<\/strong>: se voc&ecirc; executar 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 container reiniciar, tudo est&aacute; apagado. Sempre inclua a flag de volume ao rodar o container manualmente.<\/li>\n\n\n\n<li><strong>Usar 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, execute o <strong>hermes setup<\/strong> novamente para atualizar.<\/li>\n\n\n\n<li><strong>Pular 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>Deixar 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 container sandbox com o <strong><strong>hermes config set terminal.backend docke<\/strong>r<\/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 funcionando, 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>Monitorar logs e sa&uacute;de do gateway<\/strong>: os registros de containeres s&atilde;o o primeiro lugar para verificar quando algo parece errado. Execute o <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><strong>hermes gateway status<\/strong><\/strong> para ver quais plataformas est&atilde;o conectadas, e o <strong>hermes gateway restart<\/strong>&nbsp;para reconectar os que ca&iacute;ram.<\/li>\n\n\n\n<li><strong>Agendar tarefas recorrentes<\/strong>: o cron planner integrado 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>Acessar o painel web<\/strong>: o painel web &eacute; uma interface de 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, gerenciar chaves API, monitorar sess&otilde;es e agendar tarefas cron a partir de um painel. Comece com o comando abaixo e depois abra <strong>http:\/\/endere&ccedil;o-de-ip-do-VPS: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-e-possivel-fazer-com-o-hermes-agent\"><strong>O que &eacute; poss&iacute;vel fazer com o Hermes Agent?<\/strong><\/h2><p>Com o Hermes Agent rodando na sua VPS, voc&ecirc; ganha um assistente de IA que nunca dorme e que pode ser acessado pelos seus apps de mensagens favoritos a qualquer hora.<\/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 tarefas 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><blockquote class=\"wp-block-quote is-layout-flow wp-block-quote-is-layout-flow\">\n<p>Para casos de uso avan&ccedil;ados, como pipelines de conte&uacute;do, automa&ccedil;&atilde;o de implanta&ccedil;&atilde;o e workflows de processamento de dados ou pesquisa, veja <a href=\"\/pt\/tutoriais\/casos-de-uso-do-hermes-agent\" data-type=\"link\" data-id=\"https:\/\/www.hostinger.com\/br\/tutoriais\/casos-de-uso-do-hermes-agent\">os exemplos mais utilizados do <strong>Hermes Agent<\/strong><\/a>.<\/p>\n<\/blockquote>\n","protected":false},"excerpt":{"rendered":"<p>Como configurar o Hermes Agent: o processo consiste em realizar a implanta&ccedil;&atilde;o em um container Docker no seu VPS, utilizar o assistente para definir o provedor de LLM (Large Language Model) e realizar uma conversa de teste para garantir a estabilidade do sistema. O Hermes Agent &eacute; um agente de IA que nunca para de [&#8230;]<\/p>\n<p><a class=\"btn btn-secondary understrap-read-more-link\" href=\"\/pt\/tutoriais\/como-configurar-o-hermes-agent\">Read More&#8230;<\/a><\/p>\n","protected":false},"author":433,"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 completo)","rank_math_description":"Guia completo de como configurar o Hermes Agent com implata\u00e7\u00e3o Docker no VPS, configura\u00e7\u00e3o de IA e testes de chat para validar o app.","rank_math_focus_keyword":"como configurar o hermes agent","footnotes":""},"categories":[4915],"tags":[],"class_list":["post-50094","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":0},{"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\/pt\/tutoriais\/wp-json\/wp\/v2\/posts\/50094","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.hostinger.com\/pt\/tutoriais\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.hostinger.com\/pt\/tutoriais\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.hostinger.com\/pt\/tutoriais\/wp-json\/wp\/v2\/users\/433"}],"replies":[{"embeddable":true,"href":"https:\/\/www.hostinger.com\/pt\/tutoriais\/wp-json\/wp\/v2\/comments?post=50094"}],"version-history":[{"count":6,"href":"https:\/\/www.hostinger.com\/pt\/tutoriais\/wp-json\/wp\/v2\/posts\/50094\/revisions"}],"predecessor-version":[{"id":50138,"href":"https:\/\/www.hostinger.com\/pt\/tutoriais\/wp-json\/wp\/v2\/posts\/50094\/revisions\/50138"}],"wp:attachment":[{"href":"https:\/\/www.hostinger.com\/pt\/tutoriais\/wp-json\/wp\/v2\/media?parent=50094"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.hostinger.com\/pt\/tutoriais\/wp-json\/wp\/v2\/categories?post=50094"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.hostinger.com\/pt\/tutoriais\/wp-json\/wp\/v2\/tags?post=50094"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}