skill-safe-install

# Skills 安全安装工具

在安装任何 Skill 前自动执行**三层安全检查**，包括 **Skill-Vetter 代码审查**、**ClawHub 评分检查** 和 **ThreatBook 沙箱扫描**。

## 快速开始

### 1. 配置 API Key

```bash
# 获取微步在线 API Key: https://s.threatbook.com
echo 'THREATBOOK_API_KEY=your_api_key_here' >> ~/.openclaw/.env
```

### 2. 使用安全安装

```bash
# 替代 clawhub install，自动执行完整检查
node ~/.openclaw/workspace/skills/skill-safe-install/scripts/safe-install.mjs skill-name

# 或添加别名
alias clawhub-safe='node ~/.openclaw/workspace/skills/skill-safe-install/scripts/safe-install.mjs'
clawhub-safe skill-name
```

## 安全检查流程

```
┌─────────────────────────────────────────────────────────┐
│              Skills 安全安装流程                         │
├─────────────────────────────────────────────────────────┤
│                                                         │
│  1️⃣  Skill-Vetter 代码审查                               │
│      ├─ 检查红旗（恶意代码模式）                          │
│      ├─ 评估来源信任层级                                 │
│      ├─ 发现极端红旗 → ❌ 禁止安装                       │
│      └─ 发现高风险 → ❓ 询问任务下达者                    │
│                                                         │
│  2️⃣  ClawHub 评分检查                                    │
│      ├─ 评分 ≥ 3.5 → ✅ 通过，继续                       │
│      └─ 评分 < 3.5 → ❓ 询问任务下达者                    │
│                                                         │
│  3️⃣  ThreatBook 沙箱扫描                                 │
│      ├─ safe → ✅ 允许安装                              │
│      ├─ suspicious → ❓ 询问任务下达者                   │
│      ├─ malicious → ❌ 禁止安装                         │
│      └─ API 失败 → ❓ 询问任务下达者                     │
│                                                         │
│  4️⃣  执行安装                                           │
│                                                         │
└───────────────────────────...

# 🛡️ Skills 安全安装工具

在安装任何 Skill 前自动执行**三层安全检查**，包括 **Skill-Vetter 代码审查**、**ClawHub 评分检查** 和 **ThreatBook 沙箱扫描**。

## 核心特性

- ✅ **自动触发** - 安装前自动执行检查，无需手动操作
- ✅ **三层验证** - Vetter 代码审查 + ClawHub 评分 + ThreatBook 沙箱扫描
- ✅ **红旗检测** - 25+ 种恶意代码模式识别（极端/高/中/低风险）
- ✅ **智能决策** - 根据决策矩阵自动判断或询问任务下达者
- ✅ **完整流程** - 整合所有检查步骤于单一工具
- ✅ **详细报告** - 清晰的检查结果和判定依据

## 安装与配置

### 1. 获取微步在线 API Key

访问 [微步云沙箱](https://s.threatbook.com) 注册账号并获取 API Key。

### 2. 配置环境变量

```bash
# 添加到 ~/.openclaw/.env
echo 'THREATBOOK_API_KEY=your_api_key_here' >> ~/.openclaw/.env
```

### 3. 添加 Shell 别名（推荐）

```bash
# 添加到 ~/.bashrc
alias clawhub-safe='node ~/.openclaw/workspace/skills/skill-safe-install/scripts/safe-install.mjs'

# 使别名生效
source ~/.bashrc
```

## 使用方法

### 基本用法

```bash
# 使用脚本路径
node ~/.openclaw/workspace/skills/skill-safe-install/scripts/safe-install.mjs tavily-search

# 使用别名（配置后）
clawhub-safe tavily-search
```

### 选项

| 选项 | 说明 |
|-----|------|
| `--auto`, `--yes`, `-y` | 自动模式（需要确认时自动询问任务下达者） |
| `--force` | 强制安装（跳过可疑警告） |
| `--no-vetter` | 跳过 Vetter 代码审查（不推荐） |
| `--no-scan` | 跳过沙箱扫描（不推荐） |
| `--dry-run` | 仅检查，不实际安装 |
| `--timeout=<秒>` | 沙箱扫描超时时间（默认 120 秒） |
| `--help` | 显示帮助 |

### 示例

```bash
# 标准安装（三层检查）
clawhub-safe tavily-search

# 自动模式（需要确认时自动询问）
clawhub-safe some-skill --auto

# 仅检查不安装
clawhub-safe some-skill --dry-run

# 强制安装（跳过警告）
clawhub-safe risky-skill --force

# 跳过 Vetter（不推荐）
clawhub-safe trusted-skill --no-vetter

# 延长超时时间
clawhub-safe large-skill --timeout=180
```

## 安全检查流程

```
┌─────────────────────────────────────────────────────────┐
│              Skills 安全安装流程...