OpenClaw Backup Skill#

快速使用 / Quick Start:

安装： 安装 sen-openclaw-backup skill

备份： 备份 OpenClaw 数据到桌面，快速备份（不含 skills，约 100MB）或完整备份（含 skills，约 500MB+），并设置每周自动备份

---

Backup and restore all OpenClaw data for migration or safekeeping.

What Gets Backed Up#

ContentDescriptionworkspace/Project files, memory files, configurationsagents/Conversation history and session datamemory/Long-term memory embeddingscredentials/Encrypted credentialsopenclaw.jsonMain configuration fileskills/Installed skills (optional, large)

Quick Start#

macOS / Linux#

Backup:

bash

# Quick backup (excludes skills, ~100MB)
./scripts/backup.sh /Volumes/YourSSD/backup.tar.gz

# Full backup (includes skills, ~500MB+)
INCLUDE_SKILLS=1 ./scripts/backup.sh /Volumes/YourSSD/backup.tar.gz

Restore:

bash

./scripts/restore.sh /Volumes/YourSSD/backup.tar.gz

Windows#

Backup:

cmd

# Quick backup
scripts\backup-windows.bat D:\backup.tar.gz

# Full backup with skills
set INCLUDE_SKILLS=1
scripts\backup-windows.bat D:\backup.tar.gz

Restore:

cmd

scripts\restore-windows.bat D:\backup.tar.gz

Scripts#

backup.sh#

Creates a compressed archive of OpenClaw data.

Environment Variables:

• INCLUDE_SKILLS=1 - Include skills directory (adds ~1.5GB)

Usage:

bash

./scripts/backup.sh [output-path]

Examples:

bash

# Backup to default location (Desktop with timestamp)
./scripts/backup.sh

# Backup to specific location
./scripts/backup.sh /Volumes/SSD/openclaw-backup.tar.gz

# Full backup with skills
INCLUDE_SKILLS=1 ./scripts/backup.sh /Volumes/SSD/openclaw-full.tar.gz

restore.sh (macOS/Linux)#

Restores OpenClaw data from a backup archive.

Features:

• Automatically backs up existing data before overwriting
• Installs OpenClaw if not present
• Optionally syncs skills after restore

Usage:

bash

./scripts/restore.sh <backup-file>

Examples:

bash

./scripts/restore.sh /Volumes/SSD/openclaw-backup-20250318.tar.gz

backup-windows.bat / restore-windows.bat (Windows)#

Windows batch scripts for backup and restore.

Requirements:

• Windows 10 version 17063 or later (for built-in tar support)
• Node.js and npm installed

Usage:

cmd

# Backup
scripts\backup-windows.bat D:\openclaw-backup.tar.gz

# Restore
scripts\restore-windows.bat D:\openclaw-backup.tar.gz

Migration Workflow#

Old Machine#

bash

# 1. Run backup
./scripts/backup.sh /Volumes/SSD/openclaw-backup.tar.gz

# 2. Eject drive
diskutil eject /Volumes/SSD

New Machine#

bash

# 1. Install OpenClaw (if needed)
npm install -g openclaw@latest

# 2. Restore data
./scripts/restore.sh /Volumes/SSD/openclaw-backup.tar.gz

# 3. Start Gateway
openclaw gateway start

Portable Package / 便携包#

For easy migration, use the portable ZIP package which includes:

• Data backup file
• One-click restore scripts for macOS and Windows
• Command-line backup/restore scripts
• Skill installation package

Changelog#

v1.1.0#

• Added portable ZIP package creation
• Improved Windows batch scripts
• Added bilingual README

v1.0.0#

• Initial release
• Cross-platform backup and restore
• One-click restore scripts

Notes#

• Backup files are gzip-compressed tar archives
• Existing data is preserved with .bak.<timestamp> suffix before restore
• Skills can be re-downloaded via clawhub sync if excluded from backup
• Configuration files may need adjustment if paths differ between machines