# openclaw migrate

Importe estado de outro sistema de agentes por meio de um provedor de migração pertencente a um plugin. Os provedores incluídos cobrem o estado do Codex CLI, Claude e Hermes; plugins de terceiros podem registrar provedores adicionais.

# Comandos

openclaw migrate list
openclaw migrate claude --dry-run
openclaw migrate codex --dry-run
openclaw migrate codex --skill gog-vault77-google-workspace
openclaw migrate hermes --dry-run
openclaw migrate hermes
openclaw migrate apply codex --yes --skill gog-vault77-google-workspace
openclaw migrate apply codex --yes
openclaw migrate apply claude --yes
openclaw migrate apply hermes --yes
openclaw migrate apply hermes --include-secrets --yes
openclaw onboard --flow import
openclaw onboard --import-from claude --import-source ~/.claude
openclaw onboard --import-from hermes --import-source ~/.hermes

OPENCLAW_DOCS_MARKER:paramOpen:IHBhdGg9Ijxwcm92aWRlcg " type="string"> Nome de um provedor de migração registrado, por exemplo hermes. Execute openclaw migrate list para ver os provedores instalados.

--dry-runboolean

Cria o plano e sai sem alterar o estado.

OPENCLAW_DOCS_MARKER:paramOpen:IHBhdGg9Ii0tZnJvbSA8cGF0aA " type="string"> Substitui o diretório de estado de origem. O padrão do Hermes é ~/.hermes.

--include-secretsboolean

Importa credenciais compatíveis. Desativado por padrão.

--overwriteboolean

Permite que a aplicação substitua destinos existentes quando o plano relata conflitos.

--yesboolean

Ignora o prompt de confirmação. Obrigatório no modo não interativo.

"--skill

--no-backupboolean

Ignora o backup antes da aplicação. Exige --force quando já existe estado local do OpenClaw.

--forceboolean

Obrigatório junto com --no-backup quando a aplicação recusaria ignorar o backup.

--jsonboolean

Imprime o plano ou o resultado da aplicação como JSON. Com --json e sem --yes, a aplicação imprime o plano e não altera o estado.

# Modelo de segurança

openclaw migrate prioriza a pré-visualização.

# Provedor Claude

O provedor Claude incluído detecta o estado do Claude Code em ~/.claude por padrão. Use --from <path> para importar uma home específica do Claude Code ou a raiz de um projeto.

# O que o Claude importa

• CLAUDE.md do projeto e .claude/CLAUDE.md para o workspace do agente OpenClaw.
• ~/.claude/CLAUDE.md do usuário anexado a USER.md do workspace.
• Definições de servidores MCP de .mcp.json do projeto, ~/.claude.json do Claude Code e claude_desktop_config.json do Claude Desktop.
• Diretórios de skills do Claude que incluem SKILL.md.
• Arquivos Markdown de comandos do Claude convertidos em skills do OpenClaw apenas com invocação manual.

# Estado arquivado e de revisão manual

Hooks, permissões, padrões de ambiente, memória local, regras com escopo por caminho, subagentes, caches, planos e histórico de projeto do Claude são preservados no relatório de migração ou relatados como itens de revisão manual. O OpenClaw não executa hooks, copia listas de permissão amplas nem importa automaticamente estado de credenciais OAuth/Desktop.

# Provedor Codex

O provedor Codex incluído detecta o estado do Codex CLI em ~/.codex por padrão, ou em CODEX_HOME quando essa variável de ambiente está definida. Use --from <path> para inventariar uma home específica do Codex.

Use este provedor ao migrar para o harness Codex do OpenClaw e quando quiser promover deliberadamente ativos pessoais úteis do Codex CLI. Inicializações locais do servidor de aplicativo Codex usam diretórios CODEX_HOME e HOME por agente, então elas não leem seu estado pessoal do Codex CLI por padrão.

Executar openclaw migrate codex em um terminal interativo pré-visualiza o plano completo e então abre um seletor de caixas de seleção para itens de cópia de skill antes da confirmação final de aplicação. Use Toggle all on ou Toggle all off para seleção em lote; skills planejadas começam marcadas, skills em conflito começam desmarcadas, e Skip for now deixa as skills inalteradas sem aplicar. Para execuções roteirizadas ou exatas, passe --skill <name> uma vez por skill, por exemplo:

openclaw migrate codex --dry-run --skill gog-vault77-google-workspace
openclaw migrate apply codex --yes --skill gog-vault77-google-workspace

# O que o Codex importa

• Diretórios de skills do Codex CLI em $CODEX_HOME/skills, excluindo o cache .system do Codex.
• AgentSkills pessoais em $HOME/.agents/skills, copiadas para o workspace do agente OpenClaw atual quando você quer propriedade por agente.

# Estado Codex de revisão manual

Plugins nativos do Codex, config.toml e hooks/hooks.json nativo não são ativados automaticamente. Plugins podem expor servidores MCP, apps, hooks ou outro comportamento executável, então o provedor os relata para revisão em vez de carregá-los no OpenClaw. Arquivos de configuração e hook são copiados para o relatório de migração para revisão manual.

# Provedor Hermes

O provedor Hermes incluído detecta estado em ~/.hermes por padrão. Use --from <path> quando o Hermes estiver em outro local.

# O que o Hermes importa

• Configuração de modelo padrão de config.yaml.
• Provedores de modelo configurados e endpoints personalizados compatíveis com OpenAI de providers e custom_providers.
• Definições de servidores MCP de mcp_servers ou mcp.servers.
• SOUL.md e AGENTS.md para o workspace do agente OpenClaw.
• memories/MEMORY.md e memories/USER.md anexados aos arquivos de memória do workspace.
• Padrões de configuração de memória para memória de arquivo do OpenClaw, além de itens arquivados ou de revisão manual para provedores de memória externos, como Honcho.
• Skills que incluem um arquivo SKILL.md em skills/<name>/.
• Valores de configuração por skill de skills.config.
• Chaves de API compatíveis de .env, somente com --include-secrets.

# 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.

# Estado apenas arquivado

O estado do Hermes que o OpenClaw não pode interpretar com segurança é copiado para o relatório de migração para revisão manual, mas não é carregado na configuração ou nas credenciais ativas do OpenClaw. Isso preserva estados opacos ou inseguros sem fingir que o OpenClaw pode executá-los ou confiar neles automaticamente:

• plugins/
• sessions/
• logs/
• cron/
• mcp-tokens/
• auth.json
• state.db

# Depois de aplicar

openclaw doctor

# Contrato do Plugin

Fontes de migração são plugins. Um plugin declara seus ids de provedor em openclaw.plugin.json:

{
  "contracts": {
    "migrationProviders": ["hermes"]
  }
}

Em tempo de execução, o plugin chama api.registerMigrationProvider(...). O provedor implementa detect, plan e apply. O core possui a orquestração da CLI, política de backup, prompts, saída JSON e pré-verificação de conflitos. O core passa o plano revisado para apply(ctx, plan), e os provedores podem recriar o plano somente quando esse argumento estiver ausente por compatibilidade.

Plugins provedores podem usar openclaw/plugin-sdk/migration para construção de itens e contagens de resumo, além de openclaw/plugin-sdk/migration-runtime para cópias de arquivos cientes de conflitos, cópias de relatório apenas arquivadas, wrappers de config-runtime em cache e relatórios de migração.

# Integração de onboarding

O onboarding pode oferecer migração quando um provedor detecta uma origem conhecida. Tanto openclaw onboard --flow import quanto openclaw setup --wizard --import-from hermes usam o mesmo provedor de migração de plugin e ainda mostram uma pré-visualização antes de aplicar.

# Relacionados

• Migrando do Hermes: orientação passo a passo voltada ao usuário.
• Migrando do Claude: orientação passo a passo voltada ao usuário.
• Migrando: mover o OpenClaw para uma nova máquina.
• Doctor: verificação de integridade depois de aplicar uma migração.
• Plugins: instalação e registro de plugin.