核心用法
clawng-term-memory 是一套面向 OpenClaw AI 代理的版本控制与持久化解决方案，将传统软件工程的 Git 工作流引入 AI 代理管理领域。
主要功能模块
| 功能 | 命令/脚本 | 说明 |
|------|----------|------|
| 自动提交推送 | `commit.sh "描述"` | 修改核心文件后立即执行，推送至 `agent/<hostname>` 分支 |
| 每日合并 | `merge.sh` | 将各机器分支合并到 `main`，形成共享真相源 |
| 历史查看 | `git log --oneline --graph` | 追溯记忆、灵魂的演变历程 |
| 差异对比 | `git diff HEAD~1 <file>` | 查看特定文件的变更细节 |
| 版本回退 | `git checkout HEAD~1 -- <file>` | 恢复文件到先前版本 |
支持的文件类型
- 身份定义：
SOUL.md（灵魂/核心人格）、IDENTITY.md - 记忆存储：
MEMORY.md、memory/*.md（每日笔记） - 用户与工具：
USER.md、TOOLS.md、AGENTS.md - 系统状态：
HEARTBEAT.md - 技能代码：
skills/目录
多设备架构
采用分支隔离 + 定时合并策略：每台机器拥有独立分支（agent/my-laptop 等），通过每日 cron 任务合并至 main，既避免并发冲突，又保证配置同步。
显著优点
1. 真正的可移植性：新机器仅需 git clone 即可恢复完整代理配置
2. 完整可追溯性：每次记忆更新、规则调整都有 Git 提交记录，可精确回答"代理何时学会了什么"
3. 冲突安全设计：多设备通过分支隔离，避免直接覆盖；merge.sh 使用 union 策略自动合并
4. 零依赖侵入：纯 Git + Bash 脚本，不绑定特定云平台
5. SSH优先安全：推荐 SSH 密钥认证，避免令牌暴露于 URL 或环境变量
潜在缺点与局限性
| 问题 | 说明 |
|------|------|
| 学习曲线 | 需要用户熟悉 Git 基本操作（分支、合并、冲突处理） |
| 合并冲突风险 | 若多台机器同时修改同一文件的同一部分，union 策略可能产生重复内容而非智能合并 |
| 手动触发依赖 | 核心要求"修改后立即提交"，用户遗忘将导致备份缺口 |
| 无加密存储 | 私有仓库依赖 GitHub 的访问控制，敏感记忆文件若误设为公开则存在泄露风险 |
| 频率限制 | 高频自动提交可能触发 GitHub API 限制或产生冗杂历史 |
适合人群
- 多设备用户：在家用机、笔记本、VPS 间切换工作的 OpenClaw 重度用户
- 团队协作：多人维护同一代理配置的共享开发场景
- 迭代调试者：需要频繁回滚代理人格或记忆版本的高级用户
- 长期主义者：希望构建数月乃至数年持续演进的"数字生命档案"
常规风险
- 凭证泄露：HTTPS 方式若配置不当，可能在
~/.git-credentials留下明文令牌（建议优先 SSH） - 敏感信息入仓：
MEMORY.md可能包含对话隐私，需确保仓库为私有 - 自动化陷阱：
merge.sh的 union 合并对结构化内容（如 YAML/JSON）友好，但对自然语言 Markdown 可能产生语义混乱的拼接 - 分支膨胀：长期运行的多设备场景若不清理旧分支，可能积累大量废弃
agent/*分支
安全建议
1. 仓库必须设为 Private，并在 GitHub 启用分支保护规则
2. 优先使用 SSH 部署密钥，避免个人访问令牌（PAT）硬编码
3. 定期检查 git log --all --oneline 确认无意外公开提交
4. 敏感记忆考虑额外 Git-crypt 或 SOPS 加密后再入仓