Crea copias de seguridad en OpenClaw: Guía rápida

¿Alguna vez has perdido horas configurando tu entorno de desarrollo solo para que un error inesperado borre todo tu progreso? No hay nada peor que intentar recordar cada detalle de tu setup cuando las cosas salen mal. Por eso, tener una estrategia de respaldo clara es fundamental para cualquier desarrollador que quiera evitar desastres innecesarios.

Mantener tus datos a salvo no debería ser un dolor de cabeza. Con la herramienta adecuada, puedes asegurar que tu configuración y tus workspaces estén protegidos y listos para ser recuperados en cualquier momento.

openclaw backup

Create a local backup archive for OpenClaw state, config, credentials, sessions, and optionally workspaces.

openclaw backup create
openclaw backup create --output ~/Backups
openclaw backup create --dry-run --json
openclaw backup create --verify
openclaw backup create --no-include-workspace
openclaw backup create --only-config
openclaw backup verify ./2026-03-09T00-00-00.000Z-openclaw-backup.tar.gz

Notas

• El archivo incluye un fichero manifest.json con las rutas de origen resueltas y la estructura del backup.
• La salida por defecto es un archivo .tar.gz con marca de tiempo en el directorio de trabajo actual.
• Si el directorio de trabajo actual está dentro de un árbol de archivos que ya forma parte del backup, OpenClaw usará tu directorio home como ubicación por defecto.
• Los archivos de backup existentes nunca se sobrescriben.
• Se rechazan las rutas de salida que estén dentro de los árboles de estado o de workspaces para evitar incluir el backup dentro de sí mismo.
• El comando openclaw backup verify <archive> valida que el backup contenga exactamente un manifest en la raíz, rechaza rutas de tipo traversal y comprueba que cada elemento declarado en el manifest exista en el tarball.
• Usar openclaw backup create --verify ejecuta esa validación inmediatamente después de crear el archivo.
• La opción openclaw backup create --only-config solo respalda el archivo de configuración JSON activo.

Qué se incluye en el backup

openclaw backup create planifica las fuentes de respaldo de tu instalación local de OpenClaw:

• El directorio de estado devuelto por el resolver de OpenClaw, normalmente ~/.openclaw.
• La ruta del archivo de configuración activo.
• El directorio de credenciales y OAuth.
• Los directorios de workspaces detectados en la configuración actual, a menos que pases el flag --no-include-workspace.

Si utilizas --only-config, OpenClaw ignora el estado, las credenciales y la detección de workspaces, archivando únicamente la ruta del archivo de configuración activo.

OpenClaw normaliza las rutas antes de generar el archivo. Si la configuración, las credenciales o un workspace ya viven dentro del directorio de estado, no se duplican como fuentes independientes. Las rutas que no existen se omiten.

El contenido del backup guarda los archivos de esos árboles de fuentes, y el manifest.json incluido registra las rutas absolutas originales junto con la estructura utilizada para cada recurso.

Comportamiento con configuraciones inválidas

openclaw backup omite intencionadamente la comprobación normal de la configuración para poder ayudarte incluso durante una recuperación. Como la detección de workspaces depende de una configuración válida, openclaw backup create falla rápidamente si el archivo de configuración existe pero no es válido y el respaldo de workspaces sigue activado.

Si necesitas un backup parcial en esa situación, ejecuta:

openclaw backup create --no-include-workspace

Esto mantiene el estado, la configuración y las credenciales dentro del backup mientras ignora por completo la detección de workspaces.

Si solo necesitas una copia del archivo de configuración, --only-config también funciona aunque el archivo esté mal formado, ya que no necesita procesar la configuración para buscar workspaces.

Tamaño y rendimiento

OpenClaw no impone un tamaño máximo de backup ni límites por archivo de forma interna.

Los límites prácticos dependen de tu máquina local y del sistema de archivos de destino:

• Espacio disponible para la escritura temporal del archivo más el backup final.
• Tiempo necesario para recorrer árboles de workspaces grandes y comprimirlos en un .tar.gz.
• Tiempo para volver a escanear el archivo si usas openclaw backup create --verify o ejecutas openclaw backup verify.
• El comportamiento del sistema de archivos en la ruta de destino. OpenClaw prefiere un paso de publicación mediante hard-link sin sobrescritura y usa una copia exclusiva si los hard links no están soportados.

Los workspaces grandes suelen ser el factor principal en el tamaño del backup. Si quieres un respaldo más pequeño o rápido, usa --no-include-workspace.

Para obtener el archivo más ligero posible, utiliza --only-config.

Próximos pasos

• Aprende a restaurar tus datos con la guía de recuperación.
• Configura backups automáticos en tu sistema.

AI Setup Assistant