ClawHub

OpenClaw Backup

Automation

Backup OpenClaw data to desktop - quick backup (without skills, ~100MB) or full backup (with skills, ~500MB+). Supports scheduled automatic backups.

Install

openclaw skills install sen-openclaw-backup

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

ContentDescription
workspace/Project files, memory files, configurations
agents/Conversation history and session data
memory/Long-term memory embeddings
credentials/Encrypted credentials
openclaw.jsonMain configuration file
skills/Installed skills (optional, large)

Quick Start

macOS / Linux

Backup:

# 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:

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

Windows

Backup:

# 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:

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:

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

Examples:

# 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:

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

Examples:

./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:

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

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

Migration Workflow

Old Machine

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

# 2. Eject drive
diskutil eject /Volumes/SSD

New Machine

# 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
More in Automation