Copia de seguridad

`openclaw backup`

Cree un archivo de copia de seguridad local para el estado, la configuración, los perfiles de autenticación, las credenciales de canal/proveedor, 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-09T08-00-00.000+08-00-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.
Los nombres de archivo de copia de seguridad con marca de tiempo usan la zona horaria local de su máquina e incluyen el desfase UTC.
Si el directorio de trabajo actual se encuentra dentro de un árbol de origen respaldado, OpenClaw vuelve 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 de cruce y comprueba que cada carga útil 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 hace 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 credentials/ resuelto cuando existe fuera del directorio de estado
Los directorios del espacio de trabajo descubiertos desde la configuración actual, a menos que pase --no-include-workspace

Los perfiles de autenticación del modelo ya forman parte del directorio de estado en agents/<agentId>/agent/auth-profiles.json, por lo que normalmente están cubiertos por la entrada de copia de seguridad del estado.

Si usa --only-config, OpenClaw omite el estado, el directorio de credenciales y el descubrimiento del espacio 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, el directorio de credenciales o un espacio de trabajo ya residen dentro del directorio de estado, no se duplican como orígenes de copia de seguridad de nivel superior separados. 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 además del diseño del archivo utilizado para cada activo.

Durante la creación del archivo, OpenClaw omite los archivos conocidos de mutación en vivo que no tienen valor de restauración, incluidas las transcripciones de sesión del agente activo, los registros de ejecución de cron, los registros acumulativos, las colas de entrega, los archivos socket/pid/temp en el directorio de estado y los archivos temporales de cola durables relacionados. El resultado JSON incluye skippedVolatileCount para que la automatización pueda ver cuántos archivos se omitieron intencionalmente.

Se incluyen los archivos de código fuente y manifiesto de los complementos instalados en el árbol extensions/ del directorio de estado, pero se omiten sus árboles de dependencias node_modules/ anidados. Esas dependencias son artefactos de instalación reconstruibles; después de restaurar un archivo, use openclaw plugins update <id> o reinstale el complemento con openclaw plugins install <spec> --force cuando un complemento restaurado reporte dependencias faltantes.

Comportamiento de configuración no válida

openclaw backup omite intencionalmente la verificación previa normal de la 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 el directorio de credenciales externas dentro del alcance mientras omite por completo el descubrimiento del espacio 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 del espacio 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 temporal del archivo más el archivo final
Tiempo para recorrer árboles grandes 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 con enlaces duros (hard-links) sin sobrescritura y recurre a una copia exclusiva cuando no se admiten enlaces duros

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.

Relacionado

Referencia de CLI