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

CLI commands

Migrar

openclaw migrate

Importa el estado desde otro sistema de agente mediante un proveedor de migración propiedad de un plugin. Los proveedores incluidos cubren el estado de Codex CLI, Claude y Hermes; los plugins de terceros pueden registrar proveedores adicionales.

Comandos

openclaw migrate list
openclaw migrate claude --dry-run
openclaw migrate codex --dry-run
openclaw migrate codex --skill gog-vault77-google-workspace
openclaw migrate hermes --dry-run
openclaw migrate hermes
openclaw migrate apply codex --yes --skill gog-vault77-google-workspace
openclaw migrate apply codex --yes
openclaw migrate apply claude --yes
openclaw migrate apply hermes --yes
openclaw migrate apply hermes --include-secrets --yes
openclaw onboard --flow import
openclaw onboard --import-from claude --import-source ~/.claude
openclaw onboard --import-from hermes --import-source ~/.hermes

OPENCLAW_DOCS_MARKER:paramOpen:IHBhdGg9Ijxwcm92aWRlcg " type="string"> Nombre de un proveedor de migración registrado, por ejemplo hermes. Ejecuta openclaw migrate list para ver los proveedores instalados.

--dry-runboolean

Crea el plan y sale sin cambiar el estado.

OPENCLAW_DOCS_MARKER:paramOpen:IHBhdGg9Ii0tZnJvbSA8cGF0aA " type="string"> Sobrescribe el directorio de estado de origen. Hermes usa ~/.hermes de forma predeterminada.

--include-secretsboolean

Importa credenciales compatibles. Desactivado de forma predeterminada.

--overwriteboolean

Permite que apply reemplace destinos existentes cuando el plan informa conflictos.

--yesboolean

Omite la solicitud de confirmación. Obligatorio en modo no interactivo.

"--skill
--no-backupboolean

Omite la copia de seguridad previa a apply. Requiere --force cuando existe estado local de OpenClaw.

--forceboolean

Obligatorio junto con --no-backup cuando apply rechazaría omitir la copia de seguridad.

--jsonboolean

Imprime el plan o el resultado de apply como JSON. Con --json y sin --yes, apply imprime el plan y no modifica el estado.

Modelo de seguridad

openclaw migrate prioriza la vista previa.

Vista previa antes de aplicar

El proveedor devuelve un plan detallado por elementos antes de que cambie nada, incluidos conflictos, elementos omitidos y elementos sensibles. Los planes JSON, la salida de apply y los informes de migración redactan claves anidadas que parecen secretas, como claves API, tokens, encabezados de autorización, cookies y contraseñas.

openclaw migrate apply <provider> muestra una vista previa del plan y solicita confirmación antes de cambiar el estado, a menos que se establezca --yes. En modo no interactivo, apply requiere --yes.

Copias de seguridad

Apply crea y verifica una copia de seguridad de OpenClaw antes de aplicar la migración. Si aún no existe estado local de OpenClaw, el paso de copia de seguridad se omite y la migración puede continuar. Para omitir una copia de seguridad cuando existe estado, pasa tanto --no-backup como --force.

Conflictos

Apply se niega a continuar cuando el plan tiene conflictos. Revisa el plan y vuelve a ejecutar con --overwrite si reemplazar destinos existentes es intencional. Los proveedores aún pueden escribir copias de seguridad a nivel de elemento para archivos sobrescritos en el directorio de informes de migración.

Secretos

Los secretos nunca se importan de forma predeterminada. Usa --include-secrets para importar credenciales compatibles.

Proveedor de Claude

El proveedor de Claude incluido detecta el estado de Claude Code en ~/.claude de forma predeterminada. Usa --from <path> para importar un directorio home de Claude Code o una raíz de proyecto específicos.

Qué importa Claude

  • CLAUDE.md del proyecto y .claude/CLAUDE.md en el espacio de trabajo del agente de OpenClaw.
  • ~/.claude/CLAUDE.md del usuario añadido a USER.md del espacio de trabajo.
  • Definiciones de servidores MCP desde .mcp.json del proyecto, ~/.claude.json de Claude Code y claude_desktop_config.json de Claude Desktop.
  • Directorios de skills de Claude que incluyen SKILL.md.
  • Archivos Markdown de comandos de Claude convertidos en skills de OpenClaw solo con invocación manual.

Estado archivado y de revisión manual

Los hooks de Claude, permisos, valores predeterminados de entorno, memoria local, reglas con alcance de ruta, subagentes, cachés, planes e historial del proyecto se conservan en el informe de migración o se informan como elementos de revisión manual. OpenClaw no ejecuta hooks, no copia listas de permisos amplias ni importa automáticamente el estado de credenciales de OAuth/Desktop.

Proveedor de Codex

El proveedor de Codex incluido detecta el estado de Codex CLI en ~/.codex de forma predeterminada, o en CODEX_HOME cuando esa variable de entorno está establecida. Usa --from <path> para inventariar un directorio home de Codex específico.

Usa este proveedor al pasar al arnés de Codex de OpenClaw y cuando quieras promover deliberadamente recursos personales útiles de Codex CLI. Los lanzamientos locales del servidor de aplicaciones de Codex usan directorios CODEX_HOME y HOME por agente, por lo que no leen tu estado personal de Codex CLI de forma predeterminada.

Ejecutar openclaw migrate codex en una terminal interactiva muestra una vista previa del plan completo y luego abre un selector con casillas para los elementos de copia de skills antes de la confirmación final de apply. Usa Toggle all on o Toggle all off para selección masiva; los skills planificados empiezan marcados, los skills en conflicto empiezan desmarcados y Skip for now deja los skills sin cambios sin aplicar. Para ejecuciones mediante script o exactas, pasa --skill <name> una vez por skill, por ejemplo:

openclaw migrate codex --dry-run --skill gog-vault77-google-workspace
openclaw migrate apply codex --yes --skill gog-vault77-google-workspace

Qué importa Codex

  • Directorios de skills de Codex CLI bajo $CODEX_HOME/skills, excluida la caché .system de Codex.
  • AgentSkills personales bajo $HOME/.agents/skills, copiados en el espacio de trabajo actual del agente de OpenClaw cuando quieres propiedad por agente.

Estado de Codex de revisión manual

Los plugins nativos de Codex, config.toml y los hooks/hooks.json nativos no se activan automáticamente. Los plugins pueden exponer servidores MCP, aplicaciones, hooks u otro comportamiento ejecutable, por lo que el proveedor los informa para revisión en lugar de cargarlos en OpenClaw. Los archivos de configuración y hooks se copian en el informe de migración para revisión manual.

Proveedor de Hermes

El proveedor de Hermes incluido detecta el estado en ~/.hermes de forma predeterminada. Usa --from <path> cuando Hermes viva en otro lugar.

Qué importa Hermes

  • Configuración de modelo predeterminada desde config.yaml.
  • Proveedores de modelos configurados y endpoints personalizados compatibles con OpenAI desde providers y custom_providers.
  • Definiciones de servidores MCP desde mcp_servers o mcp.servers.
  • SOUL.md y AGENTS.md en el espacio de trabajo del agente de OpenClaw.
  • memories/MEMORY.md y memories/USER.md añadidos a los archivos de memoria del espacio de trabajo.
  • Valores predeterminados de configuración de memoria para memoria de archivo de OpenClaw, más elementos archivados o de revisión manual para proveedores de memoria externos como Honcho.
  • Skills que incluyen un archivo SKILL.md bajo skills/<name>/.
  • Valores de configuración por skill desde skills.config.
  • Claves API compatibles desde .env, solo con --include-secrets.

Claves .env compatibles

OPENAI_API_KEY, ANTHROPIC_API_KEY, OPENROUTER_API_KEY, GOOGLE_API_KEY, GEMINI_API_KEY, GROQ_API_KEY, XAI_API_KEY, MISTRAL_API_KEY, DEEPSEEK_API_KEY.

Estado solo archivado

El estado de Hermes que OpenClaw no puede interpretar de forma segura se copia en el informe de migración para revisión manual, pero no se carga en la configuración ni en las credenciales activas de OpenClaw. Esto conserva el estado opaco o inseguro sin fingir que OpenClaw puede ejecutarlo o confiar en él automáticamente:

  • plugins/
  • sessions/
  • logs/
  • cron/
  • mcp-tokens/
  • auth.json
  • state.db

Después de aplicar

openclaw doctor

Contrato de Plugin

Las fuentes de migración son plugins. Un plugin declara sus ids de proveedor en openclaw.plugin.json:

{
  "contracts": {
    "migrationProviders": ["hermes"]
  }
}

En tiempo de ejecución, el plugin llama a api.registerMigrationProvider(...). El proveedor implementa detect, plan y apply. Core posee la orquestación de CLI, la política de copias de seguridad, las solicitudes, la salida JSON y la comprobación previa de conflictos. Core pasa el plan revisado a apply(ctx, plan), y los proveedores pueden reconstruir el plan solo cuando ese argumento falta por compatibilidad.

Los plugins proveedores pueden usar openclaw/plugin-sdk/migration para construcción de elementos y conteos de resumen, además de openclaw/plugin-sdk/migration-runtime para copias de archivos conscientes de conflictos, copias de informes solo archivadas, wrappers de runtime de configuración en caché e informes de migración.

Integración de incorporación

La incorporación puede ofrecer migración cuando un proveedor detecta un origen conocido. Tanto openclaw onboard --flow import como openclaw setup --wizard --import-from hermes usan el mismo proveedor de migración de plugin y siguen mostrando una vista previa antes de aplicar.

Relacionado