OpenClaw 备份实战指南：混合策略与自动化脚本

#!/usr/bin/env bash
set -euo pipefail

# OpenClaw backup script (console-only, no agent dependency)
# Mode: first full backup + daily incremental snapshots via rsync --link-dest

SRC_ROOT="/root/.openclaw"
BACKUP_ROOT="/root/backups/openclaw"
TS="$(date +%F-%H%M%S)"
LATEST_LINK="$BACKUP_ROOT/latest"
SNAP_DIR="$BACKUP_ROOT/snapshots/$TS"
LOG_DIR="$BACKUP_ROOT/logs"

mkdir -p "$SNAP_DIR" "$LOG_DIR"

# Exclude heavy/unnecessary/rebuildable paths if desired (edit cautiously)
EXCLUDES=(
  "--exclude" "extensions/**/node_modules/.cache"
  "--exclude" "**/*.tmp"
  "--exclude" "**/.DS_Store"
)

RSYNC_OPTS=(
  -aHAX
  --numeric-ids
  --delete
  --info=stats2
)

if [[ -L "$LATEST_LINK" ]]; then
  echo "[INFO] Incremental snapshot (with hard links)"
  rsync "${RSYNC_OPTS[@]}" "${EXCLUDES[@]}" --link-dest="$LATEST_LINK" "$SRC_ROOT/" "$SNAP_DIR/" \
  | tee "$LOG_DIR/backup-$TS.log"
else
  echo "[INFO] Initial full snapshot"
  rsync "${RSYNC_OPTS[@]}" "${EXCLUDES[@]}" "$SRC_ROOT/" "$SNAP_DIR/" \
  | tee "$LOG_DIR/backup-$TS.log"
fi

# Update latest symlink atomically
ln -sfn "$SNAP_DIR" "$LATEST_LINK"

# Manifest + checksum (for integrity checks)
find "$SNAP_DIR" -type f -printf "%P\n" | sort > "$SNAP_DIR/.manifest.txt"
sha256sum "$SNAP_DIR/.manifest.txt" > "$SNAP_DIR/.manifest.sha256"

# Retention: keep last 7 daily snapshots (simple count-based; refine later)
mapfile -t snaps < <(ls -1dt "$BACKUP_ROOT"/snapshots/* 2>/dev/null || true)
if (( ${#snaps[@]} > 7 )); then
  for old in "${snaps[@]:7}"; do
    rm -rf "$old"
  done
fi

echo "[OK] Backup completed: $SNAP_DIR"

#!/usr/bin/env bash
set -euo pipefail

# OpenClaw restore script (console-only, no agent dependency)
# Usage:
#   restore.sh --list
#   restore.sh --snapshot <name_or_path> [--target /root/.openclaw] [--yes]

BACKUP_ROOT="/root/backups/openclaw"
DEFAULT_TARGET="/root/.openclaw"

list_snapshots() {
  ls -1dt "$BACKUP_ROOT"/snapshots/* 2>/dev/null || true
}

SNAPSHOT=""
TARGET="$DEFAULT_TARGET"
AUTO_YES="false"

while [[ $# -gt 0 ]]; do
  case "$1" in
    --list)
      list_snapshots
      exit 0
      ;;
    --snapshot)
      SNAPSHOT="$2"
      shift 2
      ;;
    --target)
      TARGET="$2"
      shift 2
      ;;
    --yes)
      AUTO_YES="true"
      shift
      ;;
    *)
      echo "Unknown arg: $1" >&2
      exit 1
      ;;
  esac
done

if [[ -z "$SNAPSHOT" ]]; then
  echo "ERROR: --snapshot required" >&2
  exit 1
fi

if [[ -d "$SNAPSHOT" ]]; then
  SNAP_DIR="$SNAPSHOT"
else
  SNAP_DIR="$BACKUP_ROOT/snapshots/$SNAPSHOT"
fi

if [[ ! -d "$SNAP_DIR" ]]; then
  echo "ERROR: snapshot not found: $SNAP_DIR" >&2
  exit 1
fi

echo "[INFO] Snapshot: $SNAP_DIR"
echo "[INFO] Target: $TARGET"

ts="$(date +%F-%H%M%S)"
PRE_RESTORE_BAK="${TARGET}.pre-restore-$ts"

if [[ "$AUTO_YES" != "true" ]]; then
  read -r -p "This will replace $TARGET. Continue? (yes/no): " ans
  [[ "$ans" == "yes" ]] || { echo "Aborted"; exit 1; }
fi

# Stop gateway service if present (best effort)
if command -v systemctl >/dev/null 2>&1; then
  systemctl is-active --quiet openclaw && systemctl stop openclaw || true
fi

# Backup current target before restore
if [[ -d "$TARGET" ]]; then
  mv "$TARGET" "$PRE_RESTORE_BAK"
fi

mkdir -p "$TARGET"

# Restore snapshot
rsync -aHAX --numeric-ids --delete "$SNAP_DIR/" "$TARGET/"

echo "[OK] Restore complete"
echo "[INFO] Previous state saved at: $PRE_RESTORE_BAK"
echo "[INFO] Start service (if needed): systemctl start openclaw"

# 编辑 crontab
crontab -e

# 添加以下行（每日 02:30 执行）
30 2 * * * cd /path/to/workspace/scripts/backup && /bin/bash backup.sh >> /root/backups/openclaw/logs/cron.log 2>&1

# 手动创建备份
bash scripts/backup/backup.sh

# 列出所有快照
bash scripts/backup/restore.sh --list

# 恢复指定快照
bash scripts/backup/restore.sh --snapshot 2026-03-04-223000

# 跳过确认直接恢复
bash scripts/backup/restore.sh --snapshot 2026-03-04-223000 --yes

# 创建备份（含 workspace）
openclaw backup create --output ~/Backups --verify

# 仅备份配置
openclaw backup create --only-config

# 预览（不实际创建）
openclaw backup create --dry-run --json

# 验证备份
openclaw backup verify ./2026-03-09T00-00-00.000Z-openclaw-backup.tar.gz

# 每周一 03:00 创建云端归档
0 3 * * 1 openclaw backup create --output /root/backups/openclaw/archives --verify >> /root/backups/openclaw/logs/weekly-archive.log 2>&1

# 可选：自动上传到对象存储
# 0 4 * * 1 aws s3 cp /root/backups/openclaw/archives/*.tar.gz s3://my-backup-bucket/openclaw/

# 1. 停止服务
systemctl stop openclaw

# 2. 列出可用快照
bash scripts/backup/restore.sh --list

# 3. 选择最近的健康快照恢复
bash scripts/backup/restore.sh --snapshot 2026-03-04-223000 --yes

# 4. 验证配置
openclaw config get

# 5. 重启服务
systemctl start openclaw

# 6. 验证服务正常
openclaw status

EXCLUDES=(
  "--exclude" "extensions/**/node_modules/.cache"
  "--exclude" "extensions/**/node_modules/**/*.node"
  "--exclude" "**/*.tmp"
  "--exclude" "**/*.log"
  "--exclude" "**/.DS_Store"
  "--exclude" "**/Thumbs.db"
)