Skip to main content
O provedor de migração do Hermes incluído detecta o estado em ~/.hermes, exibe uma prévia de cada alteração antes de aplicá-la, oculta segredos nos planos e relatórios e grava um backup verificado do OpenClaw antes de modificar qualquer coisa.
As importações exigem uma configuração nova do OpenClaw. Se você já tiver estado local do OpenClaw, primeiro redefina a configuração, as credenciais, as sessões e o espaço de trabalho ou use openclaw migrate apply hermes diretamente com --overwrite após revisar o plano.

​
Duas formas de importar

Detecta o Hermes em ~/.hermes e exibe uma prévia antes de aplicar.
Ou indique uma origem específica:

​
O que é importado

  • Seleção do modelo padrão no config.yaml do Hermes.
  • Provedores de modelos configurados e endpoints personalizados compatíveis com a OpenAI, provenientes de providers e custom_providers.
Definições de servidores MCP provenientes de mcp_servers ou mcp.servers.
  • SOUL.md e AGENTS.md são copiados para o espaço de trabalho do agente do OpenClaw.
  • memories/MEMORY.md e memories/USER.md são acrescentados aos arquivos de memória correspondentes do OpenClaw, em vez de substituí-los.
Padrões de configuração de memória para a memória em arquivos do OpenClaw. Provedores externos de memória, como o Honcho, são registrados como itens de arquivo ou de revisão manual para que você possa migrá-los deliberadamente.
As Skills que tenham um arquivo SKILL.md em skills/<name>/ são copiadas, junto com os valores de configuração de cada Skill provenientes de skills.config.
O openclaw migrate interativo pergunta antes de importar credenciais de autenticação, com sim selecionado por padrão. Ao aceitar, são importadas as entradas do OAuth da OpenAI no OpenCode e do GitHub Copilot provenientes do auth.json do OpenCode, além das chaves .env compatíveis do Hermes. As entradas OAuth do próprio auth.json do Hermes são estado legado: elas aparecem como um item para reautenticação manual ou correção pelo Doctor, em vez de serem importadas para a autenticação ativa. Use --include-secrets para importar credenciais em uma execução não interativa, --no-auth-credentials para ignorar completamente a importação de credenciais ou a opção --import-secrets do assistente de integração.

​
O que permanece somente no arquivo

O provedor copia os itens a seguir para o diretório do relatório de migração para revisão manual, mas não os carrega na configuração nem nas credenciais ativas do OpenClaw:
  • plugins/
  • sessions/
  • logs/
  • cron/
  • mcp-tokens/
  • state.db
O OpenClaw se recusa a executar ou confiar automaticamente nesse estado porque os formatos e as premissas de confiança podem divergir entre os sistemas. Após revisar o arquivo, mova manualmente o que for necessário.

​
Fluxo recomendado

1

Visualize o plano

O plano lista tudo o que será alterado, incluindo conflitos, itens ignorados e itens confidenciais. Chaves aninhadas que aparentam conter segredos são ocultadas na saída.
2

Aplique com backup

O OpenClaw cria e verifica um backup antes de aplicar as alterações. Este exemplo não interativo importa somente estado não secreto. Execute sem --yes para responder interativamente à solicitação de credenciais ou adicione --include-secrets para incluir credenciais compatíveis em uma execução sem supervisão.
3

Execute o Doctor

O Doctor reaplica todas as migrações de configuração pendentes e verifica se há problemas introduzidos durante a importação.
4

Reinicie e verifique

Confirme se o Gateway está íntegro e se o modelo, a memória e as Skills importados estão carregados.

​
Tratamento de conflitos

A aplicação se recusa a continuar quando o plano relata conflitos, isto é, quando um arquivo ou valor de configuração já existe no destino.
Execute novamente com --overwrite somente quando a substituição do destino existente for intencional. Os provedores ainda podem gravar backups individuais dos arquivos substituídos no diretório do relatório de migração.
Conflitos são incomuns em uma instalação nova. Eles geralmente aparecem quando você executa novamente a importação em uma configuração que já contém edições do usuário. Se um conflito surgir durante a aplicação — por exemplo, uma condição de corrida inesperada em um arquivo de configuração —, o Hermes marca os itens de configuração dependentes restantes como skipped, com o motivo blocked by earlier apply conflict, em vez de gravá-los parcialmente. O relatório de migração registra cada item bloqueado para que você possa resolver o conflito original e executar novamente a importação.

​
Segredos

O openclaw migrate interativo pergunta se as credenciais de autenticação detectadas devem ser importadas, com sim selecionado por padrão.
  • Ao aceitar, são importadas as entradas do OAuth da OpenAI no OpenCode e do GitHub Copilot provenientes do auth.json do OpenCode, além das chaves .env compatíveis. As entradas OAuth do próprio auth.json do Hermes são relatadas para reautenticação manual na OpenAI ou correção pelo Doctor.
  • Use --no-auth-credentials ou responda não à solicitação para importar somente o estado não secreto.
  • Use --include-secrets para importar credenciais em uma execução --yes sem supervisão.
  • Use a opção --import-secrets do assistente de integração para importar credenciais pelo assistente.

​
Saída JSON para automação

Com --json e sem --yes, a aplicação imprime o plano e não altera o estado — o modo mais seguro para CI e scripts compartilhados.

​
Solução de problemas

Inspecione a saída do plano. Cada conflito identifica o caminho de origem e o destino existente. Decida, para cada item, se deseja ignorá-lo, editar o destino ou executar novamente com --overwrite.
Informe --from /actual/path (CLI) ou --import-source /actual/path (integração).
As importações pela integração exigem uma configuração nova. Redefina o estado e execute novamente a integração ou use openclaw migrate apply hermes diretamente, que oferece suporte a --overwrite e ao controle explícito de backups.
O openclaw migrate interativo importa chaves de API somente quando você aceita a solicitação de credenciais. Execuções não interativas com --yes precisam de --include-secrets; importações pela integração precisam de --import-secrets. Somente as chaves .env compatíveis são reconhecidas — outras variáveis de .env são ignoradas.

​
Relacionados