Memory Keeper

💾 Agent 记忆的 Git 备份管家

OpenClaw 记忆备份工具,支持快照式归档与 Git 同步,防止上下文丢失与主机迁移。

收藏
12.2k
安装
2.8k
版本
1.0.1
CLS 安全扫描中
预计需要 3 分钟...

使用说明

核心用法

Memory Keeper 是一款面向 OpenClaw 生态的轻量级 CLI 备份工具,用于将关键 Agent 上下文文件(MEMORY.mdAGENTS.mdSOUL.md 等)复制到安全归档位置。用户通过 --workspace 指定工作区根目录,--target 指定备份目标路径,即可一键完成快照。若目标路径为 Git 仓库,可附加 --commit--push--remote 参数实现自动化版本控制与云端同步。

显著优点

  • 精准捕获:仅备份核心记忆与配置文件,避免全量工作区冗余,恢复时定位精准
  • Git 原生支持:内置初始化、提交、推送流程,无需额外脚本即可实现历史版本追踪
  • 跨平台兼容:纯 Python3 实现,无外部依赖,适配多主机迁移场景
  • 结构保留:维持原目录层级,便于直接比对或增量恢复

潜在缺点与局限性

  • 无加密机制:文档未提及传输或存储加密,敏感记忆文件存在泄露风险
  • 单点备份策略:依赖用户手动或外部 cron 触发,缺乏自动调度与健康巡检
  • 恢复流程未明:仅说明"可恢复",未提供官方回滚或冲突解决指南
  • 依赖 Git 配置:若远程仓库凭据配置不当,推送可能失败且错误处理细节不明

适合人群

  • 频繁切换主机或容器的 OpenClaw 用户
  • 需要审计 Agent 记忆演变过程的开发者
  • 对数据主权敏感、希望本地/私有 Git 托管记忆的组织

常规风险

| 风险类型 | 说明 |
|---------|------|
| 数据泄露 | 明文备份至非加密磁盘或公开仓库 |
| 版本冲突 | 多主机并行修改后推送导致合并冲突 |
| 凭证暴露 | 脚本参数 `--remote` 可能泄露于 shell 历史 |
| 备份失效 | 目标路径不可写或磁盘满导致静默失败 |

Memory Keeper 内容

references文件夹
scripts文件夹
tests文件夹
手动下载zip · 8.6 kB
usage.mdtext/markdown
请选择文件