Skip to main content
OpenClaw importa el estado local de Claude mediante el proveedor de migración de Claude incluido. El proveedor muestra una vista previa de cada elemento antes de cambiar el estado y oculta los secretos en los planes e informes. La ejecución independiente de openclaw migrate crea una copia de seguridad verificada; la ruta de incorporación nueva prepara la importación y solo la publica después de que la verificación se complete correctamente.
Las importaciones durante la incorporación requieren una configuración nueva de OpenClaw. Si ya existe un estado local de OpenClaw, primero se deben restablecer la configuración, las credenciales, las sesiones y el espacio de trabajo, o se puede usar openclaw migrate directamente con --overwrite después de revisar el plan.

​
Dos formas de importar

El asistente ofrece Claude cuando detecta un estado local de Claude.
También se puede indicar una fuente específica:

​
Qué se importa

  • El contenido de CLAUDE.md y .claude/CLAUDE.md del proyecto se copia o se añade al AGENTS.md del espacio de trabajo del agente de OpenClaw.
  • El contenido de ~/.claude/CLAUDE.md del usuario se añade al USER.md del espacio de trabajo.
Las definiciones de servidores MCP se importan desde .mcp.json del proyecto, ~/.claude.json de Claude Code y claude_desktop_config.json de Claude Desktop cuando están presentes.
  • Las Skills de Claude que contienen un archivo SKILL.md se copian en el directorio de Skills del espacio de trabajo de OpenClaw.
  • Los archivos Markdown de comandos de Claude ubicados en .claude/commands/ o ~/.claude/commands/ se convierten en Skills de OpenClaw con disable-model-invocation: true.

​
Qué 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 activa de OpenClaw:
  • Hooks de Claude
  • Permisos de Claude y listas amplias de herramientas permitidas
  • Valores predeterminados del entorno de Claude
  • CLAUDE.local.md
  • .claude/rules/
  • Subagentes de Claude ubicados en .claude/agents/ o ~/.claude/agents/
  • Cachés, planes y directorios del historial de proyectos de Claude Code
  • Extensiones de Claude Desktop y credenciales almacenadas por el sistema operativo
OpenClaw se niega a ejecutar hooks, confiar en listas de permisos o descodificar automáticamente el estado opaco de credenciales de OAuth y Desktop. Después de revisar el archivo, se debe transferir manualmente lo que sea necesario.

​
Selección de la fuente

Sin --from, OpenClaw examina el directorio principal predeterminado de Claude Code en ~/.claude, el archivo de estado de muestra ~/.claude.json de Claude Code y la configuración MCP de Claude Desktop en macOS. Cuando --from apunta a la raíz de un proyecto, OpenClaw importa únicamente los archivos de Claude de ese proyecto, como CLAUDE.md, .claude/settings.json, .claude/commands/, .claude/skills/ y .mcp.json. Durante una importación desde la raíz de un proyecto, no lee el directorio principal global de Claude.

​
Flujo recomendado

1

Obtener una vista previa del plan

El plan enumera todo lo que cambiará, incluidos los conflictos, los elementos omitidos y los valores confidenciales ocultos de los campos anidados env o headers de MCP.
2

Aplicar con una copia de seguridad

OpenClaw crea y verifica una copia de seguridad antes de aplicar los cambios.
3

Ejecutar el diagnóstico

El diagnóstico comprueba si existen problemas de configuración o estado después de la importación.
4

Reiniciar y verificar

Se debe confirmar que el Gateway funciona correctamente y que las instrucciones, los servidores MCP y las Skills importados están cargados.

​
Gestión de conflictos

La aplicación se niega a continuar cuando el plan informa de conflictos (ya existe un archivo o valor de configuración en el destino).
Solo se debe repetir la ejecución con --overwrite cuando se pretenda reemplazar el destino existente. Los proveedores pueden seguir creando copias de seguridad individuales de los archivos sobrescritos en el directorio del informe de migración.
En una instalación nueva de OpenClaw, los conflictos no son habituales. Normalmente aparecen cuando se vuelve a ejecutar la importación en una configuración que ya contiene modificaciones del usuario.

​
Salida JSON para automatización

--yes es obligatorio para migrate apply fuera de una terminal interactiva; sin este, OpenClaw devuelve un error en lugar de aplicar los cambios, por lo que los scripts y el Pipeline de CI deben proporcionar --yes explícitamente. Primero se debe obtener una vista previa con --dry-run --json y, cuando el plan sea correcto, aplicar los cambios con --json --yes.

​
Solución de problemas

Se debe proporcionar --from /actual/path (CLI) o --import-source /actual/path (incorporación).
Las importaciones durante la incorporación requieren una configuración nueva. Se puede restablecer el estado y repetir la incorporación, o usar openclaw migrate apply claude directamente, que admite --overwrite y el control explícito de las copias de seguridad.
Claude Desktop lee claude_desktop_config.json desde una ruta específica de la plataforma. Se debe apuntar --from al directorio de ese archivo si OpenClaw no lo detectó automáticamente.
Es intencional. Los comandos de Claude los activa el usuario, por lo que OpenClaw los importa como Skills con disable-model-invocation: true. Se puede editar el frontmatter de cada Skill para que el agente las invoque automáticamente.

​
Contenido relacionado