核心用法
MyOpenClaw Backup Restore 是专为 OpenClaw 生态设计的跨平台备份与恢复解决方案，完全基于 Node.js 实现，无需 bash/rsync/python 等外部依赖，真正实现了 Windows、macOS、Linux 三端互通。
主要功能模块
1. 备份管理
- 一键创建完整快照：执行
node scripts/backup-restore.js backup即可打包核心数据 - 覆盖范围全面：MEMORY.md/SOUL.md 工作区、多代理团队目录、网关配置、Skills、扩展、凭证、会话历史、设备身份等
- 智能排除：自动过滤日志、node_modules、媒体文件等非必要数据
- 自动清理策略：默认保留最近 7 个备份，防止磁盘膨胀
- 权限加固：非 Windows 系统自动设置
chmod 600保护敏感归档
2. 恢复机制
- Dry-run 预览：
--dry-run参数可在实际执行前完整模拟恢复过程 - 自动预恢复快照：覆盖前自动保存当前状态，提供回退保障
- 网关令牌保护：默认保留新服务器的 token，防止 Control UI 连接中断
- 交互式确认：必须手动输入
yes才能继续，避免误操作 - 凭证权限加固：自动修复
~/.openclaw目录权限（700）和凭证文件权限（600） - 跨版本兼容：支持 v1（bash 时代）和 v2 结构的归档文件
3. Web 管理界面
- 内置 HTTP 服务器提供浏览器端管理
- 分权限设计：远程仅支持列出/下载/上传，localhost 才允许执行备份/恢复操作
- 强制令牌认证，无令牌拒绝启动
显著优点
| 维度 | 优势 |
|------|------|
| **跨平台** | tar.gz/ZIP 双格式，任意 OS 创建的备份可在其他 OS 恢复 |
| **零依赖** | 仅需 Node.js，降低部署门槛 |
| **安全设计** | 多层防护：dry-run → 预快照 → 交互确认 → 权限加固 |
| **生产就绪** | 自动重启网关、令牌保留机制减少服务中断 |
| **迁移友好** | 换机场景下配置、凭证、历史记录完整迁移 |
潜在局限与风险
架构层面
- 备份粒度为全量归档，缺乏增量/差异备份选项，大数据量场景下效率受限
- 无内置加密功能，归档安全性完全依赖文件系统权限和传输通道加密
- 单点存储：默认本地磁盘备份，无分布式或多副本机制
操作风险
--overwrite-gateway-token选项若误用可能导致令牌覆盖- HTTP 服务器的
token参数若泄露，localhost 限制可被绕过（需结合网络配置） - 恢复操作不可逆，虽有预快照但用户可能忽略清理，造成磁盘占用累积
兼容性注意
- 极端老旧 Windows（<10）依赖 ZIP 回退，可能丢失部分 Unix 权限元数据
适合人群
- OpenClaw 重度用户：需要保护多年积累的代理配置、会话历史、自定义 Skills
- 多设备工作者：频繁在 Windows 开发机与 Linux 服务器间切换
- 运维负责人：管理团队共享的 OpenClaw 实例，需标准化备份流程
- 安全意识强的个人用户：重视 dry-run 验证和权限加固机制
常规风险提醒
1. 归档泄露风险：备份包含明文 API 密钥和 bot tokens，等同于密码库，务必使用加密存储（如 VeraCrypt 容器、BitLocker、LUKS）和加密传输（SCP/SFTP/VPN）
2. 预快照累积：每次恢复前自动创建的救急备份若未定期清理，可能悄悄占满磁盘
3. Node.js 版本：建议使用 LTS 版本，旧版本可能存在 tar/stream 模块兼容问题
4. 并发操作：恢复过程中避免其他进程修改 ~/.openclaw，防止状态不一致
---
> 生态定位：作为 MyClaw.ai 开放技能集的基础设施组件，本工具填补了 OpenClaw 原生跨平台备份能力的空白，适合纳入 CI/CD 流水线或定时任务实现自动化运维。