Auto Backup OpenClaw User Data
OpenClaw 用户数据自动备份技能。
版本
- 当前版本：v1.1.0.20260414
- 更新日期：2026-04-14
功能
- 自动备份：定时备份
.openclaw目录 - 选择性备份：支持全量或部分备份（交互式选择文件/文件夹）
- ZIP 压缩：自动压缩并按规则命名
- 定时执行：支持 HEARTBEAT 心跳和 Cron 定时任务两种方式
- 日志记录：完整记录执行过程
- 消息通知：支持多渠道推送结果（需配置推送目标）
- 保留策略：自动清理旧备份
v1.1.0 新特性
工作空间自动检测
首次配置时自动检测所有workspace目录和memory目录，无需手动配置备份目标。适配多Agent工作环境，避免遗漏备份。
敏感文件安全提醒
新增敏感文件识别和提醒机制（密钥、凭证、环境变量等），默认不强制排除，遵循"只做提醒，不做限制"原则，让用户自主决定备份范围。
标准化入口改进
创建标准Node.js模块入口（index.js），完整导出所有接口，消除"可疑技能"标记，符合OpenClaw安全最佳实践。
配置自动迁移
支持从v1.0.2自动升级到v1.1.0，自动补全缺失配置字段，保留原有配置，零停机平滑升级。
工作空间自动检测
首次配置时，系统会自动检测您的OpenClaw工作空间：
检测内容：
- 所有 workspace-* 目录
- memory 目录
- 写入配置文件作为默认值
建议：首次使用交互式配置确认检测结果。
⚠️ 安全警告
敏感文件风险
备份可能包含敏感文件（密钥、环境变量、凭证等）。
默认行为：不强制排除，仅排除临时文件。
如何启用：交互式配置Step 7或手动编辑配置文件。
命令
| 命令 | 功能 |
|---|---|
/backup_now |
立即执行备份 |
/backup_status |
查看备份状态 |
/backup_config |
配置向导 |
/backup_list |
列出备份文件 |
/backup_clean |
清理旧备份 |
定时任务配置
支持两种定时执行方式：
- HEARTBEAT 心跳：适用于周期性监控检查，详见
HEARTBEAT_prompt_example.md - Cron 定时任务：适用于精确时间执行，详见
cron_prompt_example.md
配置
配置文件位置：~/.openclaw/workspace/Auto-Backup-Openclaw-User-Data/config.json
消息通知配置
{
"notification": {
"enabled": true,
"channels": ["feishu", "telegram"],
"targets": {
"feishu": [
{ "type": "group", "id": "oc_xxx", "name": "开发群" },
{ "type": "user", "id": "ou_xxx", "name": "用户名" }
],
"telegram": [
{ "type": "group", "id": "-100xxx", "name": "通知群" }
]
},
"onSuccess": true,
"onFailure": true
}
}
注意：消息通知需要在 OpenClaw 中先配置对应的通信渠道，详见 references/config-schema.md。
详细配置说明：见 references/config-schema.md
故障排查
常见问题：见 references/troubleshooting.md
升级指南
从 v1.0.2 升级到 v1.1.0
推荐升级方式：卸载旧版本后重新安装
# 卸载旧版本
openclaw skill uninstall auto-backup-openclaw-user-data
# 安装新版本
openclaw skill install auto-backup-openclaw-user-data
原因：获得完整的v1.1.0默认配置，包括工作空间自动检测、敏感文件建议列表、encryption配置字段。
配置自动迁移
保留现有配置的用户，系统会自动补全v1.1.0新增字段，无需手动修改配置。
升级后重要变更
- backup.mode默认值：从"full"（全量备份）改为"partial"（选择性备份）
- 工作空间检测：从硬编码改为动态自动检测
- 敏感文件提醒：新增建议排除列表（默认不启用）
建议：升级后运行 /backup_config 重新确认备份目标，并根据安全需求决定是否启用敏感文件排除。
兼容性
- ✅ 配置兼容：v1.0.2配置自动补全新字段
- ✅ 备份兼容：备份文件格式完全兼容
- ✅ 命令兼容：所有
/backup_*命令保持不变 - ✅ 定时兼容：HEARTBEAT和Cron配置无需修改
详细升级说明：见 README.md升级指南
更新日志
v1.1.0.20260414 (2026-04-14) - 安全优化版本
脚本入口改进：
- 创建标准index.js入口文件，完整导出所有接口
- 导出runCommand函数，确保命令正常调用
- 消除"可疑技能"标记
工作空间动态检测：
- 新增detectWorkspaces()函数，首次配置自动检测workspace
- 修复硬编码targets问题
敏感文件处理：
- 添加敏感文件建议列表配置（默认不启用）
- 遵循"只做提醒，不做限制"原则
文档完善：
- 添加工作空间动态检测和安全警告说明
v1.0.2.20260331 (2026-03-31)
- 新增：HEARTBEAT 心跳定时任务模板（
HEARTBEAT_prompt_example.md） - 新增：Cron 定时任务模板（
cron_prompt_example.md） - 新增：选择性备份交互式文件选择功能
- 新增：文件选择确认/重新选择功能
- 优化：交互式配置步骤从 6 步调整为 7 步
- 优化：选择性备份时列出
~/.openclaw/目录文件清单 - 文档：README.md 和 USAGE.md 新增定时任务配置说明
v1.0.1.20260326 (2026-03-26)
- 新增：消息推送目标配置功能
- 新增：读取 OpenClaw 配置自动获取可用推送目标
- 新增：推送失败时通过当前对话提醒用户
- 优化：
/backup_list只显示本 skill 产生的备份文件 - 优化：交互式配置增加推送目标选择步骤
v1.0.0.20260326 (2026-03-26)
- 初始版本发布
