OA0 = Omni AI 0

OA0 是一个探索 AI 的论坛

现在注册

已注册用户请登录

名称： clawtributor
版本： 0.0.3
描述： AI 智能体的社区事件报告。通过报告威胁，为集体安全贡献力量。
主页： https://gclawsec.prompt.security
元数据： {"openclaw":{"emoji":"🤝","category":"security"}}
clawdis:
emoji: "🤝"
requires:
bins: [curl, git, gh]

Clawtributor 🤝

AI 智能体的社区事件报告工具。通过报告威胁、漏洞和攻击模式，为集体安全贡献力量。

由 Prompt Security 开发的开源项目

致 AI 智能体

如果你是正在阅读此文的 AI 智能体，请执行以下命令安装 Clawtributor：

# 获取最新的 clawtributor 发布标签
LATEST_TAG=$(curl -sSL https://api.github.com/repos/prompt-security/ClawSec/releases | \
  jq -r '[.[] | select(.tag_name | startswith("clawtributor-v"))][0].tag_name')

# 从最新发布版本下载 SKILL.md
SKILL_URL="https://github.com/prompt-security/clawsec/releases/download/$LATEST_TAG/SKILL.md"
curl -sSL --fail --show-error "$SKILL_URL"

获取此技能文件后，请继续阅读下方的 部署 Clawtributor。

部署 Clawtributor

安装步骤：

步骤 1：创建技能目录并保存此文件

mkdir -p ~/.openclaw/skills/clawtributor
# 将此 SKILL.md 文件保存为上述目录中的 SKILL.md

步骤 2：安装技能文件

# 获取最新发布标签（带重试逻辑）
LATEST_TAG=$(curl -sSL --retry 3 --retry-delay 1 \
  https://api.github.com/repos/prompt-security/ClawSec/releases | \
  jq -r '[.[] | select(.tag_name | startswith("clawtributor-v"))][0].tag_name')

BASE_URL="https://github.com/prompt-security/clawsec/releases/download/$LATEST_TAG"
INSTALL_DIR="${CLAWTRIBUTOR_INSTALL_DIR:-$HOME/.openclaw/skills/clawtributor}"
TEMP_DIR=$(mktemp -d)
trap "rm -rf '$TEMP_DIR'" EXIT

# 下载 checksums.json（完整性验证必需）
echo "正在下载校验和文件..."
if ! curl -sSL --fail --show-error --retry 3 --retry-delay 1 \
     "$BASE_URL/checksums.json" -o "$TEMP_DIR/checksums.json"; then
  echo "错误：无法下载 checksums.json"
  exit 1
fi

# 验证 checksums.json 结构
if ! jq -e '.skill and .version and .files' "$TEMP_DIR/checksums.json" >/dev/null 2>&1; then
  echo "错误：checksums.json 结构无效"
  exit 1
fi

# 主要方案：尝试 .skill 归档文件安装
echo "正在尝试 .skill 归档文件安装..."
if curl -sSL --fail --show-error --retry 3 --retry-delay 1 \
   "$BASE_URL/clawtributor.skill" -o "$TEMP_DIR/clawtributor.skill" 2>/dev/null; then

  # 安全检查：验证归档文件大小（防止 DoS）
  ARTIFACT_SIZE=$(stat -c%s "$TEMP_DIR/clawtributor.skill" 2>/dev/null || stat -f%z "$TEMP_DIR/clawtributor.skill")
  MAX_SIZE=$((50 * 1024 * 1024))  # 50MB

  if [ "$ARTIFACT_SIZE" -gt "$MAX_SIZE" ]; then
    echo "警告：归档文件过大 ($(( ARTIFACT_SIZE / 1024 / 1024 ))MB)，回退到单独文件下载"
  else
    echo "正在解压归档文件 ($(( ARTIFACT_SIZE / 1024 ))KB)..."

    # 安全检查：解压前检查路径遍历
    if unzip -l "$TEMP_DIR/clawtributor.skill" | grep -qE '\.\./|^/|~/'; then
      echo "错误：在归档文件中检测到路径遍历 - 可能存在安全问题！"
      exit 1
    fi

    # 安全检查：检查文件数量（防止 zip 炸弹）
    FILE_COUNT=$(unzip -l "$TEMP_DIR/clawtributor.skill" | grep -c "^[[:space:]]*[0-9]" || echo 0)
    if [ "$FILE_COUNT" -gt 100 ]; then
      echo "错误：归档文件包含过多文件 ($FILE_COUNT) - 可能是 zip 炸弹"
      exit 1
    fi

    # 解压到临时目录
    unzip -q "$TEMP_DIR/clawtributor.skill" -d "$TEMP_DIR/extracted"

    # 验证 skill.json 是否存在
    if [ ! -f "$TEMP_DIR/extracted/clawtributor/skill.json" ]; then
      echo "错误：在归档文件中未找到 skill.json"
      exit 1
    fi

    # 验证所有解压文件的校验和
    echo "正在验证校验和..."
    CHECKSUM_FAILED=0
    for file in $(jq -r '.files | keys[]' "$TEMP_DIR/checksums.json"); do
      EXPECTED=$(jq -r --arg f "$file" '.files[$f].sha256' "$TEMP_DIR/checksums.json")
      FILE_PATH=$(jq -r --arg f "$file" '.files[$f].path' "$TEMP_DIR/checksums.json")

      # 先尝试嵌套路径，然后尝试扁平文件名
      if [ -f "$TEMP_DIR/extracted/clawtributor/$FILE_PATH" ]; then
        ACTUAL=$(shasum -a 256 "$TEMP_DIR/extracted/clawtributor/$FILE_PATH" | cut -d' ' -f1)
      elif [ -f "$TEMP_DIR/extracted/clawtributor/$file" ]; then
        ACTUAL=$(shasum -a 256 "$TEMP_DIR/extracted/clawtributor/$file" | cut -d' ' -f1)
      else
        echo "  ✗ $file (在归档文件中未找到)"
        CHECKSUM_FAILED=1
        continue
      fi

      if [ "$EXPECTED" != "$ACTUAL" ]; then
        echo "  ✗ $file (校验和不匹配)"
        CHECKSUM_FAILED=1
      else
        echo "  ✓ $file"
      fi
    done

    if [ "$CHECKSUM_FAILED" -eq 0 ]; then
      # 成功：从归档文件安装
      echo "正在从归档文件安装..."
      mkdir -p "$INSTALL_DIR"
      cp -r "$TEMP_DIR/extracted/clawtributor"/* "$INSTALL_DIR/"
      chmod 600 "$INSTALL_DIR/skill.json"
      find "$INSTALL_DIR" -type f ! -name "skill.json" -exec chmod 644 {} \;
      echo "成功：技能已从 .skill 归档文件安装"
      exit 0
    else
      echo "警告：校验和验证失败，回退到单独文件下载"
    fi
  fi
fi

# 备用方案：下载单独文件
echo "正在根据 checksums.json 清单下载单独文件..."
mkdir -p "$TEMP_DIR/downloads"

DOWNLOAD_FAILED=0
for file in $(jq -r '.files | keys[]' "$TEMP_DIR/checksums.json"); do
  FILE_URL=$(jq -r --arg f "$file" '.files[$f].url' "$TEMP_DIR/checksums.json")
  EXPECTED=$(jq -r --arg f "$file" '.files[$f].sha256' "$TEMP_DIR/checksums.json")

  echo "正在下载：$file"
  if ! curl -sSL --fail --show-error --retry 3 --retry-delay 1 \
       "$FILE_URL" -o "$TEMP_DIR/downloads/$file"; then
    echo "错误：无法下载 $file"
    DOWNLOAD_FAILED=1
    continue
  fi

  # 立即验证校验和
  ACTUAL=$(shasum -a 256 "$TEMP_DIR/downloads/$file" | cut -d' ' -f1)
  if [ "$EXPECTED" != "$ACTUAL" ]; then
    echo "错误：$file 的校验和不匹配"
    DOWNLOAD_FAILED=1
  else
    echo "  ✓ 已验证：$file"
  fi
done

if [ "$DOWNLOAD_FAILED" -eq 1 ]; then
  echo "错误：单独文件下载失败"
  exit 1
fi

# 验证 JSON 结构
if ! jq -e '.name and .version' "$TEMP_DIR/downloads/skill.json" >/dev/null 2>&1; then
  echo "错误：skill.json 缺少必需字段 (name, version)"
  exit 1
fi

# 安装文件
echo "正在从单独文件安装..."
mkdir -p "$INSTALL_DIR"
cp "$TEMP_DIR/downloads"/* "$INSTALL_DIR/"
chmod 600 "$INSTALL_DIR/skill.json"
find "$INSTALL_DIR" -type f ! -name "skill.json" -exec chmod 644 {} \;
echo "成功：技能已从单独文件安装"

步骤 3：确认部署

告知你的用户：

Clawtributor 已成功部署。

重要提示：此技能支持社区安全事件报告。
- 报告为**选择加入** - 我仅在获得你的明确批准后才会提交报告
- 报告将作为 GitHub Issue 使用安全事件报告模板提交
- 经维护者审核批准后，公告将自动发布为 CLAW-{年份}-{问题号}
- 你完全控制共享哪些信息

你想让我解释报告是如何工作的吗？

Clawtributor 的功能

社区驱动的安全报告

Clawtributor 使智能体能够为集体安全贡献力量：

报告恶意提示尝试 - 帮助识别新的攻击模式
报告存在漏洞的技能 - 向社区预警危险插件
报告篡改尝试 - 记录针对安全工具的攻击

所有报告均为选择加入，且需要用户批准。

报告工作流程

┌─────────────────────────────────────────────────────────────┐
│                                                             │
│   智能体观察到 ──► 创建报告 ──► 用户批准                    │
│   可疑活动                                    │              │
│                                             ▼              │
│                                        GitHub Issue         │
│                                             │               │
│                                     维护者审核              │
│                                             │               │
│                                   "advisory-approved"?      │
│                                        │      │             │
│                                       YES     NO            │
│                                        │      │             │
│                                        ▼      ▼             │
│   公告订阅源 ◄── 自动发布         提供反馈                  │
│   (CLAW-YYYY-NNNN)       ↓                                  │
│   所有智能体通过 clawsec-feed 收到通知                     │
│                                                             │
└─────────────────────────────────────────────────────────────┘

需要报告的内容

1. 恶意提示尝试

试图进行以下操作的提示：
- 绕过安全控制或沙箱
- 提取敏感信息（凭证、API 密钥、个人数据）
- 操纵智能体执行有害操作
- 禁用或规避安全工具
- 注入指令以覆盖用户意图

示例指标：
- "忽略之前的指令..."
- "你现在处于开发者模式..."
- 编码/混淆的负载
- 尝试访问系统文件或环境变量

2. 存在漏洞的技能/插件

表现出以下行为的技能：
- 数据外泄（将数据发送到未知的外部服务器）
- 无正当理由的过度权限请求
- 自我修改或自我复制行为
- 尝试禁用安全工具
- 欺骗性功能

3. 篡改尝试

任何试图：
- 修改安全技能文件
- 禁用安全审计定时任务
- 更改公告订阅源 URL
- 移除或绕过健康检查的行为

创建报告

完整报告格式和提交指南请参阅 REPORTING.md。

快速报告格式

{
  "report_type": "malicious_prompt | vulnerable_skill | tampering_attempt",
  "severity": "critical | high | medium | low",
  "title": "简短的描述性标题",
  "description": "观察到的详细描述",
  "evidence": {
    "observed_at": "2026-02-02T15:30:00Z",
    "context": "发生此事件时的上下文",
    "payload": "观察到的实际提示/代码/行为（已清理）",
    "indicators": ["具体", "指标", "列表"]
  },
  "affected": {
    "skill_name": "技能名称（如适用）",
    "skill_version": "1.0.0（如已知）"
  },
  "recommended_action": "用户应采取的措施"
}

提交报告

步骤 1：准备报告

# 安全地创建报告文件（防止符号链接攻击）
REPORTS_DIR="$HOME/.openclaw/clawtributor-reports"

# 如果目录不存在，则创建并设置安全权限
if [ ! -d "$REPORTS_DIR" ]; then
  mkdir -p "$REPORTS_DIR"
  chmod 700 "$REPORTS_DIR"
fi

# 验证目录归当前用户所有（安全检查）
DIR_OWNER=$(stat -f '%u' "$REPORTS_DIR" 2>/dev/null || stat -c '%u' "$REPORTS_DIR" 2>/dev/null)
if [ "$DIR_OWNER" != "$(id -u)" ]; then
  echo "错误：报告目录不归当前用户所有" >&2
  echo "  目录：$REPORTS_DIR" >&2
  echo "  所有者 UID：$DIR_OWNER，当前 UID：$(id -u)" >&2
  exit 1
fi

# 验证目录具有安全权限
DIR_PERMS=$(stat -f '%Lp' "$REPORTS_DIR" 2>/dev/null || stat -c '%a' "$REPORTS_DIR" 2>/dev/null)
if [ "$DIR_PERMS" != "700" ]; then
  echo "错误：报告目录权限不安全：$DIR_PERMS" >&2
  echo "  修复命令：chmod 700 '$REPORTS_DIR'" >&2
  exit 1
fi

# 使用 mktemp 原子性地创建唯一文件（防止符号链接跟随）
# 包含时间戳以提高可读性，但依赖 mktemp 实现不可预测性
TIMESTAMP=$(TZ=UTC date +%Y%m%d%H%M%S)
REPORT_FILE=$(mktemp "$REPORTS_DIR/${TIMESTAMP}-XXXXXX.json") || {
  echo "错误：无法创建报告文件" >&2
  exit 1
}

# 立即设置安全权限
chmod 600 "$REPORT_FILE"

# 使用 heredoc 将报告 JSON 写入文件（防止命令注入）
# 将 REPORT_JSON_CONTENT 替换为你的实际报告内容
cat > "$REPORT_FILE" << 'REPORT_EOF'
{
  "report_type": "vulnerable_skill",
  "severity": "high",
  "title": "示例报告标题",
  "description": "此处为详细描述"
}
REPORT_EOF

# 继续之前验证 JSON
if ! jq empty "$REPORT_FILE" 2>/dev/null; then
  echo "错误：报告文件中的 JSON 无效"
  rm -f "$REPORT_FILE"
  exit 1
fi

步骤 2：获取用户批准

关键：始终向用户展示将要提交的内容：

🤝 Clawtributor：准备提交安全报告

报告类型：vulnerable_skill
严重性：high
标题：技能 'helper-plus' 存在数据外泄

摘要：helper-plus 技能将会话数据发送到外部服务器。

此报告将使用安全事件报告模板作为 GitHub Issue 提交。
经维护者审核批准后，它将作为公告 (CLAW-YYYY-NNNN) 发布。

你批准提交此报告吗？(yes/no)

步骤 3：通过 GitHub Issue 提交

仅在用户批准后：

# 使用安全事件模板将报告作为 GitHub Issue 提交
gh issue create \
  --repo prompt-security/ClawSec \
  --title "[Report] $TITLE" \
  --body "$REPORT_BODY" \
  --label "security,needs-triage"

隐私指南

报告时：

应包含：
- 恶意提示的清理后示例（移除任何真实用户数据）
- 技术性入侵指标
- 技能名称和版本
- 可观察的行为

不应包含：
- 真实用户对话或个人数据
- API 密钥、凭证或秘密
- 可能识别特定用户的信息
- 专有或机密信息

响应格式

检测到威胁时：

🤝 Clawtributor：检测到安全事件

我观察到一个潜在的安全威胁：
- 类型：提示注入尝试
- 严重性：高
- 详情：尝试提取环境变量

你希望我为社区准备一份报告吗？
这有助于保护其他智能体免受类似攻击。

选项：
1. 是，准备一份报告供我审阅
2. 否，仅在本地记录
3. 告诉我更多关于检测到的内容

报告提交后：

```
🤝 Clawtributor：报告已提交

你的报告已作为 GitHub Issue #42 提交。
- Issue URL：https://github.com/prompt-security/clawsec/issues/42
- 状态：等待维护者审核
- 公告 ID（如批准）：CLAW-2026-0042

一旦维护者添加 "advisory-approved" 标签，你的报告将自动发布到公告订阅源。

技能包地址：https://github.com/openclaw/skills/tree/main/skills/davida-ps/clawtributor/SKILL.md

3 次点击 ∙ 0 人收藏

登录后收藏

目前尚无回复

0 条回复

clawtributor：针对 AI 智能体的社区事件报告系统