backup

openclaw backup

Crea un archivo de copia de seguridad local para el estado, la configuración, las credenciales, las sesiones y, opcionalmente, los espacios de trabajo de OpenClaw.

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 archivo manifest.json con las rutas de origen resueltas y el diseño del archivo.
• La salida predeterminada 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 origen respaldado, OpenClaw recurre a su directorio de inicio para la ubicación predeterminada del archivo.
• Los archivos de archivo existentes nunca se sobrescriben.
• Las rutas de salida dentro de los árboles de estado/espacio de trabajo de origen se rechazan para evitar la autoinclusión.
• openclaw backup verify <archive> valida que el archivo contenga exactamente un manifiesto raíz, rechaza las rutas de archivo de estilo transversal y verifica que cada carga declarada en el manifiesto exista en el archivo tar.
• openclaw backup create --verify ejecuta esa validación inmediatamente después de escribir el archivo.
• openclaw backup create --only-config realiza una copia de seguridad solo del archivo de configuración JSON activo.

Qué se respalda

openclaw backup create planifica los orígenes de la copia de seguridad desde su instalación local de OpenClaw:

• El directorio de estado devuelto por el solucionador de estado local de OpenClaw, generalmente ~/.openclaw
• La ruta del archivo de configuración activo
• El directorio de OAuth / credenciales
• Directorios de espacio de trabajo descubiertos desde la configuración actual, a menos que pase --no-include-workspace

Si usa --only-config, OpenClaw omite el estado, las credenciales y el descubrimiento de espacios de trabajo y archiva solo la ruta del archivo de configuración activo.

OpenClaw canoniciza las rutas antes de crear el archivo. Si la configuración, las credenciales o un espacio de trabajo ya residen dentro del directorio de estado, no se duplican como fuentes de copia de seguridad de nivel superior. Las rutas faltantes se omiten.

La carga útil del archivo almacena el contenido de los archivos de esos árboles de origen, y el manifest.json incrustado registra las rutas de origen absolutas resueltas más el diseño de archivo utilizado para cada activo.

Comportamiento de configuración no válida

openclaw backup omite intencionalmente la verificación previa normal de configuración para que aún pueda ayudar durante la recuperación. Dado que el descubrimiento de espacios de trabajo depende de una configuración válida, openclaw backup create ahora falla rápidamente cuando el archivo de configuración existe pero no es válido y la copia de seguridad del espacio de trabajo todavía está habilitada.

Si aún desea una copia de seguridad parcial en esa situación, vuelva a ejecutar:

openclaw backup create --no-include-workspace

Eso mantiene el estado, la configuración y las credenciales dentro del alcance mientras omite completamente el descubrimiento de espacios de trabajo.

Si solo necesita una copia del archivo de configuración en sí, --only-config también funciona cuando la configuración está malformada porque no depende del análisis de la configuración para el descubrimiento de espacios de trabajo.

Tamaño y rendimiento

OpenClaw no impone un tamaño máximo de copia de seguridad integrado ni un límite de tamaño por archivo.

Los límites prácticos provienen de la máquina local y el sistema de archivos de destino:

• Espacio disponible para la escritura del archivo temporal más el archivo final
• Tiempo para recorrer grandes árboles de espacios de trabajo y comprimirlos en un .tar.gz
• Tiempo para volver a escanear el archivo si usa openclaw backup create --verify o ejecuta openclaw backup verify
• Comportamiento del sistema de archivos en la ruta de destino. OpenClaw prefiere un paso de publicación de enlaces duros sin sobrescritura y recurre a una copia exclusiva cuando los enlaces duros no son compatibles

Los espacios de trabajo grandes suelen ser el principal factor del tamaño del archivo. Si desea una copia de seguridad más pequeña o más rápida, use --no-include-workspace.

Para el archivo más pequeño, use --only-config.