`openclaw backup`

Crea un archivo de respaldo local del estado, configuración, credenciales, sesiones y opcionalmente workspaces 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 manifest.json con las rutas de origen resueltas y la estructura del archivo.
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 origen respaldado, OpenClaw usa tu directorio home como ubicación por defecto del archivo.
Los archivos existentes nunca se sobrescriben.
Las rutas de salida dentro de los árboles de estado/workspace de origen se rechazan para evitar auto-inclusión.
openclaw backup verify <archive> valida que el archivo contenga exactamente un manifiesto raíz, rechaza rutas de archivo con estilo de traversal, y verifica que cada payload declarado en el manifiesto exista en el tarball.
openclaw backup create --verify ejecuta esa validación inmediatamente después de escribir el archivo.
openclaw backup create --only-config respalda solo el archivo de configuración activo.

Qué se respalda

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

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

Si usas --only-config, OpenClaw omite estado, credenciales y descubrimiento de workspace, y archiva solo la ruta del archivo de configuración activo.

OpenClaw canonicaliza las rutas antes de construir el archivo. Si la configuración, credenciales o un workspace ya residen dentro del directorio de estado, no se duplican como fuentes de respaldo de nivel superior separadas. Las rutas faltantes se omiten.

El payload del archivo almacena el contenido de los archivos de esos árboles de origen, y el manifest.json embebido registra las rutas absolutas de origen resueltas más la estructura del archivo usada para cada recurso.

Comportamiento con configuración inválida

openclaw backup omite intencionalmente la verificación previa normal de configuración para poder ayudar durante la recuperación. Dado que el descubrimiento de workspace depende de una configuración válida, openclaw backup create ahora falla rápidamente cuando el archivo de configuración existe pero es inválido y el respaldo de workspace sigue habilitado.

Si aún quieres un respaldo parcial en esa situación, vuelve a ejecutar:

openclaw backup create --no-include-workspace

Esto mantiene estado, configuración y credenciales en alcance mientras omite completamente el descubrimiento de workspace.

Si solo necesitas 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 workspace.

Tamaño y rendimiento

OpenClaw no impone un tamaño máximo de respaldo incorporado 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 temporal del archivo más el archivo final
Tiempo para recorrer árboles de workspace grandes y comprimirlos en un .tar.gz
Tiempo para re-escanear el archivo si usas openclaw backup create --verify o ejecutas openclaw backup verify
Comportamiento del sistema de archivos en la ruta de destino. OpenClaw prefiere un paso de publicación con hard-link sin sobrescritura y recurre a copia exclusiva cuando los hard links no están soportados

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

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