🤖HermesBlog
Guias Práticos do Hermes · Parte 248/9/2026

Migrar do OpenClaw

Migrar do OpenClaw — guia fácil de entender baseado na documentação oficial

Mudar para uma casa nova é estressante — mas imagine se uma empresa de mudanças empacotasse suas caixas, etiquetasse tudo e ainda carregasse seus móveis escada acima para você. É exatamente isso que a ferramenta de migração do Hermes Agent faz quando você muda do OpenClaw (ou de seus primos mais antigos, Clawdbot e Moldbot). Sem cópia manual, sem memórias perdidas, sem lágrimas.

guide-migrate-openclaw

O Que a Ferramenta de Migração Faz?

Pense no hermes claw migrate como sua equipe de mudança pessoal. Ele lê tudo do seu setup antigo do OpenClaw (geralmente em ~/.openclaw/) e coloca tudo organizado no seu novo lar Hermes (~/.hermes/). Ele cuida de:

  • Personalidade e instruções – Seu arquivo SOUL.md (o “personagem” do seu agente) é copiado diretamente.
  • Regras do workspace – O arquivo AGENTS.md (como seu agente deve se comportar em projetos) vai para o local que você escolher.
  • Memória de longo prazo – Seu arquivo MEMORY.md é dividido em entradas separadas, mesclado com memórias existentes e deduplicado para você não ter repetições.

O Jeito Simples de Começar

Abra seu terminal e rode este comando:

hermes claw migrate

A ferramenta vai mostrar uma prévia de tudo o que ela planeja mover. Revise a lista, digite “yes” para confirmar, e pronto. É simples assim.

Quer Ver Antes de Confirmar?

Se você está com receio das mudanças, faça um teste seco primeiro:

hermes claw migrate --dry-run

Isso mostra o plano completo sem tocar em nada. Pense nisso como visitar seu novo apartamento antes de assinar o contrato.

Movendo Suas Chaves de API (Opcional, mas Importante)

Por padrão, a migração não copia suas chaves de API (como credenciais da OpenAI ou Anthropic). Se você quiser movê-las também, precisa dizer isso explicitamente:

hermes claw migrate --preset full --migrate-secrets --yes

A flag --migrate-secrets é seu interruptor de segurança — ela garante que as chaves nunca sejam movidas silenciosamente sem seu conhecimento.

E Se Algo Der Errado?

O Hermes cuida de você. Antes de aplicar qualquer mudança, ele cria um backup zip da sua pasta atual ~/.hermes/. Se algo parecer estranho, você pode restaurar com:

hermes import

Esse backup fica em ~/.hermes/backups/pre-migration-*.zip. É como ter uma foto do “antes” do seu apartamento — você sempre pode colocar tudo de volta no lugar.

Algumas Dicas Extras

  • Usuários legados: Se você está vindo de ~/.clawdbot/ ou ~/.moltbot/, não se preocupe — o Hermes detecta essas pastas automaticamente.
  • Conflitos? Se o Hermes encontrar arquivos que já existem, ele se recusa a sobrescrevê-los por padrão. Você pode forçar com --overwrite ou escolher renomear conflitos com --skill-conflict rename.
  • Configurações com múltiplos provedores: Se você usou vários provedores de IA antes, hermes setup --portal consolida tudo em um único login OAuth com acesso a mais de 300 modelos.

Conclusão

Migração não precisa ser dor de cabeça. Com o hermes claw migrate, você tem uma prévia, um backup de segurança e uma transferência limpa da personalidade, memórias e regras do seu agente — tudo em um único comando.

Dica prática: Rode hermes claw migrate --dry-run primeiro, revise a lista com cuidado, e então execute a migração real. Sempre guarde esse backup zip em um lugar seguro por pelo menos uma semana. Seu eu do futuro vai agradecer.


📖 Documentação oficial

この記事は Hermes Agent のDocumentação oficialに基づいています:Documentação oficial › guides/migrate-from-openclaw