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

Maintenance

Migración desde Claude

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 modificar el estado, oculta los secretos en los planes e informes y crea una copia de seguridad verificada antes de aplicar los cambios.

Dos formas de importar

Asistente de incorporación

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

bash
openclaw onboard --flow import

También puedes indicar un origen específico:

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

CLI

Usa openclaw migrate para ejecuciones automatizadas o repetibles. Consulta openclaw migrate para ver la referencia completa.

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

Añade --from <path> para importar un directorio principal de Claude Code o una raíz de proyecto específicos.

Qué se importa

Instrucciones y memoria
  • El contenido de CLAUDE.md y .claude/CLAUDE.md del proyecto se copia o se añade al archivo AGENTS.md del espacio de trabajo del agente de OpenClaw.
  • El contenido de ~/.claude/CLAUDE.md del usuario se añade al archivo USER.md del espacio de trabajo.
Servidores MCP

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.

Skills y comandos
  • Las Skills de Claude que tienen 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 los siguientes 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 decodificar automáticamente el estado opaco de credenciales de OAuth y Desktop. Tras revisar el archivo, mueve manualmente lo que necesites.

Selección del origen

Sin --from, OpenClaw inspecciona el directorio principal predeterminado de Claude Code en ~/.claude, el archivo de estado muestreado ~/.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

  • Previsualizar el plan

    bash
    openclaw migrate claude --dry-run

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

  • Aplicar con copia de seguridad

    bash
    openclaw migrate apply claude --yes

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

  • Ejecutar el diagnóstico

    bash
    openclaw doctor

    Diagnóstico comprueba si hay problemas de configuración o estado después de la importación.

  • Reiniciar y verificar

    bash
    openclaw gateway restartopenclaw status

    Confirma que el Gateway funciona correctamente y que se han cargado las instrucciones, los servidores MCP y las Skills importados.

    • Gestión de conflictos

    La aplicación se niega a continuar cuando el plan informa de conflictos, es decir, cuando ya existe un archivo o valor de configuración en el destino.

    En una instalación nueva de OpenClaw, los conflictos son poco habituales. Normalmente aparecen al volver a ejecutar la importación en una instalación que ya contiene modificaciones del usuario.

    Salida JSON para automatización

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

    --yes es obligatorio para migrate apply fuera de una terminal interactiva; sin esta opción, OpenClaw genera un error en lugar de aplicar los cambios, por lo que los scripts y la integración continua deben pasar --yes explícitamente. Primero previsualiza con --dry-run --json y, cuando el plan sea correcto, aplica los cambios con --json --yes.

    Solución de problemas

    El estado de Claude está fuera de ~/.claude

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

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

    Las importaciones durante la incorporación requieren una instalación nueva. Restablece el estado y repite la incorporación, o usa directamente openclaw migrate apply claude, que admite --overwrite y el control explícito de las 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. Si OpenClaw no lo detectó automáticamente, apunta --from al directorio de ese archivo.

    Los comandos de Claude se convirtieron en Skills con la invocación por el modelo desactivada

    Es el comportamiento previsto. Los comandos de Claude los activa el usuario, por lo que OpenClaw los importa como Skills con disable-model-invocation: true. Edita el frontmatter de cada Skill si quieres que el agente las invoque automáticamente.

    Contenido relacionado

    Was this useful?
    On this page

    On this page