--- title: "Como instalar e configurar o Hermes Agent em um VPS Linux" description: "Instale o Hermes Agent em um VPS remoto para garantir suporte 24 horas por dia. Siga o nosso guia passo a paso e integre-o com seu próprio bot do Telegram." canonical_url: "https://techvoyage.dev/pt/article/how-to-setup-hermes-on-remote-server" last_updated: "2026-10-20T09:53:43.088Z" --- ## Por que hospedar o Hermes Agent em um VPS remoto? Como o Hermes Agent é capaz de executar tarefas em segundo plano, agendar tarefas e responder a chamadas de webhooks, precisamos de uma máquina que esteja em standby 24 horas por dia, 7 dias por semana. Computadores locais podem sofrer quedas de energia, desconectar-se da Internet ou ter seus recursos de hardware esgotados. Um servidor remoto garante 99% de tempo de atividade (uptime) e facilita a escala de recursos computacionais sempre que necessário. Existem vários provedores acessíveis de servidores privados virtuais (VPS) no mercado, como Hetzner, Hostinger e Contabo. Nós usamos a Contabo há algum tempo e, até o momento, tudo tem funcionado muito bem. ## Como configurar o Hermes Agent em um VPS Linux ### Passo 1: Conectar-se ao seu VPS Abra o terminal e conecte-se via SSH à sua máquina remota: ```bash ssh root@your_server_ip ``` ![Conexão SSH ao servidor VPS Linux no terminal](https://inimages.techvoyage.dev/articles/How%20to%20Setup%20Hermes%20on%20Remote%20Server/vps-terminal-ssh-connection.webp) Certifique-se de que os pacotes do seu servidor estejam atualizados: ```bash sudo apt update && sudo apt upgrade -y ``` Adicione um novo usuário, `hermes`, ou o seu nome de usuário de preferência: ```bash sudo adduser hermes sudo passwd hermes ``` Desative o login por senha para o usuário `root`: 1. Abra o arquivo de configuração do SSH: ```bash sudo nano /etc/ssh/sshd_config ``` 1. Localize a linha `PermitRootLogin` e altere seu valor para `no`: ```text PermitRootLogin no ``` 1. Salve o arquivo e reinicie o serviço SSH: ```bash sudo systemctl restart ssh ``` ### Passo 2: Instalar o Hermes Agent Execute o seguinte comando: ```bash curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash ``` ![Executando o script de instalação do Hermes Agent no terminal](https://inimages.techvoyage.dev/articles/How%20to%20Setup%20Hermes%20on%20Remote%20Server/hermes-agent-installation-terminal.webp) Depois de instalado, verifique a instalação digitando: ```bash hermes --version ``` Execute `hermes setup` para configurar o Hermes Agent: ![Executando o comando hermes setup no terminal para iniciar a configuração](https://inimages.techvoyage.dev/articles/How%20to%20Setup%20Hermes%20on%20Remote%20Server/hermes-agent-setup-wizard.webp) Selecione um provedor de LLM, comece com o `DeepSeek` e adicione outros mais tarde. ![Selecionando DeepSeek como o provedor de LLM na configuração do Hermes](https://inimages.techvoyage.dev/articles/How%20to%20Setup%20Hermes%20on%20Remote%20Server/hermes-setup-llm-provider-selection.webp) Insira a chave de API do `DeepSeek`: ![Inserindo a chave de API do DeepSeek no terminal](https://inimages.techvoyage.dev/articles/How%20to%20Setup%20Hermes%20on%20Remote%20Server/hermes-setup-enter-api-key.webp)![Confirmação de sucesso da chave de API do provedor de LLM](https://inimages.techvoyage.dev/articles/How%20to%20Setup%20Hermes%20on%20Remote%20Server/hermes-setup-api-key-success.webp) Selecione `local machine` para executar o Hermes Agent: ![Selecionando local machine para o ambiente de execução do Hermes Agent](https://inimages.techvoyage.dev/articles/How%20to%20Setup%20Hermes%20on%20Remote%20Server/hermes-setup-select-local-machine.webp) Selecione `Telegram` nos canais de comunicação. Outros canais podem ser configurados posteriormente. ![Selecionando o Telegram como canal de comunicação na configuração do Hermes](https://inimages.techvoyage.dev/articles/How%20to%20Setup%20Hermes%20on%20Remote%20Server/hermes-setup-select-telegram-channel.webp) ### Passo 3: Integração com o Telegram Selecione `[2]` para usar o bot do Telegram. ![Selecionando a opção de configurar a integração do bot do Telegram](https://inimages.techvoyage.dev/articles/How%20to%20Setup%20Hermes%20on%20Remote%20Server/telegram-bot-integration-option.webp) Acesse o `Telegram` e pesquise por 'BotFather'. ![Pesquisando por BotFather no aplicativo Telegram](https://inimages.techvoyage.dev/articles/How%20to%20Setup%20Hermes%20on%20Remote%20Server/telegram-search-botfather.webp) Clique em `Open` para abrir o 'BotFather'. ![Abrindo a interface de chat com BotFather no Telegram](https://inimages.techvoyage.dev/articles/How%20to%20Setup%20Hermes%20on%20Remote%20Server/telegram-open-botfather-chat.webp) Clique em `Create a New Bot` (ou envie o comando `/newbot`). ![Enviando o comando newbot ao BotFather para criar um novo bot do Telegram](https://inimages.techvoyage.dev/articles/How%20to%20Setup%20Hermes%20on%20Remote%20Server/botfather-create-new-bot.webp) Preencha os nomes requeridos e crie o bot. ![Configurando o nome e usuário do novo bot do Telegram](https://inimages.techvoyage.dev/articles/How%20to%20Setup%20Hermes%20on%20Remote%20Server/botfather-bot-details-configured.webp) Clique em `Copy` para copiar o token e cole-o de volta no terminal. ![Copiando o token da API HTTP do bot do Telegram recém-criado](https://inimages.techvoyage.dev/articles/How%20to%20Setup%20Hermes%20on%20Remote%20Server/botfather-copy-http-api-token.webp) Encontre o ID da sua conta de usuário do `Telegram` e adicione-o à lista de usuários permitidos ('Allowed user list'): - Pesquise por '@raw_data_bot' no `Telegram`. ![Pesquisando por raw data bot no Telegram para obter o ID do usuário](https://inimages.techvoyage.dev/articles/How%20to%20Setup%20Hermes%20on%20Remote%20Server/telegram-search-raw-data-bot.webp) - Clique no `RawDataBot` e depois no botão Start (Começar). O ID do usuário será exibido após `P.S. Your ID:`. ![Iniciando o RawDataBot para visualizar o ID da conta de usuário](https://inimages.techvoyage.dev/articles/How%20to%20Setup%20Hermes%20on%20Remote%20Server/telegram-raw-data-bot-user-id.webp) - Copie o ID de usuário e cole-o no terminal. Como estamos executando na nuvem, queremos que o serviço seja iniciado automaticamente. ![Configurando a opção de início automático para o serviço systemd do Hermes](https://inimages.techvoyage.dev/articles/How%20to%20Setup%20Hermes%20on%20Remote%20Server/hermes-setup-autostart-service-option.webp) Deixe todas as opções como padrão: ![Mantendo as configurações de instalação padrão no terminal](https://inimages.techvoyage.dev/articles/How%20to%20Setup%20Hermes%20on%20Remote%20Server/hermes-setup-leave-defaults-1.webp)![Concluindo as opções padrão de configuração do Hermes](https://inimages.techvoyage.dev/articles/How%20to%20Setup%20Hermes%20on%20Remote%20Server/hermes-setup-leave-defaults-2.webp) ## Testando seu Hermes Agent com o bot do Telegram Execute o seguinte comando para iniciar o `hermes gateway`: ```bash hermes gateway ``` Acesse o `Telegram` e adicione o bot criado, '@tech_cloud_hermes_bot', às suas conversas. - Digite '/new' no `Telegram` para iniciar uma nova sessão do `Hermes Agent`. ![Digitando o comando new no Telegram para iniciar uma nova sessão do Hermes Agent](https://inimages.techvoyage.dev/articles/How%20to%20Setup%20Hermes%20on%20Remote%20Server/telegram-chat-hermes-new-session.webp) - Digitar `/commands` listará todos os comandos disponíveis. ![Digitando commands no Telegram para listar as instruções disponíveis do Hermes](https://inimages.techvoyage.dev/articles/How%20to%20Setup%20Hermes%20on%20Remote%20Server/telegram-chat-hermes-commands-list.webp) - Digitar `/model` exibirá uma lista com os LLMs disponíveis. ![Digitando model no Telegram para ver a lista de LLMs ativos](https://inimages.techvoyage.dev/articles/How%20to%20Setup%20Hermes%20on%20Remote%20Server/telegram-chat-hermes-model-selection.webp) ## Executando o Hermes Gateway como um serviço em segundo plano Crie o arquivo de serviço: ```shell sudo nano /etc/systemd/system/hermes-gateway.service ``` Cole o seguinte conteúdo, substituindo `hermes` em '/home/hermes' pelo seu nome de usuário preferido: ```ini [Unit] Description=Hermes Gateway After=network.target [Service] User=hermes WorkingDirectory=/home/hermes ExecStart=/home/hermes/.local/bin/hermes gateway Restart=always RestartSec=10 Environment=PATH=/home/hermes/.local/bin:/usr/local/bin:/usr/bin:/bin [Install] WantedBy=multi-user.target ``` Habilite e inicie o serviço: ```shell sudo systemctl daemon-reload sudo systemctl enable hermes-gateway sudo systemctl start hermes-gateway sudo systemctl status hermes-gateway ``` ## Conclusão Neste artigo, focamos em como configurar o Hermes Agent e usar o Telegram para se comunicar com ele. Manter o Hermes Agent em execução em um servidor remoto oferece um assistente digital real que funciona 24 horas por dia, 7 dias por semana.