Se você roda OpenClaw há algum tempo, o Hermes Agent é o sucessor dele. Mesma linhagem do projeto, os mesmos mantenedores, com um renomear e um redesign por cima. O instalador do Hermes foi feito pra reconhecer isso — a v0.14.0 já vem com um comando de primeira classe, hermes claw migrate, que importa o estado existente do seu OpenClaw em uma só passada, com suporte a dry-run e presets explícitos.
Aqui vai o guia prático de migração: o que entra, quais flags existem e o fluxo "dry-run primeiro" que evita surpresa ruim.
1. Instalar o Hermes Agent
O assistente de setup do Hermes detecta ~/.openclaw automaticamente e oferece migrar antes da configuração começar. O caminho mais curto:
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
source ~/.bashrc
hermes setup
Quando o assistente vê o seu diretório home do OpenClaw, ele pergunta se quer migrar. Diz sim — mas, se você quer ver exatamente o que seria migrado primeiro, sai do assistente e roda o comando de migração direto.
2. Pré-visualizar com --dry-run
Esse passo vem sempre antes. Ele lista tudo que o migrador importaria, sem escrever nada em disco:
hermes claw migrate --dry-run
A saída é agrupada por categoria — SOUL.md, memories, skills, allowlist, configs de mensageria, API keys, assets de TTS. Lê com calma. Se alguma coisa parece esquisita (uma API key velha que você não quer migrar, um arquivo de personalidade que você já passou), pula a seção correspondente usando um preset.
3. Escolher um preset
Dois presets vêm por padrão:
- •
full(padrão) — migra tudo, segredos incluídos - •
user-data— migra tudo exceto as API keys ; os segredos você reinforma na mão
Tá indo pra máquina nova e quer cortar limpo com os segredos? Usa user-data:
hermes claw migrate --preset user-data
Atualizando a mesma máquina e quer continuidade?
hermes claw migrate
4. O que é importado
Conforme o README:
| OpenClaw | Destino no Hermes |
|---|---|
SOUL.md (persona) | importado como está |
Entradas de MEMORY.md e USER.md | importadas pra memory do Hermes |
| Skills criados por você | copiados pra ~/.hermes/skills/openclaw-imports/ |
| Allowlist de comandos (padrões de aprovação) | importada |
| Configs de mensageria (config de plataforma, usuários permitidos, diretório de trabalho) | importadas |
| API keys (Telegram, OpenRouter, OpenAI, Anthropic, ElevenLabs) | importadas no preset full |
| Assets de TTS (arquivos de áudio do workspace) | importados |
AGENTS.md do workspace | importado com --workspace-target |
Skills do agentskills.io não são reinstalados automaticamente — o Hermes assume que você vai dar uma passada de novo no hub e escolher o que quiser via hermes skills. É intencional: a renomeação OpenClaw → Hermes também reformulou o hub de skills (a v0.14.0 colocou huggingface/skills como tap padrão confiável), e uma escolha nova fica mais limpa do que arrastar tudo no atacado.
5. Lidar com conflitos
Se o Hermes já tem configurações nessa máquina (por exemplo, você rodou hermes setup antes de lembrar que tinha OpenClaw ali), o comando de migração se recusa a sobrescrever por padrão. Duas opções:
- •
--overwrite— sobrescreve os settings do Hermes com os valores do OpenClaw - •Pula a categoria em conflito com
--preset user-datase o conflito for nos segredos
Use --overwrite só depois de um --dry-run que confirma que os valores do OpenClaw são os que você quer.
6. Verificar
hermes doctor
Isso roda o health check pós-instalação. Se memories, skills, allowlist ou configs de plataforma não estão onde deveriam, ele mostra erros específicos. Você corrige, roda de novo, segue em frente.
Alternativa: migração guiada pelo agente
Se você não tá afim de mexer em flag de CLI, o Hermes traz um skill openclaw-migration:
hermes
> /openclaw-migration
O skill te leva pela mesma migração de forma interativa, com pré-visualizações --dry-run em cada passo.
Perguntas frequentes
Perco meus dados do OpenClaw? Não. O migrador copia — não move. Seu diretório ~/.openclaw continua intocado. Se algo der errado, dá pra reverter removendo ~/.hermes e continuar usando OpenClaw.
Posso rodar os dois ao mesmo tempo? Brevemente. Eles compartilham suposições sobre HOME e não esperam ser donos do mesmo memory ao mesmo tempo. Pra operação dupla prolongada, a bridge comunitária HermesClaw cuida de rodar OpenClaw e Hermes na mesma conta de WeChat.
Meus skills vão quebrar? Skills criados por você são copiados pra ~/.hermes/skills/openclaw-imports/, então sobrevivem à mudança. Skills que você pegou do agentskills.io estão amarrados ao hub, não ao seu install local — reinstala via hermes skills.
Onde peço ajuda se algo der errado? Primeiro hermes doctor. Depois o Discord da Nous Research ou as GitHub Issues — ambos linkados no README.