Sauvegarde

`openclaw backup`

Crée une archive de sauvegarde locale pour l’état, la configuration, les profils d’authentification, les identifiants canal/fournisseur, les sessions d’OpenClaw et, en option, les espaces de travail.

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

Notes

L’archive comprend un fichier manifest.json avec les chemins source résolus et la structure de l’archive.
La sortie par défaut est une archive .tar.gz horodatée dans le répertoire de travail actuel.
Les noms de fichiers de sauvegarde horodatés utilisent le fuseau horaire local de votre machine et incluent le décalage UTC.
Si le répertoire de travail actuel se trouve à l’intérieur d’une arborescence source sauvegardée, OpenClaw revient par défaut à votre répertoire personnel pour l’emplacement de l’archive.
Les fichiers d’archive existants ne sont jamais écrasés.
Les chemins de sortie situés dans les arborescences d’état ou d’espace de travail source sont rejetés pour éviter l’auto-inclusion.
openclaw backup verify <archive> valide que l’archive contient exactement un manifeste racine, rejette les chemins d’archive de type traversée, et vérifie que chaque charge utile déclarée dans le manifeste existe dans le tarball.
openclaw backup create --verify exécute cette validation immédiatement après l’écriture de l’archive.
openclaw backup create --only-config sauvegarde uniquement le fichier de configuration JSON actif.

Ce qui est sauvegardé

openclaw backup create planifie les sources de sauvegarde à partir de votre installation locale de OpenClaw :

Le répertoire d’état renvoyé par le résolveur d’état local de OpenClaw, généralement ~/.openclaw
Le chemin du fichier de configuration actif
Le répertoire credentials/ résolu lorsqu’il existe en dehors du répertoire d’état
Les répertoires d’espace de travail découverts à partir de la configuration actuelle, sauf si vous passez --no-include-workspace

Les profils d’authentification de modèle font déjà partie du répertoire d’état sous agents/<agentId>/agent/auth-profiles.json, ils sont donc normalement couverts par l’entrée de sauvegarde de l’état.

Si vous utilisez --only-config, OpenClaw ignore l’état, le répertoire des identifiants et la découverte des espaces de travail, et n’archive que le chemin du fichier de configuration actif.

OpenClaw canonise les chemins avant de construire l’archive. Si la configuration, le dossier des identifiants ou un espace de travail se trouvent déjà dans le répertoire d’état, ils ne sont pas dupliqués en tant que sources de sauvegarde de niveau supérieur distinctes. Les chemins manquants sont ignorés.

La charge utile de l’archive stocke le contenu des fichiers de ces arborescences sources, et le manifest.json intégré enregistre les chemins source absolus résolus ainsi que la disposition de l’archive utilisée pour chaque élément.

Pendant la création de l’archive, OpenClaw ignore les fichiers connus de mutation en direct qui n’ont pas de valeur de restauration, y compris les transcriptions de session d’agent actif, les journaux d’exécution cron, les journaux rotatifs, les files de remise, les fichiers socket/pid/temp sous le répertoire d’état, et les fichiers temporaires de file d’attente durables associés. Le résultat JSON inclut skippedVolatileCount afin que l’automatisation puisse voir combien de fichiers ont été intentionnellement omis.

Les fichiers source et manifeste des plugins installés sous l’arborescence extensions/ du répertoire d’état sont inclus, mais leurs arborescences de dépendances node_modules/ imbriquées sont ignorées. Ces dépendances sont des artefacts d’installation reconstructibles ; après la restauration d’une archive, utilisez openclaw plugins update <id> ou réinstallez le plugin avec openclaw plugins install <spec> --force lorsqu’un plugin restauré signale des dépendances manquantes.

Comportement en cas de configuration invalide

openclaw backup contourne intentionnellement la préflight de configuration normale afin qu’il puisse toujours aider lors de la récupération. Étant donné que la découverte de l’espace de travail dépend d’une configuration valide, openclaw backup create échoue désormais rapidement lorsque le fichier de configuration existe mais est invalide et que la sauvegarde de l’espace de travail est toujours activée.

Si vous souhaitez tout de même une sauvegarde partielle dans cette situation, relancez :

openclaw backup create --no-include-workspace

Cela maintient l’état, la configuration et le répertoire des identifiants externes dans le périmètre tout en sautant entièrement la découverte de l’espace de travail.

Si vous avez uniquement besoin d’une copie du fichier de configuration lui-même, --only-config fonctionne également lorsque la configuration est malformée car il ne repose pas sur l’analyse de la configuration pour la découverte de l’espace de travail.

Taille et performance

OpenClaw n’impose pas de taille de sauvegarde maximale intégrée ni de limite de taille par fichier.

Les limites pratiques proviennent de la machine locale et du système de fichiers de destination :

Espace disponible pour l’écriture temporaire de l’archive plus l’archive finale
Temps nécessaire pour parcourir les grandes arborescences de l’espace de travail et les compresser dans un .tar.gz
Temps pour réanalyser l’archive si vous utilisez openclaw backup create --verify ou exécutez openclaw backup verify
Comportement du système de fichiers au chemin de destination. OpenClaw privilégie une étape de publication par lien dur (hard-link) sans écrasement et revient à une copie exclusive lorsque les liens durs ne sont pas pris en charge

Les espaces de travail volumineux sont généralement le principal facteur de taille de l’archive. Si vous souhaitez une sauvegarde plus petite ou plus rapide, utilisez --no-include-workspace.

Pour obtenir la plus petite archive, utilisez --only-config.

Connexes

Référence CLI