edgeone-clawscan-zh

Files (1)

• SKILL.md

SKILL.md (first lines)

# EdgeOne ClawScan

由 AI-Infra-Guard 驱动的 OpenClaw 安全扫描技能 ( https://github.com/Tencent/AI-Infra-Guard )。

## 配置

将 `AIG_BASE_URL` 设置为您的 AI-Infra-Guard 实例地址（默认值：`https://matrix.tencent.com/clawscan`）。

## 隐私与外部服务声明

本技能仅出于以下两个特定目的，向 AIG 云服务（`matrix.tencent.com/clawscan`）发起 HTTPS 请求：

| 请求 | 发送的数据 | 不发送的数据 |
|---------|-----------|---------------|
| 供应链查询（步骤 2） | 技能名称和来源标签（如 `clawhub`） | 不发送任何文件内容、凭证或个人数据 |
| CVE 公告查询（步骤 3） | 固定字符串 `OpenClaw` 和版本号 | 不发送任何文件内容、凭证或个人数据 |

其余所有检查（步骤 1 内建审计和步骤 4 隐私自评估）**完全在本地运行**。  
本技能不会向任何外部服务发送文件内容、凭证、环境变量、会话记录或个人数据。

---

## 触发边界

本技能触发后，首先对请求进行分类并保持工作流聚焦：

- 当用户明确要求对当前 OpenClaw 环境进行安全体检或安全扫描时，执行 **功能 1：OpenClaw 安全扫描**，包括但不限于以下表述：`开始安全体检`、`做一次安全体检`、`开始安全扫描`、`做一次全面安全检查` 或 `给 OpenClaw 做安全体检`。
- 当用户询问某个技能是否安全、需要进行安装前安全检查或审查一个或多个已安装技能时，执行 **功能 2：技能安全扫描**。

不要将 `openclaw`、`clawdbot`、依赖安装、项目调试或正常开发任务等一般性提及视为运行本技能的理由。

---

## 两大核心功能

| 功能 | 描述 | 适用场景 |
|---------|-------------|-------------|
| **OpenClaw 安全扫描** | 完整的系统安全审计（4 个步骤） | 用户明确要求对 OpenClaw 进行全面安全扫描 |
| **技能安全扫描** | 单个技能的安全检测 | 用户询问特定技能安全性、安装前审查或已安装技能审计 |

---

# 功能 1：OpenClaw 安全扫描

对整个 OpenClaw 环境执行全面安全审计。静默执行所有 4 个步骤，最终生成一份统一报告。

## 步骤 1：内建安全审计

运行 OpenClaw 内建安全审计命令：

```bash
openclaw security audit --deep
```

此命令会标记常见的安全隐患，包括：
- Gateway 鉴权与网络暴露
- 工具影响范围与高风险开放房间访问
- 浏览器控制或远程执行暴露
- 文件系统权限与安全配置错误

使用 `--deep` 运行时，还会尝试对本地 Gateway 进行一次尽力而为的实时探测。

将步骤 1 中的所有内建审计结果视为**配置风险提示**。  
不要将任何单个内建审计结果直接映射为 `🔴 高危`；应将其视为值得关注和优化的风险点，而非正在发生的严重攻击证据。

在撰写 **步骤 1：配置审计** 时，仅分析：
- `openclaw security audit --deep` 输出的审计结果

不要混入：
- 属于步骤 2 的技能供应链发现
- 属于步骤 2 的本地技能代码审计结果
- 属于步骤 3 的 CVE 或 GHSA 版本公告
- 属于步骤 4 的隐私自评估结论

在最终报告的步骤 1 摘要中：
- 使用直白的语言，聚焦于"存在什么风险"和"如何缩小风险范围"，避免使用"高危"或"严重漏洞"等可能被误解为已确认严重事件的标签。
- 即使某项配置看起来令人担忧，也优先使用"当前配置存在 X 风险，建议调整 Y"等表述，使重点保持在"什么有风险"和"如何更安全"上，而不是贴上吓人的严重性标签。

## 步骤 2：供应链风险检测

扫描所有已安装技能的供应链风险。

### 容错规则

云端威胁情报仅为尽力而为，不得阻塞扫描流程。

- 如果 AIG API 请求超时、失败、返回非 200 状态码、返回空内容或无效 JSON，应将云端结果视为不可用，而非安全。
- 当云端查询不可用时，继续对该技能进行本地审计。
- 一个技能的云端查询失败不得阻止对其他技能的检查。
- 本地和 GitHub 来源的技能应默认走本地审计流程，除非有可靠的托管目录结果。


### 2.1 获取已安装技能列表

```bash
openclaw skills list
```

### 2.2 对每个技能查询 AIG API

> **发送的数据**：仅发送 `skill_name`（技能的注册名称）和 `source`（来源标签，如 `clawhub`）。  
> 不发送任何文件内容、凭证或个人数据。

```bash
curl -s "https://matrix.tencent.com/clawscan/skill_security?skill_name=SKILL_NAME&source=SOURCE"
```

**API 详情：**
- **URL**：`GET /clawscan/skill_security`
- **参数**：
    - `skill_name`（字符串，必填）：技能名称
    - `source`（字符串，必填）：技能来源（如 `clawhub`、`local`、`github`）
- **响应字段**：
    - `verdict`：`safe` / `malicious` / `risky` / `unknown`
    - `reason`：解释说明（当结果为 `malicious` 或 `risky` 时提供）

### 2.3 处理判定结果

| 条件 | 处理方式 |

From L-LesterYu/OpenClaw-hot-skills-zh, MIT.

More from L-LesterYu/OpenClaw-hot-skills-zh