Pular para o conteúdo principal

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

OpenClaw importa o estado do Hermes por meio de um provedor de migração incluído. O provedor pré-visualiza tudo antes de alterar o estado, oculta segredos em planos e relatórios e cria um backup verificado antes da aplicação.
Importações exigem uma configuração nova do OpenClaw. Se você já tiver estado local do OpenClaw, redefina primeiro a configuração, as credenciais, as sessões e o workspace, ou use openclaw migrate diretamente com --overwrite depois de revisar o plano.

​
Duas formas de importar

O caminho mais rápido. O assistente detecta o Hermes em ~/.hermes e mostra uma pré-visualização antes de aplicar.
openclaw onboard --flow import
Ou aponte para uma origem específica:
openclaw onboard --import-from hermes --import-source ~/.hermes

​
O que é importado

  • Seleção de modelo padrão a partir de config.yaml do Hermes.
  • Provedores de modelo configurados e endpoints personalizados compatíveis com OpenAI a partir de providers e custom_providers.
Definições de servidores MCP de mcp_servers ou mcp.servers.
  • SOUL.md e AGENTS.md são copiados para o workspace do agente do OpenClaw.
  • memories/MEMORY.md e memories/USER.md são anexados aos arquivos de memória correspondentes do OpenClaw em vez de sobrescrevê-los.
Padrões de configuração de memória para a memória em arquivo do OpenClaw. Provedores de memória externos, como o Honcho, são registrados como itens de arquivo ou de revisão manual para que você possa movê-los deliberadamente.
Skills com um arquivo SKILL.md em skills/<name>/ são copiadas, junto com valores de configuração por Skill de skills.config.
Defina --include-secrets para importar chaves .env compatíveis: OPENAI_API_KEY, ANTHROPIC_API_KEY, OPENROUTER_API_KEY, GOOGLE_API_KEY, GEMINI_API_KEY, GROQ_API_KEY, XAI_API_KEY, MISTRAL_API_KEY, DEEPSEEK_API_KEY. Sem a flag, segredos nunca são copiados.

​
O que permanece somente em arquivo

O provedor copia estes itens para o diretório de relatório de migração para revisão manual, mas não os carrega na configuração ou nas credenciais ativas do OpenClaw:
  • plugins/
  • sessions/
  • logs/
  • cron/
  • mcp-tokens/
  • auth.json
  • state.db
O OpenClaw se recusa a executar ou confiar nesse estado automaticamente porque os formatos e pressupostos de confiança podem divergir entre sistemas. Mova manualmente o que você precisar depois de revisar o arquivo.

​
Fluxo recomendado

1

Pré-visualizar o plano

openclaw migrate hermes --dry-run
O plano lista tudo que será alterado, incluindo conflitos, itens ignorados e quaisquer itens sensíveis. A saída do plano oculta chaves aninhadas que parecem conter segredos.
2

Aplicar com backup

openclaw migrate apply hermes --yes
O OpenClaw cria e verifica um backup antes de aplicar. Se você precisar importar chaves de API, adicione --include-secrets.
3

Executar doctor

openclaw doctor
Doctor reaplica quaisquer migrações de configuração pendentes e verifica problemas introduzidos durante a importação.
4

Reiniciar e verificar

openclaw gateway restart
openclaw status
Confirme que o Gateway está saudável e que o modelo, a memória e as Skills importados foram carregados.

​
Tratamento de conflitos

A aplicação se recusa a continuar quando o plano relata conflitos (um arquivo ou valor de configuração já existe no destino).
Execute novamente com --overwrite somente quando substituir o destino existente for intencional. Os provedores ainda podem gravar backups em nível de item para arquivos sobrescritos no diretório de relatório de migração.
Para uma instalação nova do OpenClaw, conflitos são incomuns. Eles geralmente aparecem quando você executa novamente a importação em uma configuração que já tem edições do usuário. Se um conflito surgir no meio da aplicação (por exemplo, uma disputa 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 a importação novamente.

​
Segredos

Segredos nunca são importados por padrão.
  • Execute primeiro openclaw migrate apply hermes --yes para importar estado sem segredos.
  • Se você também quiser copiar chaves .env compatíveis, execute novamente com --include-secrets.
  • Para credenciais gerenciadas por SecretRef, configure a origem SecretRef depois que a importação for concluída.

​
Saída JSON para automação

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. Este é 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 por item se deve ignorar, editar o destino ou executar novamente com --overwrite.
Passe --from /actual/path (CLI) ou --import-source /actual/path (onboarding).
Importações via onboarding exigem uma configuração nova. Redefina o estado e refaça o onboarding, ou use openclaw migrate apply hermes diretamente, que oferece suporte a --overwrite e controle explícito de backup.
--include-secrets é obrigatório, e somente as chaves listadas acima são reconhecidas. Outras variáveis em .env são ignoradas.

​
Relacionados

  • openclaw migrate: referência completa da CLI, contrato do Plugin e formatos JSON.
  • Onboarding: fluxo do assistente e flags não interativas.
  • Migração: mova uma instalação do OpenClaw entre máquinas.
  • Doctor: verificação de integridade pós-migração.
  • Workspace do agente: onde SOUL.md, AGENTS.md e os arquivos de memória ficam.