safety-checks（安全）

统一的运行时安全验证能力，涵盖模型版本锁定、回退链校验、缓存陈旧性检测及跨会话状态检查。将 4 个细粒度能力整合为一个完整的安全验证套件。

触发时机：事前检验（pre-flight）或 HEARTBEAT

源能力：model-pinner、fallback-checker、cache-validator、cross-session-safety-check（来自 extensions）

安装

openclaw install leegitw/safety-checks

依赖项：leegitw/constraint-engine（用于强制执行集成）

# 安装含依赖项的完整套件
openclaw install leegitw/context-verifier
openclaw install leegitw/failure-memory
openclaw install leegitw/constraint-engine
openclaw install leegitw/safety-checks

独立使用：模型锁定与缓存检查可独立运行；若需与约束强制执行（constraint enforcement）完全集成，则必须安装 constraint-engine。

数据处理方式：本能力仅执行本地操作。所有检查（模型版本比对、缓存时效性验证、文件锁检测）均为本地文件/元数据操作——不向任何模型、API 或外部服务发送数据。结果写入工作区中的 output/safety/ 目录。

解决的问题

AI 系统可能在无声中退化——模型版本漂移、缓存过期、会话累积状态。本能力可在问题引发实际故障前及时捕获：

1. 模型锁定——确认你正在使用预期的模型
2. 回退校验——确保降级模式路径存在且可用
3. 缓存检查——识别陈旧或损坏的缓存数据
4. 会话卫生——识别跨会话状态污染

核心洞察：运行时验证可捕获静态规则无法覆盖的问题。应检查系统实际运行状态，而不仅限于配置本身。

用法

/sc <子命令> [参数]

子命令

参数

/sc model

/sc fallback

注意：该命令仅校验你的配置文件中是否存在回退配置项，不会发起网络调用，也不测试实际连通性。这是一次纯配置文件审计。

/sc cache

/sc session

配置

配置按以下优先级顺序加载：

1. .openclaw/safety-checks.yaml（OpenClaw 标准）
2. .claude/safety-checks.yaml（Claude Code 兼容性）
3. 默认值（内置）

核心逻辑

模型版本锁定

确保 AI 模型版本与预期配置一致。

工作原理：本能力将代理（agent）会话元数据中报告的模型版本（例如 API 响应或代理头中的模型名称）与配置文件中声明的预期版本进行比对。它不会调用模型 API 进行校验，而是直接读取代理运行时已暴露的版本字符串。

模型版本格式：{provider}-{model}-{version}-{date}

示例：

• anthropic-opus-4-5-20251101
• openai-gpt-4-turbo-20250301
• google-gemini-2-pro-20260101

# .openclaw/safety-checks.yaml
model:
  expected: "anthropic-opus-4-5-20251101"  # 与提供方无关的格式
  strict: true

回退链校验

仅配置审计——仅校验配置文件中是否存在回退条目。本命令不会发起网络调用，也不测试实际连通性。

检查你的 safety-checks.yaml 是否声明了回退配置：

# 此命令校验如下配置项是否存在：
fallbacks:
  model: ["primary-model", "fallback-model", "cached"]
  storage: ["primary-path", "backup-path"]

缓存陈旧性检测

防止使用过期的缓存数据：

跨会话状态

检测会话之间的状态泄露：

作用域说明：所有检查严格限定于本能力自身所使用的文件路径。本能力不会扫描目录，不会读取其他能力的配置文件，也不会访问上述明确列出路径之外的任何文件。

输出

/sc model 输出（已锁定）

[MODEL CHECK]
Status: ✓ PINNED

Expected: anthropic-opus-4-5-20251101
Actual:   anthropic-opus-4-5-20251101

Model version matches configuration.

/sc model 输出（版本漂移）

[MODEL CHECK]
Status: ✗ VERSION DRIFT

Expected: anthropic-opus-4-5-20251101
Actual:   anthropic-opus-4-5-20251201

WARNING: Model version has changed.
This may affect behavior consistency.

Action: Update expected version in settings, or investigate change.

/sc fallback 输出

[FALLBACK CHECK]
Status: ✓ CONFIGURED

Config file: .openclaw/safety-checks.yaml

Fallback entries found:
  ✓ model.fallbacks: 3 entries defined
  ✓ storage.fallbacks: 2 entries defined

Note: This validates config entries exist, not actual connectivity.
  ✓ Tertiary (memory) - 4GB free

/sc cache 输出

[CACHE CHECK]
Status: ⚠ STALE ENTRIES FOUND

Cache Statistics:
  Total entries: 156
  Fresh (< 1h): 142
  Stale (> 1h): 14
  Critical stale: 0

Stale entries:
  - api_response_auth (age: 2h 15m)
  - user_preferences (age: 1h 30m)
  - ...

Action: Run /sc cache --clear to remove stale entries.

/sc session 输出（无干扰）

[SESSION CHECK]
Status: ✓ CLEAN

No cross-session interference detected.

Checks passed:
  ✓ No stale lock file (.openclaw/safety-checks.lock)
  ✓ No orphan temp files (output/safety/temp-*)
  ✓ Config file valid (.openclaw/safety-checks.yaml)

/sc session 输出（检测到干扰）

[SESSION CHECK]
Status: ✗ INTERFERENCE DETECTED

Issues found:

1. Stale file lock:
   File: .openclaw/safety-checks.lock
   Owner: PID 12345 (not running)
   Action: Remove lock with /sc session --clear-state

2. Orphan temp files (3):
   output/safety/temp-*.log
   Age: > 24 hours
   Action: Remove with /sc session --clear-state

Run /sc session --clear-state to remediate.

集成

• 所属层级：Safety
• 依赖项：constraint-engine（用于强制执行集成）
• 被以下能力使用：constraint-engine（用于预操作安全检查）、governance（用于健康监控）

故障模式

后续步骤

调用本能力后：

工作区文件

本能力仅在声明路径内进行读写操作：

.openclaw/
├── safety-checks.yaml     # 主配置文件（读取）
└── cache/
    └── staleness.log      # 缓存检查历史（读/写）

.claude/
└── safety-checks.yaml     # Claude Code 配置（读取）

output/
└── safety/
    ├── model-checks.log   # 模型版本历史（写入）
    ├── fallback-tests.log # 回退测试结果（写入）
    └── session-state.log  # 会话状态日志（写入）

注意：本能力不会读取 .claude/settings.json 或任何其他工具的配置文件。

HEARTBEAT 集成

这些检查应通过 HEARTBEAT 定期执行：

## P1：关键项（每次会话）
- [ ] 模型版本是否已锁定？ → /sc model
- [ ] 会话状态是否干净？ → /sc session

## P2：重要项（每周）
- [ ] 回退链是否健康？ → /sc fallback
- [ ] 缓存是否新鲜？ → /sc cache

示例

模型漂移检测

/sc model --strict
[MODEL CHECK]
Status: ⚠ VERSION DRIFT

Expected: anthropic-opus-4-5-20251101
Actual:   anthropic-opus-4-5-20260101

Model version changed. Review CHANGELOG for behavior changes.

缓存清理

/sc cache --clear
[CACHE CHECK]
Status: ✓ CLEANED

Removed 14 stale entries from .openclaw/cache/
Freed: 2.3 MB

安全考虑

纯本地处理：所有安全检查均为本地文件和元数据操作。不向任何 LLM、API 或外部服务发送数据。“代理的模型”仅用于解释你的命令——不用于处理或传输你的数据。

确切访问的文件（读取）：

• .openclaw/safety-checks.yaml —— 本能力的配置
• .claude/safety-checks.yaml —— 替代配置位置
• .openclaw/cache/staleness.log —— 缓存检查历史（如存在）

确切写入的文件：

• output/safety/*.log —— 检查结果与历史记录

本能力不会扫描目录，也不会读取其他能力的配置文件。

本能力不访问以下内容：

• 其他能力的配置文件
• 系统环境变量
• .claude/settings.json 或其他工具的配置
• 上述三个配置路径以外的任何文件
• 网络资源或外部 API

本能力不执行以下操作：

• 向任何模型或外部服务发送数据
• 修改 output/safety/ 以外的文件
• 执行任意代码

数据处理原则：

• 除针对自身缓存/输出的 --clear 操作外，其余检查均为只读
• 结果仅写入 output/safety/
• 无任何数据离开本地机器

关于模型版本的说明：
/sc model 命令将配置中声明的预期版本与代理运行时报告的模型版本字符串（例如会话元数据或 API 响应头中）进行比对。它不会调用 API 来验证模型——而是读取代理运行时已提供的信息。

来源说明：
本能力由 Live Neon（https://github.com/live-neon/skills）开发，并以 leegitw 账户发布至 ClawHub。二者指向同一维护者。

验收标准

• /sc model 验证模型版本与配置一致
• /sc model 根据 strict 设置，在版本漂移时发出警告或报错
• /sc fallback 验证配置文件中存在回退配置项
• /sc cache 检测出早于 TTL 的缓存条目
• /sc cache --clear 清除陈旧条目
• /sc session 检测跨会话状态泄露
• /sc session --clear-state 修复已发现的问题
• 所有检查均已集成至 HEARTBEAT

作为智能体能力整合（agentic skills consolidation）的一部分，由 4 个独立能力合并而成（2026-02-15）。