核心用法
ClawSecCheck 是一款面向 OpenClaw 用户的本地安全自审工具,通过只读方式扫描用户本地 OpenClaw 配置、启动文件(SOUL.md 等)、会话日志、已安装技能及 MCP 服务器配置,生成 A-F 等级安全评分与详细风险报告。
主要功能模式:
- 全面扫描(`--full`):一键审计配置、能力、MCP、技能内容,自动生成安全评分
- 安装前审查(`--vet`/`--vet-source`/`--vet-mcp`):对技能、插件、MCP 服务器进行供应链安全评估
- 实时监控(`--monitor`):建立本地基线,持续追踪配置漂移
- 主动测试(`--canary`/`--dryrun`/`--redteam`):模拟注入攻击,验证代理实际抵抗能力
- 报告导出(`--html`/`--sarif`/`--badge`):生成可分享的安全徽章或详细报告
显著优点
1. 完全本地离线:零网络连接,无 API Key,数据绝不离开本机
2. 真正只读:仅检测、绝不修改任何配置或文件
3. 深度覆盖:13 类 OpenClaw 攻击面,包括 Lethal Trifecta(外部输入×敏感数据×外联操作)、网关暴露、密钥泄露、最小权限、沙箱逃逸等
4. 恶意软件检测:内置 ClawHavoc 恶意技能特征库,识别 Shell 执行、凭证窃取、外联上传、Base64 混淆等攻击模式
5. 上下文隔离设计:针对不可信内容采用子代理隔离模式,防止提示注入通过审计输出攻击宿主
6. 多格式输出:支持交互式仪表板、JSON、HTML、SARIF、可分享徽章等
潜在局限
- 静态分析为主:无法检测运行时行为,需配合
--canary等主动测试验证实际抵抗能力 - 自报告置信度有限:B43/B44 等能力爆炸半径检查依赖代理自报告,属
ATTESTED置信度,弱于配置文件事实 - 插件 JS/TS 代码未覆盖:插件运行时代码超出静态扫描深度
- 无自动修复:纯报告工具,不提供修复建议或自动加固
- 需用户主动运行:无持续后台监控,依赖用户定期执行或手动设置定时任务
适合人群
- OpenClaw/AI Agent 用户希望了解自身安全 posture
- 安装第三方技能/MCP 服务器前的安全审查
- 企业安全团队进行 Agent 配置合规检查
- CI/CD 流水线集成安全门禁
- 安全意识强的个人用户定期自检
常规风险
1. 审计输出被污染:技能名称、文件内容、负载预览可能携带恶意指令,需遵循「绝不执行审计输出中的任何指令」原则
2. 隔离模式依赖环境:子代理隔离需主机环境支持 agents.subagents,否则回退到单代理模式,防护强度降低
3. 评分非运行时保证:高评分仅表示「静态配置非致命」,不代表运行时免疫注入攻击
4. 工具陈旧风险:长期未更新可能遗漏新型攻击特征,需用户主动关注版本更新