核心用法
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` 或归档旧分支 |