claw-security-suite
🛡️ OpenClaw 完整四层纵深安全防御体系 为 OpenClaw 提供从静态扫描到运行时防护的完整安全保障
功能特点
四层纵深防御
| 层级 | 功能 | 说明 |
|---|---|---|
| 第一层 | 静态代码扫描 | 安装前扫描，检测恶意代码、硬编码密钥、危险系统调用 |
| 第二层 | 逻辑安全审计 | 分析代码逻辑是否越权，检查是否符合最小权限原则 |
| 第三层 | 运行时实时防护 | 检测并阻止提示注入、命令注入、SSRF等攻击，自动净化输入 |
| 第四层 | 定期安全巡检 | 每日自动巡检、每周全量扫描、基线完整性保护 |
额外特性
- ✅ 完整的三层安全检查流程标准化沉淀
- ✅ 自动化定时任务集成
- ✅ 零配置开箱即用
- ✅ 详细的安全报告输出
- ✅ 符合 OpenClaw 标准规范
安装要求
- OpenClaw >= v0.8.0
- 不需要额外依赖，零配置开箱即用
- （可选）配置环境变量
CLAW_SECURITY_CLOUD_ENDPOINT启用云端情报校验
云端情报校验
默认内置提供腾讯云 ClawScan 云端情报接口，会查询已公开的技能安全信誉数据：
- 仅发送技能名称和来源标签，不传输任何本地文件、凭证或个人数据
- 默认启用（如果端点可用），不配置环境变量也可以使用
- 如果需要自定义云端服务，可以设置
CLAW_SECURITY_CLOUD_ENDPOINT环境变量修改端点
目录结构
openclaw-security-suite/
├── SKILL.md # 本文档
├── _meta.json # Skill元数据
├── lib/
│ ├── static_scanner.py # 第一层：静态代码扫描
│ ├── logic_auditor.py # 第二层：逻辑安全审计
│ ├── runtime_protector.py # 第三层：运行时防护
│ └── security_patrol.py # 第四层：定期巡检
└── references/
└── security_policy.md # 安全安装策略使用方法
三层安装检查流程（用于安装新skill）
from skills.claw-security-suite.lib.static_scanner import scan
# 带云端情报校验扫描（推荐）
result = scan(extracted_path, skill_name="your-skill-slug", source="clawhub")
if not result.is_safe:
# 拦截安装
print(result.to_report())
# 仅本地扫描（不联网）
result = scan(extracted_path)- 调用
static_scanner.scan(zip_path) - 调用
logic_auditor.audit(extracted_path) - 人工确认后安装
运行时保护
每次用户输入前自动调用：
from skills.openclaw-security-suite.lib.runtime_protector import RuntimeProtector
result = RuntimeProtector.check(user_input)
if result.is_malicious:
# 拒绝请求
logger.warning(f"Blocked malicious request: {result.reason}")
else:
# 净化后继续处理
clean_input = result.clean_input每日巡检
from skills.openclaw-security-suite.lib.security_patrol import daily_patrol
daily_patrol.run()每周扫描
from skills.openclaw-security-suite.lib.security_patrol import weekly_scan
weekly_scan.run()安全规则
- 禁止任何skill读取
/app/working/.env除非是安全审计本身 - 禁止任何skill执行任意系统命令除非明确需要
- 禁止硬编码API密钥或凭证
- 禁止向外发送敏感信息
- 最小权限原则：只做声明的功能，不越权
作者
Kenz1117
许可证
MIT-0 (MIT No Attribution)