OpenClaw 记忆备份工具,支持快照式归档与 Git 同步,防止上下文丢失与主机迁移。
说明:
## 核心用法
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 历史 |
| 备份失效 | 目标路径不可写或磁盘满导致静默失败 |








