> ## Documentation Index > Fetch the complete documentation index at: https://openclaw.veiseule.ai/llms.txt > Use this file to discover all available pages before exploring further. # Guía de migración # Migración de OpenClaw a una nueva máquina Esta guía migra un Gateway de OpenClaw de una máquina a otra **sin rehacer el onboarding**. La migración es simple en concepto: * Copiar el **directorio de estado** (`$OPENCLAW_STATE_DIR`, predeterminado: `~/.openclaw/`) — esto incluye configuración, autenticación, sesiones y estado de canales. * Copiar su **workspace** (`~/.openclaw/workspace/` de forma predeterminada) — esto incluye sus archivos de agente (memoria, prompts, etc.). Pero existen errores comunes relacionados con **perfiles**, **permisos** y **copias parciales**. ## Antes de empezar (qué va a migrar) ### 1. Identifique su directorio de estado La mayoría de las instalaciones usan el valor predeterminado: * **Directorio de estado:** `~/.openclaw/` Pero puede ser diferente si usa: * `--profile ` (a menudo se convierte en `~/.openclaw-/`) * `OPENCLAW_STATE_DIR=/some/path` Si no está seguro, ejecute en la máquina **antigua**: ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} openclaw status ``` Busque menciones de `OPENCLAW_STATE_DIR` / perfil en la salida. Si ejecuta múltiples gateways, repita para cada perfil. ### 2. Identifique su workspace Valores predeterminados comunes: * `~/.openclaw/workspace/` (workspace recomendado) * una carpeta personalizada que usted creó Su workspace es donde viven archivos como `MEMORY.md`, `USER.md` y `memory/*.md`. ### 3. Entienda qué conservará Si copia **ambos** el directorio de estado y el workspace, conservará: * Configuración del Gateway (`openclaw.json`) * Perfiles de autenticación / claves de API / tokens OAuth * Historial de sesiones + estado del agente * Estado de canales (p. ej., inicio de sesión/sesión de WhatsApp) * Sus archivos del workspace (memoria, notas de Skills, etc.) Si copia **solo** el workspace (p. ej., mediante Git), **no** conservará: * sesiones * credenciales * inicios de sesión de canales Estos viven bajo `$OPENCLAW_STATE_DIR`. ## Pasos de migración (recomendado) ### Paso 0 — Haga un respaldo (máquina antigua) En la máquina **antigua**, detenga primero el gateway para que los archivos no cambien durante la copia: ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} openclaw gateway stop ``` (Opcional pero recomendado) archive el directorio de estado y el workspace: ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} # Adjust paths if you use a profile or custom locations cd ~ tar -czf openclaw-state.tgz .openclaw tar -czf openclaw-workspace.tgz .openclaw/workspace ``` Si tiene múltiples perfiles/directorios de estado (p. ej., `~/.openclaw-main`, `~/.openclaw-work`), archive cada uno. ### Paso 1 — Instale OpenClaw en la nueva máquina En la máquina **nueva**, instale la CLI (y Node si es necesario): * Ver: [Install](/install) En esta etapa, está bien si el onboarding crea un `~/.openclaw/` nuevo — lo sobrescribirá en el siguiente paso. ### Paso 2 — Copie el directorio de estado + el workspace a la nueva máquina Copie **ambos**: * `$OPENCLAW_STATE_DIR` (predeterminado `~/.openclaw/`) * su workspace (predeterminado `~/.openclaw/workspace/`) Enfoques comunes: * `scp` los tarballs y extraer * `rsync -a` por SSH * unidad externa Después de copiar, asegúrese de que: * Se incluyeron directorios ocultos (p. ej., `.openclaw/`) * La propiedad de los archivos sea correcta para el usuario que ejecuta el gateway ### Paso 3 — Ejecute Doctor (migraciones + reparación de servicios) En la máquina **nueva**: ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} openclaw doctor ``` Doctor es el comando “seguro y aburrido”. Repara servicios, aplica migraciones de configuración y advierte sobre discrepancias. Luego: ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} openclaw gateway restart openclaw status ``` ## Pistolas comunes (y cómo evitarlas) ### Error común: desajuste de perfil / directorio de estado Si ejecutó el gateway antiguo con un perfil (o `OPENCLAW_STATE_DIR`), y el gateway nuevo usa uno diferente, verá síntomas como: * los cambios de configuración no tienen efecto * canales ausentes / cerraron sesión * historial de sesiones vacío Solución: ejecute el gateway/servicio usando el **mismo** perfil/directorio de estado que migró y luego vuelva a ejecutar: ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} openclaw doctor ``` ### Error común: copiar solo `openclaw.json` `openclaw.json` no es suficiente. Muchos proveedores almacenan estado bajo: * `$OPENCLAW_STATE_DIR/credentials/` * `$OPENCLAW_STATE_DIR/agents//...` Siempre migre la carpeta completa `$OPENCLAW_STATE_DIR`. ### Error común: permisos / propiedad Si copió como root o cambió de usuario, el gateway puede no poder leer credenciales/sesiones. Solución: asegúrese de que el directorio de estado + el workspace pertenezcan al usuario que ejecuta el gateway. ### Error común: migrar entre modos remoto/local * Si su UI (WebUI/TUI) apunta a un gateway **remoto**, el host remoto es el propietario del almacén de sesiones + el workspace. * Migrar su laptop no moverá el estado del gateway remoto. Si está en modo remoto, migre el **host del Gateway**. ### Error común: secretos en los respaldos `$OPENCLAW_STATE_DIR` contiene secretos (claves de API, tokens OAuth, credenciales de WhatsApp). Trate los respaldos como secretos de producción: * almacénelos cifrados * evite compartirlos por canales inseguros * rote las claves si sospecha exposición ## Lista de verificación de validación En la máquina nueva, confirme: * `openclaw status` muestra el gateway en ejecución * Sus canales siguen conectados (p. ej., WhatsApp no requiere volver a emparejar) * El panel se abre y muestra las sesiones existentes * Sus archivos del workspace (memoria, configuraciones) están presentes ## Relacionado * [Doctor](/gateway/doctor) * [Solución de problemas del Gateway](/gateway/troubleshooting) * [¿Dónde almacena OpenClaw sus datos?](/help/faq#where-does-openclaw-store-its-data)