Migrar do OpenClaw para o Hermes Agent: guia manual

Você Já Decidiu. Agora Vem O Fim De Semana.

Você já decidiu. Talvez tenha lido a comparação Hermes Agent vs OpenClaw e concluído que o runtime de agente mais focado encaixa no jeito que você realmente trabalha. Talvez tenha sido um colega de equipe. De qualquer forma, a decisão ficou para trás. O que está na sua frente é trabalho operacional real: levar uma instalação viva do OpenClaw, com meses de memória acumulada e skills ajustadas, para uma instalação limpa do Hermes Agent sem perder nada que importe.

O Hermes traz um comando oficial de migração. O pacote hermes-migrate foi lançado em 10 de março de 2026 e o fluxo hermes claw migrate está documentado para importar settings, memórias, skills, canais e API keys. Isso resolve o caminho feliz. O que ele não resolve é o trabalho ao redor: provisionar um host, traduzir a config de provider do formato antigo do OpenClaw para o esquema snake_case do Hermes, blindar segredos em repouso, re-emparelhar seu bot do Telegram e verificar de ponta a ponta antes de avisar ao time que o bot novo está no ar.

Este guia percorre tudo isso manualmente para que você saiba exatamente no que está se metendo. No final tem uma alternativa de 1 minuto.

Passo 1: Congele E Exporte O Estado Do OpenClaw

Não comece instalando o Hermes. Comece deixando o lado do OpenClaw parado.

A própria documentação de migração do OpenClaw diz para parar o gateway antes de copiar o estado, porque senão o histórico de conversas e as sessões de canal escrevem por baixo de você. O diretório de estado padrão é ~/.openclaw/, que contém openclaw.json, settings do gateway, auth-profiles.json, credenciais de provider, sessões, estado de canais para WhatsApp e Telegram, e seus arquivos de workspace incluindo MEMORY.md, USER.md, skills e prompts.

openclaw gateway stop
cd ~
tar -czf openclaw-state-$(date +%Y%m%d).tgz .openclaw
sha256sum openclaw-state-*.tgz

Se você configurou um caminho personalizado com OPENCLAW_STATE_DIR, ou se roda perfis como ~/.openclaw-work ou ~/.openclaw-personal, arquive cada um separadamente. A migração só é tão completa quanto os diretórios que você lembrar de capturar, e o modo de falha de esquecer um perfil é silencioso: o Hermes vai subir bem e simplesmente sua personalidade de fim de semana terá sumido.

Copie os arquivos para o host novo antes de mexer em qualquer outra coisa. Se você pular essa etapa e a instalação no host novo falhar, vai querer um caminho de rollback limpo que não dependa da máquina antiga continuar saudável.

Passo 2: Provisione Um Host E Instale O Hermes

Agora você precisa de um lugar para o Hermes morar. As duas opções realistas são uma VPS pequena ou um host Docker local.

Para uma VPS, uma máquina de 2 vCPU / 4 GB é um piso confortável. Você vai gastar a próxima hora nas partes sobre as quais ninguém escreve posts: escolher uma região perto dos seus usuários de mensageria, endurecer o SSH, configurar um firewall que permita só as portas que você realmente precisa, configurar atualizações de segurança automáticas e decidir se o agente roda como root (não deveria) ou como um usuário de serviço dedicado com home travado.

Para Docker local, o trabalho é diferente, mas não mais curto. Você escreve um Compose file, decide onde os volumes de estado moram, decide como o container reinicia quando o host reinicia e descobre como o container alcança o mundo externo sem expor mais do que devia.

Quando o host existir, instale o Hermes:

curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
hermes setup

hermes setup vai procurar por ~/.openclaw/ e oferecer migrar. Se você subiu seu tarball para outro caminho, extraia primeiro para o wizard achar.

Um terminal extraindo um arquivo de estado do OpenClaw em um servidor novo

Passo 3: Traduza A Config De Provider

Esse é o passo onde a maioria das migrações manuais quebra em silêncio.

Tanto OpenClaw quanto Hermes deixam você apontar o agente para OpenAI, Anthropic, OpenRouter, vLLM, Ollama ou um endpoint custom compatível com OpenAI. Os campos parecem iguais. Não têm a mesma forma.

O Hermes só reconhece snake_case na config de provider. Um apiKey ou baseUrl editado à mão é descartado em silêncio. Use api_key e base_url. Quando base_url está setado, o Hermes ignora o nome do provider e chama esse endpoint diretamente usando api_key ou a variável de ambiente OPENAI_API_KEY para autenticação.

O mapeamento manual mínimo fica assim para cada provider que você trouxer:

| Campo OpenClaw | Campo Hermes | Notas | |---|---|---| | provider | provider | Use o slug em minúsculas que o Hermes espera (openai, anthropic, openrouter, ollama, vllm, custom) | | model | model | Mesma string, sem tradução | | apiKey | api_key | snake_case é obrigatório, camelCase é descartado | | baseUrl | base_url | snake_case é obrigatório, só sete se você realmente precisa de um endpoint custom | | apiMode | api_mode | Confirme que o Hermes ainda suporta o valor que você usava |

Repita isso para cada provider que você tem configurado. Se você roda cadeias de fallback (um principal mais um barato de backup), faça um por vez e teste cada um antes de seguir.

Passo 4: Porte Persona, Skills E Memória

O OpenClaw guarda persona em workspace/SOUL.md e IDENTITY.md, com pastas opcionais por personalidade sob personalities/, mais USER.md, MEMORY.md e arquivos de memória diários. Skills moram no diretório de skills do seu workspace.

Uma migração manual limpa é uma decisão por arquivo, não uma cópia de diretório. Abra cada arquivo de persona e confirme:

A voz e as restrições continuam batendo com como você quer que o agente novo se comporte.
Referências a ferramentas específicas do OpenClaw (Control UI, nomes de plugin, comportamentos do gateway) estão removidas ou reformuladas.
Os nomes das skills não colidem com as skills nativas do Hermes, senão a versão importada pode encobrir ou ser encoberta sem aviso.

Depois mova os arquivos para o layout que o Hermes espera:

~/.hermes/SOUL.md para persona
~/.hermes/memories/ para MEMORY.md, USER.md e arquivos diários
~/.hermes/skills/openclaw-imports/ para skills, com a resolução de conflito feita à mão

Os arquivos de memória são onde a maioria dos times subestima o trabalho. Depois de um ano de uso do OpenClaw, MEMORY.md pode ter centenas de entradas que misturam contexto de projetos obsoletos com fatos ainda relevantes. A migração é o momento certo para deduplicar e podar, não para copiar às cegas.

Passo 5: Proteja Seus Segredos

Esse passo não tem atalho. O Hermes guarda credenciais em ~/.hermes/, com tokens de auth sensíveis em caminhos como ~/.hermes/auth/google_oauth.json usando chmod 0600, escritas atômicas e locks de arquivo entre processos. Isso é o piso, não o teto.

Uma migração manual que leva os segredos a sério precisa de:

Um inventário claro de cada API key que você está trazendo, com rotação no momento da migração para invalidar qualquer chave que tenha vazado durante seu período no OpenClaw.
Permissões em ~/.hermes/.env setadas em 0600, donas do usuário de serviço, nunca legíveis por outras contas no host.
Criptografia em repouso para o volume que abriga ~/.hermes/, principalmente se o host é uma VPS compartilhada.
Backups fora do host, eles também criptografados, com um procedimento de restauração testado, porque um backup que você nunca restaurou não é realmente um backup.
Listas documentadas de quem e o que pode ler esses arquivos, para que a próxima pessoa de plantão não tenha que adivinhar.

Se você pular o passo de rotação, você não migrou sua postura de segurança: só mudou ela de lugar.

Passo 6: Re-emparelhe O Telegram E Teste De Ponta A Ponta

O Telegram é o canal de Hermes mais comum e o mais fácil de quebrar no caminho. Você precisa do token do bot, da lista de usuários permitidos e de qualquer setting específico do canal como IDs de grupo ou flags admin-only. O Hermes lê isso de variáveis de ambiente em ~/.hermes/.env. Depois de importar, é preciso reiniciar o gateway antes do bot começar a responder.

hermes status
hermes gateway restart

Se você nunca implantou o Hermes no Telegram, o guia de implantação do Hermes Agent no Telegram cobre a criação do bot e o detalhe do webhook. Quando o gateway voltar, faça um teste de ponta a ponta a partir do cliente real do Telegram, não de hermes status. Mande uma mensagem que exercite a recuperação de memória, uma que exercite uma skill migrada e uma que exercite sua cadeia de providers. Se alguma das três falhar, conserte antes de avisar a alguém que a migração acabou.

Passo 7: Troubleshooting Dos Suspeitos De Sempre

Realisticamente, você vai tropeçar em pelo menos um destes. Planeje para isso.

Conflitos de porta: o gateway do OpenClaw e o gateway do Hermes brigam pela mesma porta. Se você co-localizou os dois durante os testes, pare o OpenClaw primeiro.
Erros de auth de provider: quase sempre é um erro de snake_case ou uma chave velha. Re-confira api_key e base_url, depois hermes status.
Skills faltando ou incompatíveis: skills importadas às vezes referenciam ferramentas que só existem no OpenClaw. Leia a skill que está falhando e reescreva ou remova.
Codificação de memória: se seu MEMORY.md veio de uma instalação do OpenClaw no Windows com quebras de linha CRLF, passe pelo dos2unix antes de copiar.
Drift de persona: o agente parece diferente mesmo com o arquivo de persona idêntico. Verifique se você não está carregando dois arquivos de persona ao mesmo tempo e se nenhum persona padrão do Hermes está sobrepondo o seu.

Se algo funciona em hermes status mas não no Telegram, o problema quase sempre é o gateway, não o agente.

Ou Faça Tudo Isso Em Menos De 1 Minuto Com Hermify

Releia as últimas sete seções. Isso fica entre um fim de semana focado e uma semana desfocada de noites, dependendo de quão limpa estava sua instalação de OpenClaw quando você começou.

O Hermify traz um wizard de migração do OpenClaw de um clique dentro do dashboard que faz o mesmo trabalho sem o fim de semana. Você sobe seu export do OpenClaw, o wizard mostra um preview da migração com contagens de persona, skills, memórias, segredos, providers e Telegram antes de aplicar qualquer coisa, e o passo de aplicar escreve tudo em uma instalação gerenciada do Hermes com os segredos criptografados em repouso. Não tem host para provisionar, não tem tradução de snake_case para lembrar, não tem script de backup para escrever.

O artigo que você acabou de ler é o que o wizard roda por baixo. Se o caminho manual é a experiência que você quer, os passos acima são precisos e completos. Se o que você quer é o resultado, o wizard te leva lá em cerca de um minuto.

Comece com o Hermify e migre do OpenClaw antes do fim de semana que você ia gastar nele.