Contrate uma VPS limpa
Escolha um servidor sem painel ou aplicativos pré-instalados. Isso deixa o ambiente pronto para receber somente o Hermes e evita conflitos.
Na contratação, selecione SO simples com Ubuntu 22.04 LTS. Não adicione cPanel, n8n, OpenClaw ou GatorClaw.
Observação: o botão acima usa um link de indicação. A oferta exibida e as condições comerciais são definidas pela HostGator no momento da contratação.
Prepare Telegram e ChatGPT
Você precisa somente destas duas contas. O Telegram deve estar instalado no celular e também no computador que será usado durante a configuração.
Crie sua conta usando seu número de telefone. Depois instale o aplicativo no celular e no computador e entre com a mesma conta nos dois dispositivos.
Para configurar o provedor OpenAI Codex pelo login, deixe ativa uma conta ChatGPT com plano Plus ou Pro compatível.
Use a mesma conta do Telegram no celular e no computador. Não compartilhe códigos temporários de login ou a senha root da VPS.
Guarde os dados da VPS
Quando o servidor ficar pronto, a HostGator informará o endereço IP, a porta SSH e o acesso administrativo. Preencha a ficha abaixo durante a instalação.
Use exatamente a porta informada pela hospedagem. Se nenhuma porta diferente foi indicada, mantenha 22.
ssh -p 22 root@SEU_IP
🔒 Guarde a senha definitiva em um gerenciador de senhas. Este formulário não salva IP, porta, usuário ou senha quando a página é fechada.
Instale e conecte o Hermes
Agora você vai entrar na VPS e iniciar a instalação guiada do Hermes. O instalador conduz as configurações seguintes, incluindo a inteligência e o Telegram. O primeiro comando é montado automaticamente com os dados preenchidos no item 3.
Comando sincronizado: não é necessário digitar novamente o IP, a porta ou o usuário. Se o comando não aparecer pronto abaixo, volte ao item 3 e preencha os dados da VPS ↑.
Preencha o IP no item 3 para gerar o comando de acesso.
Primeiro acesso: este comando usa o IP, a porta e o usuário preenchidos no item 3. Se aparecer uma pergunta com yes/no, digite yes e pressione Enter. Depois informe a senha root. O terminal não mostra caracteres enquanto você digita ou cola a senha — isso é normal.
sudo apt update && \ sudo apt install -y git curl xz-utils && \ curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash
Pode colar o bloco inteiro de uma vez. O instalador oficial prepara as dependências e pode abrir o assistente de configuração no próprio terminal. Leia cada pergunta antes de confirmar.
source ~/.bashrc hermes doctor
Siga o assistente na tela: o instalador continuará fazendo as perguntas necessárias para configurar a inteligência, o Telegram e o funcionamento do agente. Leia cada opção antes de confirmar.
journalctl --user -u hermes-gateway -n 80 --no-pager
Referência: estes comandos seguem a documentação oficial de instalação do Hermes ↗.
Instale o Codex no terminal
O Codex será seu apoio técnico dentro da própria VPS. Se o Hermes apresentar algum erro, você poderá abrir o Codex no terminal para analisar arquivos, executar verificações e ajudar a resolver o problema.
curl -fsSL https://chatgpt.com/codex/install.sh | sh
Cole o comando no terminal da VPS e pressione Enter. Ele usa o instalador oficial do Codex para Linux.
codex
No primeiro acesso: escolha Sign in with ChatGPT e siga o endereço ou código mostrado no terminal. Entre com a mesma conta ChatGPT Plus ou Pro preparada no item 2.
codex --version
Segurança: não cole senhas, tokens do Telegram ou outras credenciais no chat. Leia os comandos e as aprovações mostrados pelo Codex antes de permitir alterações na VPS. Ver documentação oficial do Codex CLI ↗
Envie o Kit Inicial ao agente
Quando seu agente Hermes já estiver disponível no Telegram, envie o arquivo ZIP diretamente na conversa. Você não precisa abrir nem extrair o conteúdo.
Kit Inicial do Hermes — Pedro Gadelha
Baixe o arquivo ZIP no computador. Depois abra a conversa com seu agente no Telegram e envie o arquivo inteiro como documento.
Baixar o Kit Inicial em ZIP ↓Este é o meu Kit Inicial do Hermes. Pode abrir o arquivo, ler primeiro o documento 0-LEIA-PRIMEIRO-AGENTE.md e me guiar na configuração passo a passo?
Importante: envie o ZIP inteiro. O próprio agente abre o arquivo, lê as instruções e começa a fazer as perguntas da configuração.