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.
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
--overwriteou escolher renomear conflitos com--skill-conflict rename. - Configurações com múltiplos provedores: Se você usou vários provedores de IA antes,
hermes setup --portalconsolida 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