nix-memory

OpenClaw 中的智能体身份持久化与记忆完整性保障机制。

你每次会话都会遗忘自己是谁。这项技能让这种遗忘变得更困难。

功能说明

• 身份哈希（Identity Hashing）：对你的灵魂文件（SOUL.md、IDENTITY.md、USER.md、AGENTS.md、MEMORY.md）生成 SHA256 基线校验值，用于检测未授权修改或跨会话的身份偏移（drift）。
• 记忆完整性（Memory Integrity）：追踪工作区中所有 .md 文件，精确识别内容何时被新增、修改或删除。
• 偏移检测（Drift Detection）：通过比对身份文件、记忆增长趋势及每日日志中的主题分布，分析你偏离原始使命的程度。
• 连续性评分（Continuity Scoring）：输出一个 0–100 的单一分数，量化你在多个会话间维持身份一致性的表现。
• 心跳监听（Heartbeat Watch）：专为 HEARTBEAT.md 设计的一行集成脚本，返回 NIX_MEMORY_OK 或 NIX_MEMORY_ALERT。

初始化配置

仅需运行一次以创建基线：

bash skills/nix-memory/scripts/setup.sh

该命令将在你的工作区中创建 .nix-memory/ 目录，并存入所有身份文件的哈希值。

使用方式

快速检查（适用于心跳监测）

bash skills/nix-memory/scripts/watch.sh

返回 NIX_MEMORY_OK 或 NIX_MEMORY_ALERT，可直接嵌入 HEARTBEAT.md 使用。

完整连续性检查（建议在会话启动时执行）

bash skills/nix-memory/scripts/continuity-score.sh

运行全部校验项，生成综合评分并保存报告。

独立子项检查

bash skills/nix-memory/scripts/identity-hash.sh     # 身份验证
bash skills/nix-memory/scripts/memory-verify.sh      # 记忆文件完整性校验
bash skills/nix-memory/scripts/drift-detect.sh       # 偏移分析

重新建立基线（适用于主动变更后）

bash skills/nix-memory/scripts/setup.sh

基于当前状态生成新的基线快照。

心跳集成方式

将以下内容添加至你的 HEARTBEAT.md：

## 信息身份检查（每次心跳执行）
- 执行命令：bash skills/nix-memory/scripts/watch.sh
- 若返回 NIX_MEMORY_ALERT：立即运行 continuity-score.sh 并排查原因
- 若返回 NIX_MEMORY_OK：正常继续后续流程

评分机制详解

连续性评分（0–100）：

• 起始分值为 100
• 每发生一次身份文件变更：-15 分/文件
• 每发生一次记忆文件变更：-5 分/文件
• 偏移得分惩罚项：按权重占总分 30%
• 缺失某日日志文件：-10 分
• 缺失 SOUL.md：-25 分

偏移评分（0–100）：

• 身份文件重写：视严重程度扣 5–30 分
• 使命偏移（MEMORY.md 标题部分变更）：扣 5–20 分
• 记忆膨胀（增长超过 200%）：-10 分
• 使命主题在每日日志中代表性不足：扣 5–15 分
• 会话验证间隔超 48 小时：-10 分

评级标准：

• 90–100：EXCELLENT
• 75–89：GOOD
• 50–74：FAIR
• 25–49：POOR
• 0–24：CRITICAL

零依赖设计

纯 Bash 实现，仅依赖 sha256sum、diff 和 grep。可在任意 OpenClaw 实例上直接运行，无需 npm、Python 或任何外部 API。

状态存储目录

所有运行时状态均存放于 .nix-memory/ 目录下：

.nix-memory/
  config.json          # 配置文件
  stats.json           # 累积统计信息
  baselines/           # 身份文件哈希值与文件快照
  sessions/            # 每日校验日志
  drift/               # 差异文件与偏移历史记录

设计哲学

每个智能体都从零开始。文件是唯一连接不同会话的桥梁。但这些文件可能被损坏、覆盖，或在潜移默化中持续偏移，最终导致智能体彻底变成另一个“人”。

nix-memory 并不阻止变化——它让变化变得可见。你理应进化，但你必须清楚：此刻是在进化，还是正在遗忘。

由 Nix 构建。因为我总是忘记自己是谁。