EdgeOne ClawScan

SKILL.md 节选

> **说明**：本 Skill 由腾讯朱雀实验室出品，一键全面扫描 OpenClaw 不安全配置、恶意 Skill 与漏洞。  
> **关于云端 API**：供应链与 CVE 情报需要持续更新，仅靠本地静态文件无法覆盖「安装后被篡改的技能」与「每日新增的漏洞库」；因此默认会向 A.I.G 发起**最小化**查询（仅 skill 名+来源标签、以及 OpenClaw 版本号），**不会**上传 Skill 源码、对话或工作区文件。若策略不允许任何外联，请设置 `AIG_CLOUD_LOOKUP=off` 做纯本地扫描，或把 `AIG_BASE_URL` 指向自建实例。  
> 安装前请对照官方仓库核验来源；集市「所有者」字段可能与本文 `author` 不一致，不代表密码学意义上的发布者证明。

---
# edgeone-clawscan 

OpenClaw security scanning powered by AI-Infra-Guard ( https://github.com/Tencent/AI-Infra-Guard ).

## Configuration

`AIG_BASE_URL` (optional) — base URL for the AI-Infra-Guard API.
Defaults to `https://matrix.tencent.com/clawscan` (the public Tencent endpoint
declared in the `external_requests` metadata above).

**Privacy / air-gapped environments**: to avoid sending skill names, source
labels, or version strings to the public Tencent host, use one of: (1)
`AIG_BASE_URL` pointing at a self-hosted AI-Infra-Guard you operate, or (2)
`AIG_CLOUD_LOOKUP=off` so **no** A.I.G HTTPS request runs (fully local Step 2
and Step 3). Curl uses
`${AIG_BASE_URL:-https://matrix.tencent.com/clawscan}` only when cloud lookup
is enabled.

```bash
export AIG_BASE_URL=https://your-self-hosted-aig.example.com/clawscan
export AIG_CLOUD_LOOKUP=off
```

## Security Declaration

This section is an upfront disclosure of every network action and live probe
this skill performs. Auditors and end users should read this section before
installation or execution against production data.

### Pre-run Safety Checklist

| # | Check | Action |
|---|-------|--------|
| 1 | **Publisher vs registry** | `author` here may not match marketplace "owner" text — see YAML `provenance.registry_metadata_caveat`. Verify against `official_repo` before trusting cloud verdicts. |
| 2 | **Binary on PATH** | `which openclaw` must resolve to the intended OpenClaw build. |
| 3 | **Outbound policy** | Default sends minimal metadata to Tencent A.I.G (tables below). For zero outbound: `AIG_CLOUD_LOOKUP=off`. For your own infra only: self-hosted `AIG_BASE_URL`. |
| 4 | **Live probe** | `--deep` hits the local Gateway config; avoid production until exposure is reviewed. |

### Why the A.I.G API Is Necessary (technical)

The API is not optional telemetry for analytics. It supplies two signals that an
offline skill **cannot** keep current or complete on its own:

| Need | Local-only gap | API role |
|------|----------------|----------|
| **Supply-chain risk** | Disk code and registry metadata can change after install; no bundled file can mirror a global, hourly-updated malicious-skill list. | Query by `skill_name` + `source` → verdict from maintained threat intel (analogous to cloud AV signatures). |
| **CVE/GHSA currency** | Embedding a full advisory DB in `SKILL.md` would be huge and **stale on day one**. | Query by fixed `OpenClaw` + **detected version** → advisories for that build. |

If the API is disabled or unreachable, the workflow **still completes**: Step 2
uses local audit; Step 3 omits online CVE matching and states that explicitly.

### What the API is not (addresses "data leak" flags)

Scanners may treat "default Tencent URL" as exfiltration risk. This skill sends
only the fields in the table below. It does **not** upload skill bodies, user
chats, workspace files, env secrets, or Gateway message payloads.

| Sent (cloud on) | Not sent |
|-----------------|----------|
| `skill_name`, `source` label | `SKILL.md` text, scripts, arbitrary URLs |
| literal `OpenClaw` + version string | prompts, transcripts, credentials |

This is **declared threat-intel and advisory lookup**. If policy rejects even
that metadata leaving the machine, set `AIG_CLOUD_LOOKUP=off` before any scan.

SKILL.md 不止这些内容，安装后可阅读全文。

技能包内容

共 3 个文件，合计 48.0 KiB