OpenClawDocs
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

Maintenance

Migração do Claude

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.

Duas maneiras de importar

Assistente de integração

O assistente oferece o Claude quando detecta um estado local do Claude.

bash
openclaw onboard --flow import

Ou indique uma origem específica:

bash
openclaw onboard --import-from claude --import-source ~/.claude

CLI

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

bash
openclaw migrate claude --dry-runopenclaw migrate apply claude --yes

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

O que é importado

Instruções e memória
  • 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.
Servidores MCP

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 e comandos
  • 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

  • Visualize o plano

    bash
    openclaw migrate claude --dry-run

    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.

  • Aplique com backup

    bash
    openclaw migrate apply claude --yes

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

  • Execute o diagnóstico

    bash
    openclaw doctor

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

  • Reinicie e verifique

    bash
    openclaw gateway restartopenclaw status

    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.

    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

    bash
    openclaw migrate claude --dry-run --jsonopenclaw migrate apply claude --json --yes

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

    O estado do Claude fica fora de ~/.claude

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

    A integração se recusa a importar em uma configuração existente

    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.

    Os servidores MCP do Claude Desktop não foram importados

    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.

    Os comandos do Claude se tornaram Skills com a invocação pelo modelo desativada

    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

    Was this useful?
    On this page

    On this page