Safety Checks

🛡️ 运行时安全验证 · 事前拦截风险

运行时安全验证套件,支持模型版本锁定、回退链验证、缓存时效检测及会话状态隔离检查,确保 AI 系统在运行前与运行中的可靠性。

收藏
5.5k
安装
1.4k
版本
1.2.0
CLS 安全扫描中
预计需要 3 分钟...

使用说明

核心用法

safety-checks 是一款面向 Agentic 工作流的运行时安全验证技能,通过 /sc 命令提供四个核心子命令:

  • `/sc model` — 验证当前 AI 模型版本是否与配置锁定一致,支持严格模式与宽松警告
  • `/sc fallback` — 检查 API、模型、存储三层回退链的可用性,可触发实际回退测试
  • `/sc cache` — 基于 TTL 检测缓存条目时效,支持自动清理过期数据
  • `/sc session` — 扫描工作区内跨会话状态污染(文件锁、孤儿文件、配置漂移)

所有检查均通过 HEARTBEAT 机制定期触发,形成事前验证(pre-flight)的安全屏障。

显著优点

1. 主动防御而非被动响应:在模型漂移、缓存失效、状态泄漏等问题引发实际故障前捕获异常
2. 声明式安全边界:通过 disable-model-invocation: true 明确承诺不调用 AI 模型,仅读取配置与系统状态,行为完全可预测

3. 精细化的权限隔离:严格限制访问范围为 .openclaw/.claude/output/safety/,不触碰系统环境变量或外部目录

4. 多层级回退保障:将 API、模型、存储的容灾能力显性化,避免单点故障导致的系统瘫痪

5. 零外部依赖:无需网络调用,纯本地配置与文件系统操作,离线环境完全可用

潜在缺点与局限性

  • 需要前置配置:必须手动维护 safety-checks.yaml 中的模型版本号与回退链定义,配置遗漏会导致检查失效
  • 工作区隔离依赖:会话污染检测仅限于技能声明的工作区路径,无法检测系统级或用户级的状态泄漏
  • 回退测试的副作用/sc fallback --test 实际触发回退链可能产生资源消耗或短暂的服务降级
  • TTL 策略一刀切:缓存时效判断基于固定阈值,难以适应不同业务场景对数据新鲜度的差异化需求
  • 无自动修复:除缓存清理与会话状态清理外,模型漂移、回退缺失等问题仍需人工介入决策

适合人群

  • AI 系统运维工程师:需要保障多模型、多版本环境下的服务稳定性
  • Agentic 工作流开发者:构建复杂多步骤流程,需在关键环节插入前置验证
  • 安全合规团队:需要可审计、可复现的运行时安全检查日志
  • 离线/边缘部署场景:无法依赖云端监控,需要本地化健康检查机制

常规风险

| 风险类别 | 说明 |
|---------|------|
| 配置漂移 | 模型版本或回退链配置未及时更新,导致检查通过但实际风险存在 |
| 误报清理 | `/sc cache --clear` 或 `/sc session --clear-state` 可能误删仍在使用的文件 |
| 权限边界突破 | 若 OpenClaw 框架本身被突破,技能声明的访问限制可能被绕过 |
| HEARTBEAT 风暴 | 高频自动检查在系统负载高时可能加剧资源竞争 |

Safety Checks 内容

手动下载zip · 4.7 kB
SKILL.mdtext/markdown
请选择文件