English简体中文繁體中文日本語EspañolPortuguês (BR)한국어DeutschFrançaisالعربيةItalianoTiếng ViệtNederlandsTürkçeУкраїнськаBahasa IndonesiaPolskiفارسیไทย

Maintenance

Migrando do Claude

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.

Duas formas de importar

Onboarding wizard

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

CLI

Use openclaw migrate para execuções com script ou repetíveis. Consulte openclaw migrate para a referência completa.

openclaw migrate claude --dry-run
openclaw migrate apply claude --yes

Adicione --from <path> para importar um diretório home ou raiz de projeto específico do Claude Code.

O que é importado

Instructions and memory
  • 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.
MCP servers

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 and commands
  • 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

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

  • Apply with backup

    openclaw migrate apply claude --yes

    O OpenClaw cria e verifica um backup antes de aplicar.

  • Run doctor

    openclaw doctor

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

  • 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).

    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

    Claude state lives outside ~/.claude

    Passe --from /actual/path (CLI) ou --import-source /actual/path (integração).

    Onboarding refuses to import on an existing setup

    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.

    MCP servers from Claude Desktop did not import

    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.

    Claude commands became skills with model invocation disabled

    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