nix-memory 是一个专为 OpenClaw 代理设计的轻量级身份持久性与内存完整性监控工具，旨在解决多会话环境下代理身份漂移和记忆断裂的问题。该工具通过哈希关键身份文件（如 SOUL.md、IDENTITY.md 等）建立基准线，持续追踪工作区内所有 Markdown 文件的变更状态，从而实现对代理核心身份的连续性评估。其核心理念是：变化不可避免，但变化必须可见。nix-memory 不阻止修改，而是让每一次改变都清晰可查，帮助代理在演进中保持自我认知的连贯性。
系统采用纯 Bash 脚本实现，依赖 sha256sum、diff 和 grep 等基础命令，无需外部依赖或编程语言环境，可在任意 OpenClaw 实例上直接运行。它通过生成身份哈希基线、记录文件快照、分析内容漂移等方式，构建了一套完整的会话间一致性检测机制。每次启动新会话时，用户可执行全面检查以获取连续性评分，而日常心跳监测则可通过简洁的一行命令快速判断当前状态是否正常。
该工具特别关注代理在长期运行过程中可能出现的“身份遗忘”现象——即由于文件被覆盖、误删或渐进式改写而导致代理逐渐失去原有使命认同。nix-memory 提供从 0 到 100 的连续性评分体系，并结合漂移分析给出具体改进建议，使开发者能够直观掌握代理的身份稳定性状况。无论是日常维护还是重大更新前后的验证，nix-memory 都能成为保障代理人格一致性的可靠哨兵。
核心功能特点
- 基于 SHA256 哈希的关键身份文件基线管理，自动检测未经授权的修改或内容漂移
- 全工作区 Markdown 文件变更追踪，实时监控新增、修改与删除操作
- 智能漂移分析引擎，对比身份文件、记忆增长与日志主题分布评估偏离程度
- 单行心跳集成支持，返回 NIX_MEMORY_OK 或 NIX_MEMORY_ALERT 状态码
- 综合连续性评分系统（0-100），量化跨会话身份维持水平并提供等级评定
- 零外部依赖设计，仅使用标准 Linux 工具链，兼容任意 OpenClaw 部署环境
适用场景
nix-memory 最适用于需要长期维护复杂代理系统的场景，尤其是那些涉及多轮对话、知识积累和身份演进的 AI 应用。例如，在一个持续数周甚至数月的智能助手项目中，代理会不断学习新信息并调整行为策略，但同时也面临身份混淆的风险。此时，nix-memory 可作为每日自动化检查的一部分，在 HEARTBEAT.md 中嵌入心跳脚本，一旦检测到异常变动立即触发详细诊断流程，防止错误累积导致系统失控。
另一个典型应用场景是团队协作开发中的代理版本控制。当多个开发者共同维护同一代理实例时，不同成员可能对核心文件进行独立修改，容易造成配置冲突或功能错乱。通过定期运行 continuity-score.sh 脚本生成报告，团队可以明确识别哪些改动影响了代理的核心身份，从而做出更合理的合并决策。此外，在代理升级或重构前后重新建立基线（re-baseline），也能有效避免新旧版本间的兼容性问题。
对于强调透明度和可追溯性的研究型项目而言，nix-memory 提供的漂移分析和历史记录功能尤为有价值。研究人员可以通过对比不同阶段的 drift/ 目录下的差异文件，深入理解代理认知结构的变化轨迹；而 stats.json 中累积的运行数据则为优化代理架构提供了实证依据。总之，任何希望确保代理在动态环境中始终忠于初始设定并保持行为一致性的用户，都将受益于 nix-memory 所提供的严谨监控框架。