Skill Backup pour OpenClaw

Présentation du Skill Backup d'OpenClaw

Le skill Backup donne à votre agent OpenClaw la capacité de créer des snapshots et de restaurer l'intégralité de votre configuration — skills, commandes, paramètres, intégrations MCP, contextes et modèles — avec une simple demande en langage naturel. Si vous avez déjà perdu un setup fonctionnel après une mauvaise mise à jour ou un skill mal configuré, c'est le filet de sécurité dont vous avez besoin.

Les configurations d'OpenClaw sont réparties dans plusieurs répertoires et fichiers sous ~/.claude/. Suivre manuellement ce qui a changé et quand est fastidieux et source d'erreurs. Le skill OpenClaw Backup automatise l'ensemble du processus : il crée des archives tar.gz horodatées, prend en charge les modes de sauvegarde sélectifs et peut synchroniser votre setup entre machines via Git, rsync ou un stockage cloud comme Dropbox et Google Drive.

Flux de travail typique :

1. Demandez à OpenClaw de sauvegarder votre setup actuel avant d'installer un nouveau skill.
2. L'agent empaquette votre configuration dans une archive horodatée dans ~/openclaw-backups/.
3. Si quelque chose casse, demandez à OpenClaw de restaurer depuis la dernière sauvegarde — votre setup fonctionnel est de retour en quelques secondes.

Ce skill se combine naturellement avec le skill Config Guardian, qui valide les changements de configuration en temps réel, et le skill 1Password pour gérer en toute sécurité les tokens API inclus dans vos sauvegardes.

Prérequis pour le Skill Backup

Avant d'installer le skill Backup, assurez-vous d'avoir :

• OpenClaw installé et en fonctionnement (v1.0+)
• Suffisamment d'espace disque pour les archives de sauvegarde (généralement 5–50 Mo par snapshot selon le nombre de skills)
• clawhub CLI installé pour la gestion des skills
• Git (optionnel) — requis uniquement si vous souhaitez un historique de sauvegarde versionné

Vérifiez votre environnement :

# Vérifier la version d'OpenClaw
openclaw --version

# Vérifier l'espace disque disponible
df -h ~/openclaw-backups

# Vérifier clawhub CLI
clawhub --version

Comment Installer le Skill Backup

Installez le skill Backup avec une seule commande :

npx clawhub@latest install backup

Pour vérifier l'installation :

clawhub list

Vous devriez voir backup dans la liste des skills installés. Installez avec clawhub CLI pour l'expérience la plus rapide.

Configuration du Skill Backup

Le skill Backup fonctionne immédiatement avec des paramètres par défaut raisonnables. Vous pouvez personnaliser le comportement via des variables d'environnement.

Configuration de l'Environnement

# Répertoire de sauvegarde personnalisé (défaut : ~/openclaw-backups)
export OPENCLAW_BACKUP_DIR="$HOME/openclaw-backups"

# Nombre maximum de sauvegardes à conserver (défaut : 7)
export OPENCLAW_BACKUP_RETENTION=7

# Activer les sauvegardes automatiques avant les mises à jour (défaut : true)
export OPENCLAW_BACKUP_AUTO=true

Ce qui est Sauvegardé

Le skill archive par défaut les répertoires et fichiers suivants :

| Chemin | Contenu | |--------|---------| | ~/.claude/skills/ | Définitions des skills installés | | ~/.claude/commands/ | Commandes personnalisées | | ~/.claude/settings.json | Paramètres et préférences de l'agent | | ~/.claude/mcp/ | Configurations des serveurs MCP | | ~/.claude/contexts/ | Contextes de session | | ~/.claude/templates/ | Modèles personnalisés |

Les fichiers de cache et de logs sont automatiquement exclus — ils se régénèrent au démarrage et ne feraient qu'alourdir vos archives.

Important : Les archives de sauvegarde peuvent contenir des tokens API, des secrets et des identifiants stockés dans vos paramètres ou configurations MCP. Conservez les sauvegardes dans un emplacement sécurisé et ne les committez jamais dans des dépôts publics.

Exemples d'Utilisation du Skill Backup

1. Créer une Sauvegarde Complète

Vous : « Sauvegarde l'intégralité de mon setup OpenClaw avant que j'installe le nouveau skill Kubernetes. »

L'agent crée une archive horodatée (ex. openclaw-2026-03-13_1045.tar.gz) contenant tous les fichiers de configuration. Une fois terminé, il rapporte le chemin de l'archive, la taille et le nombre d'éléments.

2. Sauvegarde Sélective des Skills Uniquement

Vous : « Sauvegarde uniquement mes skills installés, je veux tester en supprimer quelques-uns. »

L'agent exécute une sauvegarde des skills uniquement, archivant seulement le répertoire ~/.claude/skills/. C'est plus rapide et produit un fichier plus petit quand vous n'avez besoin de protéger que les définitions de skills.

3. Restaurer depuis une Sauvegarde

Vous : « Quelque chose a cassé après cette mise à jour. Restaure depuis ma dernière sauvegarde. »

L'agent liste les sauvegardes disponibles, affiche la plus récente avec son horodatage et son contenu, et demande confirmation avant de restaurer. Il vérifie d'abord l'intégrité de l'archive, puis arrête l'agent, remplace la configuration actuelle et redémarre — votre setup fonctionnel est de retour.

4. Lister et Gérer les Sauvegardes

Vous : « Montre-moi toutes mes sauvegardes et l'espace qu'elles occupent. »

L'agent liste toutes les archives de votre répertoire de sauvegarde, triées par date, avec les tailles de fichiers. Il signale les sauvegardes dépassant la période de rétention et propose de les nettoyer.

5. Synchroniser les Sauvegardes vers un Remote

Vous : « Push ma dernière sauvegarde vers mon dépôt Git de backups. »

L'agent committe la dernière archive dans votre dépôt Git configuré et la pousse vers le remote. Cela permet un historique des versions et un accès multi-appareils — clonez le dépôt sur une autre machine et restaurez depuis n'importe quel snapshot.

Sécurité et Bonnes Pratiques de Backup

Les archives de sauvegarde contiennent votre configuration OpenClaw complète, qui peut inclure des données sensibles. Suivez ces recommandations pour rester en sécurité :

• Chiffrez les sauvegardes sensibles. Si votre configuration contient des clés API ou des tokens, chiffrez les archives avant de les stocker dans le cloud. Utilisez gpg ou votre gestionnaire de secrets.
• Restreignez les permissions de fichiers. Gardez les fichiers de sauvegarde lisibles uniquement par votre utilisateur : chmod 700 ~/openclaw-backups.
• Ne committez jamais de sauvegardes dans des dépôts publics. Ajoutez ~/openclaw-backups/ à votre .gitignore global pour prévenir toute exposition accidentelle.
• Effectuez une rotation des anciennes sauvegardes. Configurez OPENCLAW_BACKUP_RETENTION pour nettoyer automatiquement les anciennes archives. Sept sauvegardes est une valeur par défaut raisonnable.
• Vérifiez les restaurations périodiquement. Testez le processus de restauration avant d'en avoir réellement besoin. Restaurez dans un répertoire temporaire pour confirmer l'intégrité de l'archive.
• Utilisez Config Guardian avec Backup. Config Guardian valide les changements en temps réel, tandis que Backup fournit la récupération à un point dans le temps. Ensemble, ils forment un filet de sécurité complet. Consultez la Liste de Sécurité pour les recommandations générales de sécurité OpenClaw.

Résolution des Erreurs Courantes de Backup

"No backups found in ~/openclaw-backups"

Le répertoire de sauvegarde est vide ou n'existe pas.

1. Confirmez que le répertoire existe :

ls -la ~/openclaw-backups

2. Si vous avez personnalisé le chemin, vérifiez que OPENCLAW_BACKUP_DIR est correctement défini :

echo $OPENCLAW_BACKUP_DIR

3. Demandez à OpenClaw de créer la première sauvegarde : « Sauvegarde ma configuration maintenant. »

"Permission denied when creating backup archive"

Le répertoire de sauvegarde n'est pas accessible en écriture.

# Corriger les permissions
chmod 700 ~/openclaw-backups

# Ou créer le répertoire s'il manque
mkdir -p ~/openclaw-backups && chmod 700 ~/openclaw-backups

"Backup archive is corrupted — restore failed"

L'archive a été endommagée pendant le stockage ou le transfert.

1. Testez l'intégrité de l'archive :

tar -tzf ~/openclaw-backups/openclaw-2026-03-13_1045.tar.gz > /dev/null

2. Si corrompue, essayez la sauvegarde précédente dans la liste de rétention.
3. Pour les sauvegardes synchronisées avec Git, vérifiez si un ancien commit contient une archive saine : git log --oneline dans le dépôt de backup.