cache-monitor

name	cache-monitor
description	追踪静态层文件 hash，检测 prompt cache 失效。注册为 PreAgentStart 钩子，每次 session 启动时自动运行。有变更时输出警告，无变更静默通过。

Cache Monitor — 静态层 Hash 追踪

功能

每次 session 启动时自动检测静态层文件是否变更，帮助追踪哪些操作导致 prompt cache 失效。

追踪的文件

文件	说明
SOUL.md	角色设定
AGENTS.md	行为规则
TOOLS.md	本地配置
USER.md	Boss 信息
IDENTITY.md	身份元数据
HEARTBEAT.md	心跳任务
STATIC.md	核心规则摘要

状态文件

~/.openclaw/workspace/.cache-monitor.json

{
  "last_updated": "2026-04-04T00:10:00",
  "hashes": {
    "SOUL.md": {"hash": "sha256...", "size": 2741, "exists": true},
    "AGENTS.md": {"hash": "sha256...", "size": 12000, "exists": true}
  },
  "change_log": [
    {"date": "2026-04-03", "file": "AGENTS.md", "reason": "追加工具权限分层规则"}
  ]
}

变更记录格式

有变更时输出：

⚠️ Cache 失效：[文件名] 已变更（上次变更原因：[原因]），本次对话静态层需重新计算

无变更：静默通过，无任何输出。

核心文件

文件	作用
scripts/cache_monitor.py	Hash 计算 + 变更检测
~/.openclaw/workspace/.cache-monitor.json	状态持久化

命令

# 初始化/更新 hash 记录
python3 ~/.openclaw/workspace/skills/cache-monitor/scripts/cache_monitor.py --init

# 检查变更（默认）
python3 ~/.openclaw/workspace/skills/cache-monitor/scripts/cache_monitor.py --check

注册方式

通过 OpenClaw agent:bootstrap 钩子自动触发。

⚠️ OpenClaw 当前没有 PreAgentStart 内置钩子。 本 skill 使用 agent:bootstrap 作为近似替代——在 agent 初始化阶段触发，早于 session 正式启动。

已注册钩子：~/.openclaw/hooks/cache-monitor-hook/