当你反复调试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或反馈至社区问答板块https://github.com/seekcontext/mindkeeper为什么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选项来指定要操作的工作区。如果省略该选项--dirMindkeeper 默认使用当前工作目录。这意味着你可以用Mindkeeper管理多个Agent工作区或者把它嵌入到自动化测试流程中每次跑测试前创建快照测试失败时自动回滚到已知稳定版本。openclaw mind status # See whats 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配置值得被时间记住。