Skip to main content
O OpenClaw importa o estado local do Claude por meio do provedor de migração do Claude incluído. O provedor apresenta uma prévia de cada item antes de alterar o estado, oculta segredos nos planos e relatórios e cria um backup verificado antes da aplicação.
As importações durante a integração exigem uma configuração nova do OpenClaw. Se você já tiver um estado local do OpenClaw, primeiro redefina a configuração, as credenciais, as sessões e o espaço de trabalho ou use openclaw migrate diretamente com --overwrite após revisar o plano.

​
Duas maneiras de importar

O assistente oferece o Claude quando detecta um estado local do Claude.
Ou indique uma origem específica:

​
O que é importado

  • O conteúdo de CLAUDE.md e .claude/CLAUDE.md do projeto é copiado ou anexado ao AGENTS.md no espaço de trabalho do agente do OpenClaw.
  • O conteúdo de ~/.claude/CLAUDE.md do usuário é anexado ao USER.md do espaço de trabalho.
As definições de servidores MCP são importadas de .mcp.json do projeto, ~/.claude.json do Claude Code e claude_desktop_config.json do Claude Desktop, quando presentes.
  • As Skills do Claude que contêm um arquivo SKILL.md são copiadas para o diretório de Skills do espaço de trabalho do OpenClaw.
  • Os arquivos Markdown de comandos do Claude em .claude/commands/ ou ~/.claude/commands/ são convertidos em Skills do OpenClaw com disable-model-invocation: true.

​
O que permanece somente no arquivo

O provedor copia os itens a seguir para o relatório de migração, para revisão manual, mas não os carrega na configuração ativa do OpenClaw:
  • Ganchos do Claude
  • Permissões e listas amplas de ferramentas permitidas do Claude
  • Padrões de ambiente do Claude
  • CLAUDE.local.md
  • .claude/rules/
  • Subagentes do Claude em .claude/agents/ ou ~/.claude/agents/
  • Diretórios de cache, planos e histórico de projetos do Claude Code
  • Extensões do Claude Desktop e credenciais armazenadas pelo sistema operacional
O OpenClaw se recusa a executar ganchos, confiar em listas de permissões ou decodificar automaticamente estados opacos de credenciais do OAuth e do Desktop. Após revisar o arquivo, transfira manualmente o que for necessário.

​
Seleção da origem

Sem --from, o OpenClaw inspeciona o diretório inicial padrão do Claude Code em ~/.claude, o arquivo de estado amostrado ~/.claude.json do Claude Code e a configuração MCP do Claude Desktop no macOS. Quando --from aponta para a raiz de um projeto, o OpenClaw importa somente os arquivos do Claude desse projeto, como CLAUDE.md, .claude/settings.json, .claude/commands/, .claude/skills/ e .mcp.json. Ele não lê o diretório inicial global do Claude durante a importação da raiz de um projeto.

​
Fluxo recomendado

1

Visualize o plano

O plano lista tudo o que será alterado, incluindo conflitos, itens ignorados e valores sensíveis ocultados nos campos env ou headers aninhados do MCP.
2

Aplique com backup

O OpenClaw cria e verifica um backup antes da aplicação.
3

Execute o diagnóstico

O diagnóstico verifica se há problemas de configuração ou estado após a importação.
4

Reinicie e verifique

Confirme se o Gateway está íntegro e se as instruções, os servidores MCP e as Skills importados foram 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 de cada item dos arquivos substituídos no diretório do relatório de migração.
Em uma instalação nova do OpenClaw, conflitos são incomuns. Geralmente, eles aparecem quando você executa novamente a importação em uma configuração que já contém edições do usuário.

​
Saída JSON para automação

--yes é obrigatório para migrate apply fora de um terminal interativo; sem essa opção, o OpenClaw retorna um erro em vez de aplicar as alterações. Portanto, scripts e sistemas de integração contínua devem fornecer --yes explicitamente. Primeiro, visualize com --dry-run --json e depois aplique com --json --yes quando o plano estiver correto.

​
Solução de problemas

Forneça --from /actual/path (CLI) ou --import-source /actual/path (integração).
As importações durante a integração exigem uma configuração nova. Redefina o estado e refaça a integração ou use openclaw migrate apply claude diretamente, que oferece suporte a --overwrite e ao controle explícito de backups.
O Claude Desktop lê claude_desktop_config.json de um caminho específico da plataforma. Aponte --from para o diretório desse arquivo se o OpenClaw não o detectar automaticamente.
Isso é intencional. Os comandos do Claude são acionados pelo usuário, portanto, o OpenClaw os importa como Skills com disable-model-invocation: true. Edite o frontmatter de cada Skill se quiser que o agente as invoque automaticamente.

​
Relacionados