当你反复调试SOUL.md里的提示词，终于找到那个让Agent回复恰到好处的版本，却在三天后手滑改错一行导致性格大变；当团队里三个人同时修改AGENTS.md，冲突合并后谁也不记得原始逻辑；当审计部门追问"这个AI决策依据的是哪版规则"，你只能对着Git历史里"update"和"fix"的提交信息干瞪眼……
你意识到，AI Agent的配置文件值得被认真对待，而不仅仅是当成一堆随时可以丢弃的Markdown。
Mindkeeper正是为解决这个问题而生。它不是一个代码版本管理工具，也不是Confluence那样的知识库，而是专为AI Agent配置文件设计的“时间机器”。它理解SOUL.md里一行提示词的微妙变化，能追踪MEMORY.md中某个记忆的增删对Agent行为的影响，甚至能让Agent自己查看历史、比较差异、在犯错时主动回滚。
Mindkeeper第0版诚邀大家试用，欢迎提PR和issue或反馈至社区问答板块：github.com/seekcontext…
为什么Git不够用：AI配置需要"语义级"版本控制
把AGENTS.md扔进Git仓库是大多数人的第一反应，但这远远不够。Git是为代码设计的，它关心的是语法正确性和合并冲突，而AI配置文件的核心是语义影响。你把"请保持简洁"改成"请极度简洁"，Git只会显示一行diff，但Agent的输出长度可能从200 tokens骤降到50 tokens，这种影响在Git的历史里是看不见的。
更棘手的是OpenClaw的工作流。Gateway在后台自动重写这些文件，Agent自己也会修改MEMORY.md。你可能在专注调试时忘记提交，或者Gateway的自动保存覆盖了你的手动更改，传统Git在这类"非人为修改"面前完全失效。Mindkeeper通过影子仓库设计解决了这个问题：它用isomorphic-git在.mindkeeper/目录维护独立的Git历史，你的文件保留在原位，所有变更——无论是手动还是自动——都被30秒防抖窗口捕获，生成带语义摘要的提交。
工作原理：mindkeeper使用isomorphic-git（纯 JavaScript，无需系统自带 Git）在您的工作区旁边维护一个影子 Git 仓库。Git 数据存储在影子仓库中，而您的文件则保留在原处。<workspace>/.mindkeeper/
~/.openclaw/workspace/
├── AGENTS.md ← tracked, stays in place
├── SOUL.md ← tracked, stays in place
├── MEMORY.md ← tracked, stays in place
├── memory/
│ └── 2026-03-04.md ← tracked, stays in place
├── skills/
│ └── my-skill/SKILL.md ← tracked, stays in place
└── .mindkeeper/ ← git history data (hidden, auto-managed)
两种模式：让AI自己管理历史，或你完全掌控
Mindkeeper提供两种使用模式，本质上是同一套引擎的不同界面。
OpenClaw插件模式适合想让Agent具备"自我觉知"能力的场景。安装后，Agent会获得五个工具：
mind_history查看变更时间线mind_diff比较版本差异mind_rollback在确认后回滚文件mind_snapshot在风险编辑前创建检查点mind_status显示当前跟踪状态
你可以直接问："SOUL.md最近有什么变化？"AI会生成可读摘要，而不是丢给你原始diff。更酷的是，当Agent发现最近表现异常时，它可以主动提议："我注意到回复风格有变化，需要回滚到三天前的版本吗？"这种内省能力让Agent从被动工具升级为主动协作者。
独立命令行模式则适合脚本化工作流或集成到CI/CD。每个命令都接受一个--dir <path>选项来指定要操作的工作区。如果省略该选项--dir，Mindkeeper 默认使用当前工作目录。这意味着你可以用Mindkeeper管理多个Agent工作区，或者把它嵌入到自动化测试流程中：每次跑测试前创建快照，测试失败时自动回滚到已知稳定版本。
openclaw mind status # See what's tracked and pending
openclaw mind history SOUL.md # Browse SOUL.md change history
openclaw mind snapshot stable-v2 # Save a named checkpoint
安装：
npm install -g mindkeeper
两种模式共享相同的核心引擎和影子存储设计，你可以无缝切换。插件模式适合日常交互，独立命令行模式适合批量操作和自动化，没有对错，只有场景。
技术架构：为黑客而生的可扩展设计
Mindkeeper的代码结构本身就是一份黑客友好宣言。核心追踪逻辑在packages/core/src/tracker.ts，基于isomorphic-git实现，这意味着它不依赖系统安装的Git，在任何Node.js环境都能运行。存储层git-store.ts巧妙地将Git数据目录指向.mindkeeper/，而工作区保持干净，既避免了.git冲突，又实现了版本隔离。
文件监听用chokidar加防抖机制，配合lockfile防止重复监控。差异引擎基于jsdiff，但输出被结构化为语义块，便于LLM消费。提交信息生成支持模板和LLM两种模式，后者在OpenClaw插件模式下会调用Gateway的模型，将原始diff转换成"移除了关于响应长度的限制，现在允许更详细的解释"这类可读摘要。
插件系统在packages/openclaw/src/tools.ts中暴露，每个工具都是纯函数，接受参数并返回结构化结果。这种设计让社区可以轻松扩展：比如添加mind_branch支持多版本人格实验，或mind_merge合并不同Agent的最佳配置。插件API还未完全稳定，但代码足够简单，你可以直接PR修改。
快速开始：三分钟拥有自己的时间机器
npm install -g mindkeeper
mindkeeper init --dir ~/.openclaw/workspace
mindkeeper watch --dir ~/.openclaw/workspace
现在打开你的OpenClaw会话，修改SOUL.md里的任何内容，保存后30秒内，Mindkeeper会自动创建快照。运行mindkeeper history SOUL.md就能看到变更历史。想回滚？mindkeeper rollback SOUL.md <commit-hash>，工具会先预览差异，确认后才执行。
如果使用OpenClaw插件模式，更简单：
openclaw plugins install mindkeeper-openclaw
# 重启Gateway后，直接问AI：
# "What changed in my personality file?"
Agent会调用mind_history和mind_diff，生成自然语言回答。你甚至可以让它在修改配置前自动快照："Before you change AGENTS.md, create a checkpoint called 'pre-optimization'."这种元操作能力让复杂任务变得安全。
社区共建：我们需要你的真实场景
Mindkeeper是MIT协议开源项目（github.com/seekcontext/mindkeeper），但不同于"扔代码不管"的模式，我们极度依赖社区反馈来演进。当前版本(v0.1.x)解决了"有历史"的问题，但真实世界的复杂性远超想象。
我们特别需要以下几类贡献：
- 真实场景测试：在你的OpenClaw工作流中使用一个月，把遇到的痛点发成Issue。比如"Gateway自动覆盖导致历史丢失"或"多设备同步时冲突"这类问题，只有真实用户能发现
- 插件开发：如果你有独特的记忆管理需求，比如"根据对话情绪自动标记重要记忆"或"与Notion双向同步"，请尝试用插件API实现并分享
- 性能优化：当前SQLite在百万级commit时查询会变慢，chokidar在超大文件树下有性能损耗。欢迎性能极客来 profiling 和优化
- 文档和示例：写博客、录视频、分享你的mindkeeper工作流，这比代码贡献更有价值
路线图已经公开：v0.2聚焦Web UI和完整快照回滚，v0.3做云端同步，v0.4引入AI主动模式。但这些优先级随时可能根据社区需求调整。我们承诺所有Issue和PR在48小时内响应，技术讨论完全公开。
结语：AI配置是代码，值得被认真对待
2026年的AI开发范式正在从"调参"转向"配置工程"。SOUL.md、AGENTS.md这些文件不再是临时草稿，而是定义AI行为的核心代码。它们需要版本控制、需要代码审查、需要CI/CD集成。Mindkeeper是第一个真正把这套理念落地的工具。
它不完美：影子仓库设计在极端情况下可能产生数据冗余，LLM生成的提交信息偶尔会有幻觉，插件API还不够稳定。但这些问题正是开源社区存在的意义。我们相信，当足够多的开发者把自己的记忆管理需求扔进来，Mindkeeper会成长为AI时代的Git——不是管理代码，而是管理智能本身。
现在，去给你的Agent配置一台时光机吧。然后告诉我们，当它能记住自己是谁、从哪来、为什么改变时，世界会变得多有趣。
诚邀内测: github.com/seekcontext/mindkeeper可提PR、issue，或在社区问答板块反馈建议
你的AI配置，值得被时间记住。
