用途：为 OpenClaw 的配置与重要数据提供完整的备份与恢复方案，适合在修改配置前留档、定期备份或迁移到新机器时使用。
主要能力：备份内容包括主配置文件 openclaw.json、Agent 配置（认证档案与设置）、工作区文件（AGENTS.md、SOUL.md、USER.md、IDENTITY.md、MEMORY.md、TOOLS.md、HEARTBEAT.md 及 memory/ 目录）、自定义技能，以及备份时间戳、版本信息和内容清单等元数据。备份以 .tar.gz 压缩包形式存放在 ~/.openclaw/backups/，命名格式为 openclaw-backup-[name-]YYYYMMDD-HHMMSS.tar.gz。恢复前会确认覆盖，并生成 openclaw.json.before-restore 作为当前配置的备份。
使用方式：创建备份运行 python3 scripts/backup.py，可用 --name 指定名称、--output-dir 指定输出目录；列出备份运行 python3 scripts/list_backups.py；恢复运行 python3 scripts/restore.py <backup-file>。可配合 GitHub 私有仓库推送备份，或通过 crontab 设置每日自动备份，并用 ls -t 与 xargs rm -f 清理旧备份。迁移到新机器时复制备份文件后执行恢复，再运行 openclaw gateway restart。
限制：不备份会话历史与状态、敏感认证凭据、系统内置技能和网关日志。备份可能包含令牌与 API 密钥等敏感信息，需安全存放、避免公开分享，敏感部署可考虑加密。恢复失败时可检查文件完整性、写入权限，并在恢复前用 openclaw gateway stop 停止服务。