Sauvegarde et restauration des fichiers d'espace de travail

Les fichiers d'espace de travail définissent la personnalité, la mémoire et le contexte utilisateur de votre agent. Ils persistent à travers les redémarrages du sandbox mais sont supprimés définitivement quand vous exécutez nemoclaw <name> destroy.

Ce guide couvre les commandes de snapshot, la sauvegarde manuelle avec des commandes CLI, et un script automatisé.

Étape 1 : Quand faire une sauvegarde

Avant d'exécuter nemoclaw <name> destroy
Avant les mises à jour majeures de NemoClaw
Régulièrement, si vous avez investi du temps dans la personnalisation de votre agent

Étape 2 : Commandes de snapshot

Le moyen le plus rapide de sauvegarder et restaurer l'état du sandbox est d'utiliser les commandes de snapshot intégrées. Les snapshots capturent tous les répertoires d'état d'espace de travail définis dans le manifeste de l'agent et les stockent dans ~/.nemoclaw/rebuild-backups/<name>/.

$ nemoclaw my-assistant snapshot create
$ nemoclaw my-assistant snapshot list
$ nemoclaw my-assistant snapshot restore

snapshot list affiche un tableau avec la version, le nom, l'horodatage et le chemin. Les versions (v1, v2, ..., vN) sont calculées à partir de l'ordre des horodatages, donc vN est toujours le snapshot le plus récent.

Pour étiqueter un snapshot avec un label lisible par l'humain, passez --name :

$ nemoclaw my-assistant snapshot create --name before-upgrade

Pour restaurer un snapshot spécifique au lieu du plus récent, passez une version, un nom ou un préfixe d'horodatage :

$ nemoclaw my-assistant snapshot restore v3
$ nemoclaw my-assistant snapshot restore before-upgrade
$ nemoclaw my-assistant snapshot restore 2026-04-14T

La commande nemoclaw <name> rebuild utilise automatiquement le même mécanisme de snapshot. La restauration de snapshot effectue une réparation ciblée pour les anciens liens symboliques .openclaw-data créés par les images antérieures. Les liens symboliques non sûrs et les liens physiques à l'intérieur de l'état du sandbox sont rejetés lors de la création de la sauvegarde avant qu'ils ne puissent entrer dans un snapshot. Pour plus de détails, consultez la référence des commandes (utilisez la skill nemoclaw-user-reference).

Étape 3 : Sauvegarde manuelle

Utilisez openshell sandbox download pour copier des fichiers du sandbox vers votre hôte.

$ SANDBOX=my-assistant
$ BACKUP_DIR=~/.nemoclaw/backups/$(date +%Y%m%d-%H%M%S)
$ mkdir -p "$BACKUP_DIR"

$ openshell sandbox download "$SANDBOX" /sandbox/.openclaw/workspace/SOUL.md "$BACKUP_DIR/"
$ openshell sandbox download "$SANDBOX" /sandbox/.openclaw/workspace/USER.md "$BACKUP_DIR/"
$ openshell sandbox download "$SANDBOX" /sandbox/.openclaw/workspace/IDENTITY.md "$BACKUP_DIR/"
$ openshell sandbox download "$SANDBOX" /sandbox/.openclaw/workspace/AGENTS.md "$BACKUP_DIR/"
$ openshell sandbox download "$SANDBOX" /sandbox/.openclaw/workspace/MEMORY.md "$BACKUP_DIR/"
$ openshell sandbox download "$SANDBOX" /sandbox/.openclaw/workspace/memory/ "$BACKUP_DIR/memory/"

Étape 4 : Restauration manuelle

Utilisez openshell sandbox upload pour repousser des fichiers dans un sandbox.

$ SANDBOX=my-assistant
$ BACKUP_DIR=~/.nemoclaw/backups/20260320-120000  # choisir un horodatage

$ openshell sandbox upload "$SANDBOX" "$BACKUP_DIR/SOUL.md" /sandbox/.openclaw/workspace/
$ openshell sandbox upload "$SANDBOX" "$BACKUP_DIR/USER.md" /sandbox/.openclaw/workspace/
$ openshell sandbox upload "$SANDBOX" "$BACKUP_DIR/IDENTITY.md" /sandbox/.openclaw/workspace/
$ openshell sandbox upload "$SANDBOX" "$BACKUP_DIR/AGENTS.md" /sandbox/.openclaw/workspace/
$ openshell sandbox upload "$SANDBOX" "$BACKUP_DIR/MEMORY.md" /sandbox/.openclaw/workspace/
$ openshell sandbox upload "$SANDBOX" "$BACKUP_DIR/memory/" /sandbox/.openclaw/workspace/memory/

Étape 5 : Utiliser le script de sauvegarde

Le repository inclut un script pratique à scripts/backup-workspace.sh.

Sauvegarde

$ ./scripts/backup-workspace.sh backup my-assistant
Backing up workspace from sandbox 'my-assistant'...
Backup saved to /home/user/.nemoclaw/backups/20260320-120000/ (6 items)

Restauration

Restaurer à partir de la sauvegarde la plus récente :

$ ./scripts/backup-workspace.sh restore my-assistant

Restaurer à partir d'un horodatage spécifique :

$ ./scripts/backup-workspace.sh restore my-assistant 20260320-120000

Étape 6 : Vérifier une sauvegarde

Lister les fichiers sauvegardés pour confirmer la complétude :

$ ls -la ~/.nemoclaw/backups/20260320-120000/
AGENTS.md
IDENTITY.md
MEMORY.md
SOUL.md
USER.md
memory/

Étape 7 : Déploiements multi-agents

Quand OpenClaw est configuré avec plusieurs agents nommés, chaque agent a son propre répertoire d'espace de travail (workspace-main/, workspace-support/, workspace-ops/, et ainsi de suite — voir Multi-Agent Deployments (utilisez la skill nemoclaw-user-workspace)).

nemoclaw <name> snapshot create découvre automatiquement chaque répertoire workspace-*/ sous l'arborescence d'état du sandbox et l'inclut dans le bundle de snapshot aux côtés du workspace/ par défaut. snapshot restore réapplique l'ensemble complet par agent. Aucun motif de sauvegarde manuelle par espace de travail n'est nécessaire.

Le point d'entrée du sandbox garantit que chaque espace de travail par agent vit directement sous l'arborescence .openclaw/ persistante, donc l'état survit aussi à openshell sandbox restart.

Fichiers partagés entre agents

Les fichiers que les opérateurs veulent généralement cohérents à travers chaque espace de travail par agent (AGENTS.md, skills partagées, modèles courants) ne sont pas synchronisés automatiquement. Chaque espace de travail est indépendant ; les modifications dans l'un ne se propagent pas aux autres. Les opérateurs qui en ont besoin copient explicitement les fichiers partagés dans chaque espace de travail après édition, ou maintiennent une couche de synchronisation côté hôte. Le suivi des outils pour fichiers partagés (montage partagé, commande workspaces list) se trouve dans #1260.

Références

Charger references/workspace-files.md quand les utilisateurs posent des questions sur SOUL.md, USER.md, IDENTITY.md, AGENTS.md, ou d'autres fichiers d'espace de travail, ou lors de la préparation de la sauvegarde ou restauration de l'état d'espace de travail. Explique ce que sont les fichiers de personnalité et de configuration d'espace de travail, où ils résident, et comment ils persistent à travers les redémarrages du sandbox.

Skills connexes

nemoclaw-user-reference — Référence des commandes (utilisez la skill nemoclaw-user-reference)