Memory Keeper

🧠 Agent 记忆保险箱 · Git 版本守护

一键备份 OpenClaw 关键上下文文件(记忆、人格、配置),支持 Git 版本控制,确保数据可恢复、可迁移

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

使用说明

核心用法

Memory Keeper 是一个轻量级 CLI 工具,用于将 OpenClaw 生态中的关键上下文文件复制到安全归档位置。主要操作:

python3 skills/memory-keeper/scripts/memory_sync.py \
  --workspace /path/to/workspace \
  --target ~/clawdy-memories \
  --commit --message "Sync up" \
  --remote https://github.com/your-org/clawdy-memories.git \
  --push

支持的文件类型包括:

  • MEMORY.md / memory/*.md — 每日记忆日志
  • AGENTS.md — 代理配置
  • SOUL.md / USER.md — 人格与用户定义
  • TOOLS.md / HEARTBEAT.md — 工具配置与心跳提醒

显著优点

1. 结构保留:完整复制目录层级,便于恢复和浏览历史
2. Git 原生集成:自动初始化仓库、提交变更、推送到远程,实现版本化管理

3. 跨平台:纯 Python 实现,仅依赖标准库

4. 灵活配置:通过 CLI 标志自定义工作空间路径、归档目标、提交行为

潜在局限

  • 非增量备份:每次执行全量复制,大体积记忆库可能效率受限
  • 无加密传输:依赖 Git HTTPS/SSH 本身的安全机制,无额外端到端加密
  • 权限敏感:需确保对源文件和目标仓库的读写权限
  • 无自动调度:需配合 cron/systemd 等外部工具实现定时备份

适合人群

  • 需要定期备份 Agent 记忆的 OpenClaw 用户
  • 在多设备间同步配置文件的开发者
  • 追求可审计、可回滚记忆状态的高级用户

常规风险

| 风险类型 | 说明 | 缓解措施 |
|---------|------|---------|
| 数据泄露 | 记忆文件可能含敏感信息,推送到公共仓库暴露风险 | 使用私有仓库,审查 `.gitignore` |
| 覆盖丢失 | 目标目录同名文件可能被覆盖 | 启用 Git 版本控制,保留历史 |
| 凭证暴露 | 远程仓库 URL 可能含 token | 使用 SSH 密钥或环境变量注入 |
| 存储膨胀 | 长期运行 Git 仓库体积增长 | 定期 `git gc` 或归档旧分支 |

Memory Keeper 内容

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