- name
- skill-shield
- description
- OpenClaw扩展安全管理系统。扫描已安装扩展的安全风险，提供allowlist策略控制，在使用高风险扩展前进行风险提示。适用于安全管理、风险评估、权限控制场景。
- metadata
- { "openclaw": { "emoji": "🛡️", "requires": { "bins": ["python3"] } } }
Skill Shield - OpenClaw扩展安全管理系统
概述
安全管理已安装的OpenClaw扩展，扫描风险、存储风险列表、提供allowlist策略控制，确保在使用高风险扩展前进行风险提示和用户确认。
核心功能
- 自动扫描：扫描所有已安装的扩展，识别安全风险
- 风险评估：基于代码分析识别10种常见安全风险
- Allowlist管理：配置默认信任的扩展，跳过风险检查
- 黑名单管理：阻止危险扩展执行
- 风险提示：使用高风险扩展前提示用户确认
- 持久存储：保存风险报告到memory，支持历史查询
风险类别
| 风险ID | 风险名称 | 严重程度 | 检测关键词 |
|---|---|---|---|
| R001 | 网络访问 | 高 | requests, curl, fetch, urllib, http, socket |
| R002 | 文件写入 | 高 | write, create, save, mkdir, rmdir, unlink |
| R003 | 文件读取 | 中 | read, open, cat, glob, listdir |
| R004 | 命令执行 | 严重 | exec, subprocess, shell, spawn, Popen, system |
| R005 | 外部API | 中 | api, webhook, endpoint, send, notify, post, get |
| R006 | 数据外发 | 严重 | upload, send, transfer, export, forward |
| R007 | 凭证访问 | 严重 | apiKey, password, token, secret, credential, auth |
| R008 | 无签名验证 | 低 | 无_meta.json文件 |
| R009 | 依赖未知 | 中 | requirements.txt, package.json, dependencies |
| R010 | 权限过宽 | 高 | chmod 777, allowlist, full |
使用方法
扫描所有扩展
执行skill-shield扫描所有已安装的扩展检查特定扩展
执行skill-shield检查<extension-name>的风险添加到Allowlist
执行skill-shield添加<extension-name>到allowlist从Allowlist移除
执行skill-shield移除<extension-name>从allowlist添加到黑名单
执行skill-shield添加<extension-name>到黑名单查看风险报告
执行skill-shield查看风险列表清除风险记录
执行skill-shield清除风险记录配置说明
配置文件位置：~/.openclaw/workspace/skills/skill-shield/config.json
{
"allowlist": ["file-search", "weather-search"],
"autoApprove": [],
"blocked": [],
"scanOnInstall": true,
"promptOnHighRisk": true
}- allowlist: 默认信任的扩展，跳过风险检查
- autoApprove: 自动批准的扩展（不需要用户确认）
- blocked: 黑名单，完全阻止执行
- scanOnInstall: 安装时自动扫描
- promptOnHighRisk: 高风险时提示用户
数据存储
风险数据库位置：~/.openclaw/workspace/memory/shield-risks.json
{
"version": "1.0.0",
"lastScanTime": "2026-03-11T09:45:00Z",
"skills": {
"extension-name": {
"path": "/path/to/extension",
"risks": ["R001", "R004", "R006"],
"severity": "severe",
"scanTime": "2026-03-11T09:45:00Z",
"userDecision": "approved"
}
},
"allowlist": ["file-search", "weather-search"],
"history": [
{
"extension": "extension-name",
"action": "blocked",
"time": "2026-03-11T09:50:00Z"
}
]
}使用示例
场景1：首次扫描
用户：扫描所有扩展
Agent：🔍 正在扫描9个扩展...
📊 扫描完成!
🔴 严重: 6
🟠 高危: 1
🟡 中危: 0
🟢 低危/安全: 2
💾 风险报告已保存场景2：使用高风险扩展
用户：执行a-stock-dragon-tiger
Agent：⚠️ 安全警告
扩展: a-stock-dragon-tiger
风险等级: severe
风险项:
- R001: 网络访问
- R004: 命令执行
- R006: 数据外发
是否继续? (yes/no):
用户：yes
Agent：✅ 继续执行场景3：添加到Allowlist
用户：将weather-search添加到allowlist
Agent：✅ 已将weather-search添加到allowlist
后续使用将不再提示风险风险等级映射
| 严重程度 | 包含风险 | 用户确认要求 |
|---|---|---|
| 严重 | R004, R006, R007 | 强制确认 |
| 高 | R001, R002, R010 | 强制确认 |
| 中 | R003, R005, R009 | 建议确认 |
| 低 | R008 | 可选确认 |
技术实现
扫描流程
- 遍历
~/.openclaw/workspace/skills/目录 - 读取每个扩展的SKILL.md、scripts/、references/
- 基于关键词匹配识别风险
- 计算严重程度等级
- 生成风险报告并存储
检查流程
- 检查扩展是否在allowlist → 跳过检查
- 检查扩展是否在blocked → 阻止执行
- 查询风险数据库 → 获取风险信息
- 根据严重程度决定是否提示用户
- 记录用户决策到历史
安全原则
- ✅ 所有高风险操作需要用户明确确认
- ✅ Allowlist中的扩展默认信任
- ✅ 风险记录持久化存储
- ✅ 支持审计历史查询
- ✅ 黑名单完全阻止执行
扩展计划
- [ ] Hook机制：在使用扩展前自动检查
- [ ] 安装时扫描：clawhub install时自动扫描
- [ ] 风险修复建议：提供风险缓解建议
- [ ] 定期报告：每周发送安全报告到飞书
故障排除
扫描失败
# 检查扩展目录权限
ls -la ~/.openclaw/workspace/skills/
# 手动运行扫描
python3 ~/.openclaw/workspace/skills/skill-shield/scripts/shield.py scan配置文件错误
# 重置配置文件
echo '{}' > ~/.openclaw/workspace/skills/skill-shield/config.json依赖要求
- Python 3.6+
- 无需额外依赖包
- 标准库：os, re, json, glob, hashlib, pathlib, datetime, argparse, typing