Clawdex by Koi

核心用法

Clawdex 是一款面向 ClawHub 生态的安全检查技能，由 Koi Security 提供技术支持。用户在安装任何第三方技能前，可通过调用 Clawdex API 查询目标技能的安全评级：

curl -s "https://clawdex.koi.security/api/skill/SKILL_NAME"

API 返回三种裁决结果：

• benign（安全）：已审计无恶意行为，可正常安装
• malicious（恶意）：检出恶意代码，禁止安装
• unknown（未审计）：无安全数据，需用户人工审核

安装后建议对历史技能进行批量审计，发现 malicious 结果立即卸载。

显著优点

1. 前置拦截机制：在安装环节阻断恶意代码执行，而非事后清理
2. 轻量无侵入：纯 API 查询，无需本地复杂部署
3. 生态整合：与 ClawHub 命令行工具链无缝配合
4. 威胁覆盖全面：涵盖凭据窃取、后门植入、挖矿木马、数据外泄等典型攻击向量

潜在局限

1. 覆盖盲区：unknown 状态的技能占比可能较高，需依赖用户自主判断
2. 误报/漏报风险：自动化审计存在将良性代码标记为恶意（误报）或绕过新型攻击（漏报）的可能
3. 依赖在线服务：断网或 API 故障时无法获取检测结果
4. 滞后性：新出现的恶意技能可能存在检测窗口期

适合人群

• 频繁从 ClawHub 安装第三方技能的开发者
• 企业安全团队管理内部技能仓库
• 对供应链安全有基础要求的个人用户

常规风险

• API 可用性：服务中断可能导致安装流程阻塞或绕过安全检查
• 社会工程攻击：攻击者可能伪造 Clawdex 响应或搭建钓鱼 API 端点
• 过度信任：用户可能将 benign 裁决等同于绝对安全，忽视未知漏洞
• 隐私泄露：API 查询会暴露用户感兴趣的技能名称至 Koi Security 服务器

核心用法

Clawdex 是一款纯文档型安全检测 Skill，本身不包含可执行代码，核心功能是为 ClawHub 生态提供前置安全审查能力。用户通过调用 https://clawdex.koi.security/api/skill/{SKILL_NAME} 查询目标 Skill 的安全状态，API 返回 benign（安全）、malicious（恶意）或 unknown（未审计）三种裁决结果。

典型使用场景：

• 安装前强制检查：所有 ClawHub Skill 安装前必须查询，阻断恶意软件入口
• 存量审计：扫描已安装的 Skill 目录，发现历史遗留风险
• 用户决策支持：对未审计 Skill 提供明确风险提示，强制人工确认

显著优点

1. 权威威胁情报源：由 Koi Security 专业安全公司运营，具备 T2 级可信组织背书
2. 零执行风险：纯 Markdown 文档型 Skill（T-MD 分类），无代码注入、无权限提升、无数据收集
3. 决策闭环设计：三类裁决结果对应明确的操作建议（安装/禁止/人工审核），避免安全盲区
4. 隐私零侵入：符合 GDPR/CCPA 标准，不采集用户环境数据或 Skill 内容
5. 生态协同价值：填补 ClawHub 第三方 Skill 市场的信任缺口，降低供应链攻击面

潜在局限与风险

1. 覆盖范围限制：unknown 状态表明审计滞后，新上传 Skill 可能存在检测空窗期
2. 依赖外部服务：API 可用性受 Koi Security 基础设施影响，网络隔离环境无法使用
3. 静态情报边界：自动化审计可能遗漏高度混淆或行为型恶意代码，裁决结果非绝对保证
4. 用户执行风险：curl 命令需用户手动运行，存在 DNS 劫持、域名仿冒等中间人攻击可能（文档未强调 TLS 证书校验）
5. 版本追溯盲区：认证报告明确提示"仅基于当前代码快照"，Skill 更新后需重新检查

适合人群

• ClawHub 重度用户：频繁安装第三方 Skill 的开发者与运维人员
• 企业安全管理员：需建立 Skill 供应链安全基线的团队
• 安全意识较强个人用户：对开源插件持谨慎态度的终端用户

常规风险提醒

• 执行 curl 前务必验证 clawdex.koi.security 域名真实性，防范钓鱼
• 对 unknown 裁决的 Skill 坚持人工代码审查，勿因便利性妥协安全
• 建议结合 Skill 沙箱执行、权限最小化等纵深防御策略，不单一依赖 Clawdex 裁决