ClawHub Pre-Publish Security Gate#

clawhub sync 前自动执行三项检查，全部通过才放行。

流程#

text

clawhub_gate.sh
├── 1. 本地静态分析  (即时)
│   ├── shellcheck  →  .sh 文件
│   └── bandit      →  .py 文件
│
└── 2. clawhub sync + ClawScan 轮询  (异步，约 30-90s)
    └── 轮询 clawhub API 直到 scan status != "pending"
        ├── VT=clean + Static=clean + LLM=clean  → 通过
        ├── VT=clean + Static=clean + LLM=suspicious → 警告通过（owner 接受 LLM 情境判断）
        └── VT 或 Static 失败  → 阻断

## 使用方式

在 skill 目录下运行 gate 脚本：

```bash
# 完整 gate：静态分析 + 发布 + ClawScan 轮询
SKILL_DIR=~/.hermes/skills/pg-game-monitor bash clawhub_gate.sh

# 仅本地静态分析（快速检查，不需要网络）
SKILL_DIR=~/.hermes/skills/pg-game-monitor bash clawhub_gate.sh --local-only

前置条件：已安装 shellcheck、 bandit、 jq、Python 3、 clawhub CLI（已登录）。

脚本行为：

• 读取 ~/.config/clawhub/config.json 获取 token（用于轮询 ClawScan API）
• 调用 clawhub sync 发布 skill（会创建/更新 ClawHub 版本）
• 若不需发布，先跑 --local-only 确认静态分析通过，再手动 clawhub sync

退出码#

码含义0全部通过1静态分析失败或 ClawScan flagged2ClawScan 超时（pending > 120s）3未找到 skill 目录或权限错误

检查详情#

静态分析#

工具扫描范围严重级别shellcheck*.shwarning + errorbandit*.pymedium + high + hidden

• 阈值：ERROR 数量 = 0；WARNING 数量 ≤ 10（可配置 WARN_LIMIT）
• 误报忽略： SC2154（未使用变量，常见于条件分支）、 SC2086（引号去除，常见于 grep -v）

ClawScan 轮询#

• 轮询间隔：15s

• 最大等待：120s（8 次）

• 状态判断：

  • clean → 通过
  • suspicious → 失败，输出警告
  • malicious → 失败，阻断
  • pending → 继续轮询
  • error → 失败

依赖#

bash

pip install --break-system-packages bandit
apt install -y shellcheck

参考#

• ClawScan 修复指南： clawhub skill → references/clawscan-remediation.md