核心用法
Memory Keeper 是一款面向 OpenClaw 生态的轻量级 CLI 备份工具,用于将关键 Agent 上下文文件(MEMORY.md、AGENTS.md、SOUL.md 等)复制到安全归档位置。用户通过 --workspace 指定工作区根目录,--target 指定备份目标路径,即可一键完成快照。若目标路径为 Git 仓库,可附加 --commit、--push 及 --remote 参数实现自动化版本控制与云端同步。
显著优点
- 精准捕获:仅备份核心记忆与配置文件,避免全量工作区冗余,恢复时定位精准
- Git 原生支持:内置初始化、提交、推送流程,无需额外脚本即可实现历史版本追踪
- 跨平台兼容:纯 Python3 实现,无外部依赖,适配多主机迁移场景
- 结构保留:维持原目录层级,便于直接比对或增量恢复
潜在缺点与局限性
- 无加密机制:文档未提及传输或存储加密,敏感记忆文件存在泄露风险
- 单点备份策略:依赖用户手动或外部 cron 触发,缺乏自动调度与健康巡检
- 恢复流程未明:仅说明"可恢复",未提供官方回滚或冲突解决指南
- 依赖 Git 配置:若远程仓库凭据配置不当,推送可能失败且错误处理细节不明
适合人群
- 频繁切换主机或容器的 OpenClaw 用户
- 需要审计 Agent 记忆演变过程的开发者
- 对数据主权敏感、希望本地/私有 Git 托管记忆的组织
常规风险
| 风险类型 | 说明 |
|---------|------|
| 数据泄露 | 明文备份至非加密磁盘或公开仓库 |
| 版本冲突 | 多主机并行修改后推送导致合并冲突 |
| 凭证暴露 | 脚本参数 `--remote` 可能泄露于 shell 历史 |
| 备份失效 | 目标路径不可写或磁盘满导致静默失败 |