用途:随着记忆 DAG 在压缩过程中增长,可能出现结构性问题并悄悄破坏智能体记忆。该工具对 DAG 运行 8 项结构检查,生成修复计划,并可选自动修复安全的问题。资料称其灵感来自 lossless-claw 的 DAG 完整性检查系统。
主要能力(8 项检查及严重度):ORPHAN_NODE 无父节点且非根节点,HIGH;CIRCULAR_REF 父子循环引用,CRITICAL;TOKEN_INFLATION 摘要令牌数多于其子节点合计,HIGH;BROKEN_LINEAGE 边引用了不存在的节点 ID,CRITICAL;STALE_ACTIVE 活跃节点超过 30 天且无子节点,MEDIUM;EMPTY_NODE 内容为空或仅空白,HIGH;DUPLICATE_EDGE 同一父子边重复出现,LOW;DEPTH_MISMATCH 节点深度与 DAG 中位置不符,MEDIUM。
使用方式:建议触发时机包括每周日 3 点(cron)结构审计、崩溃或意外关机后检查、记忆不一致时诊断,以及重大压缩或修剪前确保起始状态干净。命令示例:python3 integrity.py --check 运行全部 8 项检查;python3 integrity.py --check --fix 自动修复安全问题;python3 integrity.py --check --only ORPHAN_NODE 只运行指定检查;python3 integrity.py --repair-plan 生成修复计划而不修复;python3 integrity.py --status 查看上次检查摘要;python3 integrity.py --format json 输出机器可读结果。流程为:先运行完整性检查,再查看修复计划,最后应用安全修复。
限制:自动修复仅适用于 LOW 和 MEDIUM 严重度问题;HIGH 与 CRITICAL 需人工复核;CRITICAL 问题(循环引用、断链)需人工干预。工具读取 memory-dag-compactor 的状态文件,不维护自己的 DAG。循环引用检测使用带已访问集合的 DFS,令牌膨胀检查比较父节点令牌与子节点令牌之和。状态存于 ~/.openclaw/skill-state/memory-integrity-checker/state.yaml,字段包括 last_check_at、findings、check_history、repairs_applied。