核心用法
Memory Keeper 是一款专为 OpenClaw 生态系统设计的轻量级备份工具，通过命令行将关键上下文文件（memory/*.md、MEMORY.md、AGENTS.md、SOUL.md 等）完整复制到指定存档目录，保留原始目录结构以便恢复或历史追溯。
基础命令结构：
python3 skills/memory-keeper/scripts/memory_sync.py \ --workspace <工作区根目录> \ --target <存档路径> \ [--commit] [--message "提交信息"] \ [--remote <Git 仓库地址>] [--push]
关键参数说明：
--workspace: 源工作区根目录，需包含待备份的记忆文件--target: 目标存档目录，可指定为本地路径或 Git 仓库--commit: 自动创建 Git 提交--push: 推送至远程仓库--message: 自定义提交信息
显著优点
1. 精准靶向备份：仅捕获核心上下文文件，排除工作区噪音，备份体积可控
2. Git 原生集成：支持初始化仓库、自动提交、远程推送，实现版本化管理
3. 跨平台兼容：纯 Python 实现，无需额外依赖
4. 结构保持：完全保留 memory/ 子目录层级，便于直接恢复或 diff 对比
5. 运维友好：适合自动化脚本集成（如定时任务 cron），支持无人值守备份
潜在缺点与局限性
1. 非增量备份：每次执行均为全量复制，高频备份可能产生存储冗余
2. 无加密机制：备份文件以明文 Markdown 存储，敏感内容需额外加密处理
3. 依赖外部 Git 配置：远程推送需预配置 SSH 密钥或 HTTPS 凭证
4. 单方向同步：仅支持从工作区到存档的复制，无自动双向同步或冲突解决
5. 无内置压缩：大体积记忆库占用较多磁盘空间
适合人群
- 频繁切换工作主机或需要多设备同步的 OpenClaw 用户
- 注重上下文连续性、希望保留「记忆历史」的长期使用者
- 运行关键任务前需创建检查点的谨慎型运维人员
- 希望将个人配置（
SOUL.md、AGENTS.md）纳入版本控制的开发者
常规风险
| 风险类型 | 具体描述 | 缓解建议 |
|---------|---------|---------|
| 数据泄露 | 备份含敏感对话记忆，明文存储于目标路径 | 将 `--target` 指向加密卷或私有仓库 |
| 提交冲突 | 多设备同时推送可能引发 Git 冲突 | 建立单一主备份源，其他设备只拉取 |
| 路径误设 | 错误的 `--workspace` 导致备份空目录 | 执行前验证源文件存在性 |
| 远程仓库失效 | 配置的 `--remote` 地址不可达 | 添加推送失败告警与本地回退机制 |