Pular para o conteúdo principal
O OpenClaw importa o estado local do Claude por meio do provedor de migração Claude incluído. O provedor pré-visualiza todos os itens antes de alterar o estado, redige segredos em planos e relatórios, e cria um backup verificado antes de aplicar.
Importações de integração exigem uma configuração nova do OpenClaw. Se você já tem estado local do OpenClaw, primeiro redefina configuração, credenciais, sessões e o workspace, ou use openclaw migrate diretamente com --overwrite depois de revisar o plano.

​
Duas formas de importar

O assistente oferece Claude quando detecta estado local do Claude.
openclaw onboard --flow import
Ou aponte para uma origem específica:
openclaw onboard --import-from claude --import-source ~/.claude

​
O que é importado

  • O conteúdo de CLAUDE.md e .claude/CLAUDE.md do projeto é copiado ou anexado ao AGENTS.md do workspace do agente OpenClaw.
  • O conteúdo de ~/.claude/CLAUDE.md do usuário é anexado ao USER.md do workspace.
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.
  • Skills do Claude com um arquivo SKILL.md são copiadas para o diretório de Skills do workspace do OpenClaw.
  • 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 apenas no arquivo

O provedor copia estes itens para o relatório de migração para revisão manual, mas não os carrega na configuração ativa do OpenClaw:
  • Hooks do Claude
  • Permissões do Claude e listas amplas de permissão de ferramentas
  • Padrões de ambiente do Claude
  • CLAUDE.local.md
  • .claude/rules/
  • Subagentes do Claude em .claude/agents/ ou ~/.claude/agents/
  • Caches, planos e diretórios de histórico de projetos do Claude Code
  • Extensões do Claude Desktop e credenciais armazenadas pelo SO
O OpenClaw se recusa a executar hooks, confiar em listas de permissão ou decodificar automaticamente estado opaco de credenciais OAuth e Desktop. Mova manualmente o que você precisar depois de revisar o arquivo.

​
Seleção de origem

Sem --from, o OpenClaw inspeciona o diretório home 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 uma raiz de projeto, o OpenClaw importa apenas os arquivos Claude desse projeto, como CLAUDE.md, .claude/settings.json, .claude/commands/, .claude/skills/ e .mcp.json. Ele não lê seu diretório home global do Claude durante uma importação de raiz de projeto.

​
Fluxo recomendado

1

Preview the plan

openclaw migrate claude --dry-run
O plano lista tudo que será alterado, incluindo conflitos, itens ignorados e valores sensíveis redigidos de campos MCP env ou headers aninhados.
2

Apply with backup

openclaw migrate apply claude --yes
O OpenClaw cria e verifica um backup antes de aplicar.
3

Run doctor

openclaw doctor
Doctor verifica problemas de configuração ou estado após a importação.
4

Restart and verify

openclaw gateway restart
openclaw status
Confirme se o Gateway está saudável e se suas instruções, servidores MCP e 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 por 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 normalmente aparecem quando você executa novamente a importação em uma configuração que já tem edições do usuário.

​
Saída JSON para automação

openclaw migrate claude --dry-run --json
openclaw migrate apply claude --json --yes
Com --json e sem --yes, a aplicação imprime o plano e não altera o estado. Esse é o modo mais seguro para CI e scripts compartilhados.

​
Solução de problemas

Passe --from /actual/path (CLI) ou --import-source /actual/path (integração).
Importações de 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 controle explícito de backup.
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 detectou automaticamente.
Por design. Comandos do Claude são acionados pelo usuário, então 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