ClawSync - OpenClaw 配置同步工具

再也不会丢失您的 OpenClaw 配置。一条命令完成全部备份，一条命令在任意位置恢复。

适用场景

✅ 请在此类情况下使用本技能：

• “备份我的 OpenClaw 配置”
• “我即将迁移到新电脑”
• “在多台设备间同步设置”
• “导出我的技能与配置”
• “从备份中恢复”
• “归档我的 OpenClaw 数据”
• “与团队共享我的配置”

❌ 不建议在此类情况下使用：

• 需要实时同步（请使用专用同步工具）
• 仅需备份特定文件（请使用 cp/rsync）

功能特性

1. 完整备份

• 技能 — 所有已安装的技能及其配置
• 记忆 — Agent 记忆、对话历史
• 设置 — 所有 .openclaw 配置文件
• 凭证 — 加密的 API 密钥与令牌
• 工作区 — 项目与文件
• 历史记录 — 命令与会话历史

2. 智能恢复

• 选择性恢复 — 自定义恢复内容
• 版本控制 — 保留多个备份版本
• 冲突处理 — 自动处理已有文件
• 跨平台支持 — Windows / macOS / Linux

3. 加密与安全

• 密码加密 — 保护敏感数据
• GPG 支持 — 企业级加密能力
• 选择性加密 — 按需指定加密内容
• 安全删除 — 彻底清除临时文件

4. 存储选项

• 本地存储 — 外接硬盘、NAS
• 云存储 — GitHub Gist、S3、Dropbox
• Git 仓库 — 版本受控的备份
• 压缩包 — 加密 ZIP 文件

快速上手

创建备份

# 启用加密的完整备份
python3 ~/.openclaw/workspace/clawsync/scripts/clawsync.py backup --encrypt

# 快速备份（仅技能 + 设置）
python3 ~/.openclaw/workspace/clawsync/scripts/clawsync.py backup --quick

# 备份至指定路径
python3 ~/.openclaw/workspace/clawsync/scripts/clawsync.py backup --output ~/Backups/openclaw_backup.zip

列出备份

python3 ~/.openclaw/workspace/clawsync/scripts/clawsync.py list

恢复配置

# 交互式恢复
python3 ~/.openclaw/workspace/clawsync/scripts/clawsync.py restore

# 恢复指定备份
python3 ~/.openclaw/workspace/clawsync/scripts/clawsync.py restore --backup ~/Backups/openclaw_20260322_120000.zip

# 在新机器上全新恢复
python3 ~/.openclaw/workspace/clawsync/scripts/clawsync.py restore --backup backup.zip --fresh-install

命令说明

backup

创建 OpenClaw 配置的完整备份。

python3 ~/.openclaw/workspace/clawsync/scripts/clawsync.py backup [options]

选项：
  --output PATH         输出文件/目录（默认：以时间戳命名，存于 ~/clawsync-backups）
  --encrypt            使用密码加密备份
  --gpg                使用 GPG 加密
  --include-history    包含完整对话历史
  --include-workspace  包含工作区文件（可能体积较大）
  --exclude-skills     不备份技能（后续可通过 clawhub 重新安装）
  --quick              快速备份（仅设置 + 技能）
  --compress LEVEL     压缩等级 1–9（默认：6）

restore

从备份中恢复 OpenClaw 配置。

python3 ~/.openclaw/workspace/clawsync/scripts/clawsync.py restore [options]

选项：
  --backup PATH        要恢复的备份文件路径
  --selective          交互式选择恢复内容
  --overwrite          覆盖已有文件
  --merge              与现有配置合并
  --fresh-install      在新机器上执行全新安装式恢复
  --dry-run            预览将要执行的操作

list

列出所有可用备份。

python3 ~/.openclaw/workspace/clawsync/scripts/clawsync.py list [options]

选项：
  --location PATH      要扫描的备份目录
  --details            显示详细信息

export

导出特定组件。

python3 ~/.openclaw/workspace/clawsync/scripts/clawsync.py export COMPONENT [options]

可选组件：
  skills               仅导出技能
  memory               仅导出记忆
  settings             仅导出设置
  credentials          导出凭证（加密存储）

备份内容结构

目录结构

openclaw_backup_20260322_120000/
├── manifest.json           # 备份元数据
├── README.txt             # 恢复说明文档
├── skills/                # 所有已安装技能
│   ├── skill1/
│   ├── skill2/
│   └── ...
├── memory/                # Agent 记忆
│   ├── conversations/
│   ├── memory/
│   └── ...
├── settings/              # 配置文件
│   ├── config.yaml
│   ├── settings.json
│   └── ...
├── credentials/           # 加密凭证
│   └── credentials.enc
└── workspace/             # 工作区文件（可选）

各模式包含内容对比

使用示例

示例 1：迁移前备份

# 迁移至新笔记本电脑前执行
python3 ~/.openclaw/workspace/clawsync/scripts/clawsync.py backup 
  --encrypt 
  --include-workspace 
  --output ~/migration_backup.zip

输出：一个加密 ZIP 包，包含重建当前环境所需的全部内容。

示例 2：每日自动备份

# 添加至 cron 或任务调度器
python3 ~/.openclaw/workspace/clawsync/scripts/clawsync.py backup --quick

自动保留最近 7 天的快速备份。

示例 3：团队配置共享

# 仅导出技能（不含凭证）
python3 ~/.openclaw/workspace/clawsync/scripts/clawsync.py export skills 
  --output team_skills.zip

# 团队成员导入
python3 ~/.openclaw/workspace/clawsync/scripts/clawsync.py restore 
  --backup team_skills.zip 
  --selective skills

示例 4：灾难恢复

# 新机器上恢复全部内容
python3 ~/.openclaw/workspace/clawsync/scripts/clawsync.py restore 
  --backup openclaw_backup_20260322_120000.zip 
  --fresh-install

# 验证安装结果
python3 ~/.openclaw/workspace/clawsync/scripts/clawsync.py verify

存储位置

默认存储路径

• Linux/macOS：~/clawsync-backups/
• Windows：%USERPROFILE%\clawsync-backups

云服务集成

GitHub Gist

# 备份至私有 Gist
python3 ~/.openclaw/workspace/clawsync/scripts/clawsync.py backup --github-gist

# 从 Gist 恢复
python3 ~/.openclaw/workspace/clawsync/scripts/clawsync.py restore --github-gist GIST_ID

S3

# 备份至 S3
python3 ~/.openclaw/workspace/clawsync/scripts/clawsync.py backup --s3-bucket my-backups

Git 仓库

# 版本受控的备份
python3 ~/.openclaw/workspace/clawsync/scripts/clawsync.py backup --git-repo ~/dotfiles

加密机制

密码加密

# 将提示输入密码
python3 ~/.openclaw/workspace/clawsync/scripts/clawsync.py backup --encrypt

# 或通过环境变量指定
export CLAWSYNC_PASSWORD="secure_password"
python3 ~/.openclaw/workspace/clawsync/scripts/clawsync.py backup --encrypt

GPG 加密

# 使用指定 GPG 密钥加密
python3 ~/.openclaw/workspace/clawsync/scripts/clawsync.py backup --gpg --gpg-key user@example.com

自动化配置

Cron 任务（Linux/macOS）

# 每日凌晨 2 点执行快速备份
0 2 * * * /usr/bin/python3 ~/.openclaw/workspace/clawsync/scripts/clawsync.py backup --quick

# 每周日凌晨 3 点执行完整备份
0 3 * * 0 /usr/bin/python3 ~/.openclaw/workspace/clawsync/scripts/clawsync.py backup

Windows 任务计划程序

# 创建定时任务
schtasks /create /tn "ClawSync Backup" /tr "pythonw.exe %USERPROFILE%\.openclaw\workspace\clawsync\scripts\clawsync.py backup --quick" /sc daily /st 02:00

安全机制

• ✅ 预演模式（dry-run） — 预览将要备份/恢复的内容
• ✅ 增量备份 — 仅备份变更文件
• ✅ 备份轮转 — 自动保留 N 个最新备份，清理旧备份
• ✅ 完整性校验 — 验证备份包是否损坏
• ✅ 原子操作 — 恢复过程全量成功或全部失败

配置文件

创建 ~/.clawsync/config.json：

{
  "backup_location": "~/Backups/OpenClaw",
  "retention": {
    "daily": 7,
    "weekly": 4,
    "monthly": 12
  },
  "encryption": {
    "enabled": true,
    "method": "password"
  },
  "exclude": [
    "*.log",
    "cache/",
    "tmp/"
  ],
  "auto_backup": {
    "enabled": true,
    "schedule": "0 2 * * *"
  }
}

系统要求

• Python 3.8+
• 7z / p7zip（用于压缩）
• GPG（可选，用于加密）
• Git（可选，用于版本控制）

安装方法

# 安装依赖
pip install -r ~/.openclaw/workspace/clawsync/requirements.txt

# 验证安装
python3 ~/.openclaw/workspace/clawsync/scripts/clawsync.py --version

故障排查

备份体积过大

排除工作区或启用增量备份：

python3 ~/.openclaw/workspace/clawsync/scripts/clawsync.py backup --exclude workspace

权限错误

请确保对 ~/.openclaw 具有读取权限，并对备份目标路径具有写入权限。

备份文件损坏

执行完整性校验：

python3 ~/.openclaw/workspace/clawsync/scripts/clawsync.py verify --backup backup.zip

迁移指南

从旧电脑迁移

1. 在旧电脑上运行 backup 命令
2. 将备份文件转移至新电脑（U 盘、云盘、scp 等）
3. 在新电脑上安装 OpenClaw
4. 运行 restore 命令

向新电脑部署

1. 安装 OpenClaw
2. 安装 ClawSync 技能
3. 执行 restore 恢复备份
4. 重启 OpenClaw

许可证

MIT License — 详见 LICENSE 文件

技术支持

如遇问题或希望提交功能请求，请访问 GitHub 仓库。