Ir al contenido
OpenClaw Docs

Migrar desde Claude

OpenClaw importa el estado local de Claude a través del proveedor de migración de Claude incluido. El proveedor previsualiza cada elemento antes de cambiar el estado, redacta secretos en los planes e informes, y crea una copia de seguridad verificada antes de aplicar.

Dos formas de importar

Sección titulada «Dos formas de importar»

El asistente ofrece Claude cuando detecta un estado local de Claude.

Ventana de terminal
openclaw onboard --flow import

O apunta a una fuente específica:

Ventana de terminal
openclaw onboard --import-from claude --import-source ~/.claude

Qué se importa

Sección titulada «Qué se importa»
Instrucciones y memoria
  • El contenido del proyecto CLAUDE.md y .claude/CLAUDE.md se copia o anexa al espacio de trabajo del agente OpenClaw AGENTS.md.
  • El contenido del usuario ~/.claude/CLAUDE.md se anexa al espacio de trabajo USER.md.
Servidores MCP

Las definiciones de servidores MCP se importan del proyecto .mcp.json, Claude Code ~/.claude.json y Claude Desktop claude_desktop_config.json cuando están presentes.

Habilidades y comandos
  • Las habilidades de Claude con un archivo SKILL.md se copian al directorio de habilidades del espacio de trabajo OpenClaw.
  • Los archivos Markdown de comandos de Claude bajo .claude/commands/ o ~/.claude/commands/ se convierten en habilidades de OpenClaw con disable-model-invocation: true.

Lo que permanece solo en el archivo

Sección titulada «Lo que permanece solo en el archivo»

El proveedor copia estos elementos en el informe de migración para su revisión manual, pero no los carga en la configuración en vivo de OpenClaw:

  • Ganchos de Claude (Claude hooks)
  • Permisos de Claude y listas de permitidos amplias de herramientas
  • Valores predeterminados del entorno de Claude
  • CLAUDE.local.md
  • .claude/rules/
  • Subagentes de Claude bajo .claude/agents/ o ~/.claude/agents/
  • Cachés, planes y directorios de historial de proyectos de Claude Code
  • Extensiones de Claude Desktop y credenciales almacenadas en el sistema operativo

OpenClaw se niega a ejecutar ganchos, confiar en listas de permitidos de permisos o decodificar automáticamente el estado opaco de credenciales de OAuth y Desktop. Mueva lo que necesite manualmente después de revisar el archivo.

Selección de origen

Sección titulada «Selección de origen»

Sin --from, OpenClaw inspecciona el hogar predeterminado de Claude Code en ~/.claude, el archivo de estado ~/.claude.json muestreado de Claude Code y la configuración MCP de Claude Desktop en macOS.

Cuando --from apunta a una raíz de proyecto, OpenClaw importa solo los archivos de Claude de ese proyecto, como CLAUDE.md, .claude/settings.json, .claude/commands/, .claude/skills/ y .mcp.json. No lee su hogar global de Claude durante una importación de raíz de proyecto.

Flujo recomendado

Sección titulada «Flujo recomendado»

  1. Vista previa del plan

    Ventana de terminal
    openclaw migrate claude --dry-run

    El plan lista todo lo que cambiará, incluidos conflictos, elementos omitidos y valores sensibles redactados de campos env o headers de MCP anidados.

  2. Aplicar con copia de seguridad

    Ventana de terminal
    openclaw migrate apply claude --yes

    OpenClaw crea y verifica una copia de seguridad antes de aplicar.

  3. Ejecutar doctor

    Ventana de terminal
    openclaw doctor

    Doctor busca problemas de configuración o estado después de la importación.

  4. Reiniciar y verificar

    Ventana de terminal
    openclaw gateway restart
    openclaw status

    Confirme que la puerta de enlace está sana y que sus instrucciones, servidores MCP y habilidades importados están cargados.

Manejo de conflictos

Sección titulada «Manejo de conflictos»

Apply se niega a continuar cuando el plan reporta conflictos (un archivo o valor de configuración ya existe en el destino).

Para una instalación nueva de OpenClaw, los conflictos son inusuales. Generalmente aparecen cuando vuelve a ejecutar la importación en una configuración que ya tiene ediciones de usuario.

Salida JSON para automatización

Sección titulada «Salida JSON para automatización»
Ventana de terminal
openclaw migrate claude --dry-run --json
openclaw migrate apply claude --json --yes

Con --json y sin --yes, apply imprime el plan y no muta el estado. Este es el modo más seguro para CI y scripts compartidos.

Solución de problemas

Sección titulada «Solución de problemas»
El estado de Claude reside fuera de ~/.claude

Pase --from /actual/path (CLI) o --import-source /actual/path (incorporación).

La incorporación se niega a importar en una configuración existente

Las importaciones de incorporación requieren una configuración nueva. Reinicie el estado y vuelva a incorporar, o use openclaw migrate apply claude directamente, que admite --overwrite y control explícito de copias de seguridad.

Los servidores MCP de Claude Desktop no se importaron

Claude Desktop lee claude_desktop_config.json desde una ruta específica de la plataforma. Apunte --from al directorio de ese archivo si OpenClaw no lo detectó automáticamente.

Los comandos de Claude se convirtieron en habilidades con la invocación del modelo deshabilitada

Por diseño. Los comandos de Claude son activados por el usuario, por lo que OpenClaw los importa como habilidades con disable-model-invocation: true. Edite los metadatos de cada habilidad si desea que el agente las invoque automáticamente.

Relacionado

Sección titulada «Relacionado»