OpenClawDocs
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

Maintenance

Migração do Hermes

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.

Duas formas de importar

Assistente de integração

Detecta o Hermes em ~/.hermes e exibe uma prévia antes de aplicar.

bash
openclaw onboard --flow import

Ou indique uma origem específica:

bash
openclaw onboard --import-from hermes --import-source ~/.hermes

CLI

Use openclaw migrate para execuções automatizadas ou repetíveis. Consulte openclaw migrate para obter a referência completa.

bash
openclaw migrate hermes --dry-run    # somente préviaopenclaw migrate apply hermes --yes  # aplica sem solicitar confirmação

Adicione --from <path> quando o Hermes estiver fora de ~/.hermes.

O que é importado

Configuração do modelo
  • 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.
Servidores MCP

Definições de servidores MCP provenientes de mcp_servers ou mcp.servers.

Arquivos do espaço de trabalho
  • 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.
Configuração de memória

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.

Skills

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.

Credenciais de autenticação

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

  • Visualize o plano

    bash
    openclaw migrate hermes --dry-run

    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.

  • Aplique com backup

    bash
    openclaw migrate apply hermes --yes

    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.

  • Execute o Doctor

    bash
    openclaw doctor

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

  • Reinicie e verifique

    bash
    openclaw gateway restartopenclaw status

    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.

    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

    bash
    openclaw migrate hermes --dry-run --jsonopenclaw migrate apply hermes --json --yes

    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

    A aplicação é recusada devido a conflitos

    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.

    O Hermes está fora de ~/.hermes

    Informe --from /actual/path (CLI) ou --import-source /actual/path (integração).

    A integração se recusa a importar em uma configuração existente

    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.

    As chaves de API não foram importadas

    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

    Was this useful?
    On this page

    On this page