--- read_when: - Você está migrando do Hermes e quer manter a configuração do modelo, os prompts, a memória e as Skills - Você quer saber o que o OpenClaw importa automaticamente e o que permanece apenas no arquivo morto - Você precisa de um caminho de migração limpo e automatizado por scripts (CI, notebook novo, automação) summary: Migre do Hermes para o OpenClaw com uma importação reversível e visualizada previamente title: Migração do Hermes x-i18n: generated_at: "2026-07-12T00:00:43Z" model: gpt-5.6 postprocess_version: locale-links-v1 provider: openai source_hash: dd9012efb084c00dfe55bb841fea3cc6908c08b528492f1552bf226f125961e6 source_path: install/migrating-hermes.md workflow: 16 --- 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. ```bash openclaw onboard --flow import ``` Ou indique uma origem específica: ```bash openclaw onboard --import-from hermes --import-source ~/.hermes ``` Use `openclaw migrate` para execuções automatizadas ou repetíveis. Consulte [`openclaw migrate`](/pt-BR/cli/migrate) para obter a referência completa. ```bash openclaw migrate hermes --dry-run # somente prévia openclaw migrate apply hermes --yes # aplica sem solicitar confirmação ``` Adicione `--from ` quando o Hermes estiver fora de `~/.hermes`. ## 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//` 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](/pt-BR/cli/migrate#supported-env-keys). 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 ```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. ```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. ```bash openclaw doctor ``` O [Doctor](/pt-BR/gateway/doctor) reaplica todas as migrações de configuração pendentes e verifica se há problemas introduzidos durante a importação. ```bash openclaw gateway restart openclaw 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. 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](/pt-BR/cli/migrate#supported-env-keys). 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 --json openclaw 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 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](/pt-BR/cli/migrate#supported-env-keys) são reconhecidas — outras variáveis de `.env` são ignoradas. ## Relacionados - [`openclaw migrate`](/pt-BR/cli/migrate): referência completa da CLI, contrato do Plugin e formatos JSON. - [Integração](/pt-BR/cli/onboard): fluxo do assistente e opções não interativas. - [Migração](/pt-BR/install/migrating): mova uma instalação do OpenClaw entre máquinas. - [Doctor](/pt-BR/gateway/doctor): verificação de integridade após a migração. - [Espaço de trabalho do agente](/pt-BR/concepts/agent-workspace): onde ficam `SOUL.md`, `AGENTS.md` e os arquivos de memória.