概述

安全管理已安装的OpenClaw扩展，扫描风险、存储风险列表、提供allowlist策略控制，确保在使用高风险扩展前进行风险提示和用户确认。

核心功能

• 自动扫描：扫描所有已安装的扩展，识别安全风险
• 风险评估：基于代码分析识别10种常见安全风险
• Allowlist管理：配置默认信任的扩展，跳过风险检查
• 黑名单管理：阻止危险扩展执行
• 风险提示：使用高风险扩展前提示用户确认
• 持久存储：保存风险报告到memory，支持历史查询

风险类别

使用方法

扫描所有扩展

执行skill-shield扫描所有已安装的扩展

检查特定扩展

执行skill-shield检查的风险

添加到Allowlist

执行skill-shield添加到allowlist

从Allowlist移除

执行skill-shield移除从allowlist

添加到黑名单

执行skill-shield添加到黑名单

查看风险报告

执行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
      后续使用将不再提示风险

风险等级映射

技术实现

扫描流程

• 遍历~/.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