本页内容
本页内容
安全
威胁模型(MITRE ATLAS)
版本: 1.0-draft | 框架: MITRE ATLAS(针对 AI 系统的对抗性威胁环境)+ 数据流图
本文档记录了针对 OpenClaw AI 代理平台和 ClawHub 技能市场的对抗性威胁。这是一份由 OpenClaw 社区维护的动态文档。有关如何报告新威胁、提出攻击链或建议缓解措施,请参阅 为威胁模型做贡献。
ATLAS 关键资源: ATLAS 网站 | ATLAS 数据和贡献指南
1. 范围
| 组件 | 包含 | 笔记 |
|---|---|---|
| OpenClaw 代理运行时 | 是 | 核心代理执行、工具调用、会话 |
| 网关 | 是 | 身份验证、路由、通道集成 |
| 渠道整合 | 是 | WhatsApp、Telegram、Discord、Signal、Slack 等 |
| ClawHub 市场 | 是 | 技能发布、审核、分发 |
| MCP 服务器 | 是 | 外部工具提供方 |
| 用户设备 | 部分支持 | 移动应用、桌面客户端 |
超出范围的报告和误报模式(公开互联网暴露、仅含提示注入且没有边界绕过的链路、在同一 gateway 主机上共享的互不信任操作者,以及其他情况)已在 SECURITY.md 中列出;该文件是漏洞报告范围的当前权威来源,而不是本页面。
2. 系统架构
2.1 信任边界
2.2 数据流
| 流程 | 来源 | 目标 | 数据 | 防护 |
|---|---|---|---|---|
| F1 | 渠道 | 网关 | 用户消息 | TLS, AllowFrom |
| F2 | 网关 | 代理 | 路由后的消息 | 会话隔离 |
| F3 | 代理 | 工具 | 工具调用 | 策略执行 |
| F4 | 代理 | 外部 | web_fetch 请求 |
SSRF 阻断 |
| F5 | ClawHub | 代理 | 技能代码 | 审核,扫描 |
| F6 | 代理 | 渠道 | 响应 | 输出过滤 |
3. 基于 ATLAS 战术的威胁分析
威胁目录按 ATLAS 策略进行划分。下面的每一页都包含该策略中每个威胁的完整属性表。第 5 节中的风险矩阵和第 6 节中的建议摘要对所有内容进行索引,7.1 节中的 ATLAS 技术映射列出了哪些威胁实施了每种技术。
| ATLAS战术 | 威胁 | 页面 |
|---|---|---|
| 侦察(AML.TA0002) | T-RECON-001, T-RECON-002 | 侦察 |
| 初始访问(AML.TA0004) | T-ACCESS-001, T-ACCESS-002, T-ACCESS-003 | 初始访问 |
| 执行(AML.TA0005) | T-EXEC-001, T-EXEC-002, T-EXEC-003, T-EXEC-004 | 执行 |
| 持久性 (AML.TA0006) | T-PERSIST-001, T-PERSIST-002, T-PERSIST-003 | 持久性 |
| 防御规避(AML.TA0007) | T-EVADE-001, T-EVADE-002 | 防御规避 |
| 发现 (AML.TA0008) | T-DISC-001, T-DISC-002 | 发现 |
| 收集和渗漏(AML.TA0009、AML.TA0010) | T-EXFIL-001, T-EXFIL-002, T-EXFIL-003 | 收集与渗漏 |
| 影响(AML.TA0011) | T-IMPACT-001, T-IMPACT-002, T-IMPACT-003 | 影响 |
4. ClawHub 供应链分析
4.1 当前安全控制
| Control | 执行 | 效力 |
|---|---|---|
| GitHub 账号年龄 | requireGitHubAccountAge()(至少 14 天) |
中等 - 提高新攻击者的门槛 |
| 路径清理 | sanitizePath() |
高 - 防止路径穿越 |
| 文件类型验证 | isTextFile() |
中等 - 仅扫描文本文件,但仍可被利用 |
| 大小限制 | 50MB 总 bundle(MAX_PUBLISH_TOTAL_BYTES) |
高 - 防止资源耗尽 |
| 必需的 SKILL.md | 发布时强制要求的说明文件 | 低安全价值 - 仅用于信息说明 |
| 静态+AST-相邻扫描 | 模式引擎涵盖执行、渗透、凭证收集、混淆等 | 中-高 - 涵盖许多已知的滥用模式,仍然基于模式 |
| 基于LLM-的代理风险审查 | 安全提示驱动的发布判决 | 中-高 - 捕捉错过的行为静态模式 |
| VirusTotal 扫描 | 连接到技能和包发布 publish/rescan 流,通过操作员 API 密钥进行门控 | 启用时为高 - 静态引擎检测 |
| 审核状态 | moderationStatus 字段 |
中等 - 可进行人工复核 |
4.2 审核限制
ClawHub 的静态扫描会直接检查 skill 代码内容(不仅仅是 slug/metadata/frontmatter),覆盖危险的 exec 调用、动态代码执行、凭据收集、外传模式、混淆载荷等。已知缺口包括:
- 基于模式的检测仍可能被足够新颖的混淆方式绕过。
- 基于 LLM- 的审查和 VirusTotal 扫描取决于操作员端 API keys/config 的启用。
- 一旦安装后,没有运行时执行沙箱能将 skill 与代理自身的权限隔离开来。
4.3 徽章
Skills 和 packages 会带有由审核员分配的徽章:highlighted、official、deprecated、redactionApproved(仅 skills)。社区举报(skillReports)和审计日志(auditLogs)支持审核工作流。
5. 风险矩阵
5.1 发生可能性与影响
| 威胁 ID | 发生可能性 | 影响 | 风险等级 | 优先级 |
|---|---|---|---|---|
| T-EXEC-001 | 高 | 严重 | 严重 | P0 |
| T-PERSIST-001 | 高 | 严重 | 严重 | P0 |
| T-EXFIL-003 | 中 | 严重 | 严重 | P0 |
| T-IMPACT-001 | 中 | 严重 | 高 | P1 |
| T-EXEC-002 | 高 | 高 | 高 | P1 |
| T-EXEC-004 | 中 | 高 | 高 | P1 |
| T-ACCESS-003 | 中 | 高 | 高 | P1 |
| T-EXFIL-001 | 中 | 高 | 高 | P1 |
| T-IMPACT-002 | 高 | 中 | 高 | P1 |
| T-EVADE-001 | 高 | 中 | 中 | P2 |
| T-ACCESS-001 | 低 | 高 | 中 | P2 |
| T-ACCESS-002 | 低 | 高 | 中 | P2 |
| T-PERSIST-002 | 低 | 高 | 中 | P2 |
5.2 关键路径攻击链
链 1:基于技能的数据窃取
链 2:从 prompt 注入到 RCE
链 3:通过获取内容进行间接注入
6. 建议摘要
6.1 立即(P0)
| ID | 建议 | 涉及项 |
|---|---|---|
| R-002 | 实现技能执行沙箱化 | T-PERSIST-001, T-EXFIL-003 |
| R-003 | 为敏感操作添加输出校验 | T-EXEC-001, T-EXEC-002 |
6.2 短期(P1)
| ID | 建议 | 涉及项 |
|---|---|---|
| R-004 | 实现按发送者的速率限制 | T-IMPACT-002 |
| R-005 | 在静态存储时添加令牌加密 | T-ACCESS-003 |
| R-006 | 改进执行审批 UX 并继续扩展命令规范化 | T-EXEC-004 |
| R-007 | 为 web_fetch 实现 URL 白名单 |
T-EXFIL-001 |
6.3 中期(P2)
| ID | 建议 | 涉及项 |
|---|---|---|
| R-008 | 核心实施:分级标识符身份验证原语和审计结果;剩下的工作是每个通道 verified 的采用和下游强度映射器 |
T-ACCESS-002 |
| R-009 | 实现配置完整性验证 | T-PERSIST-003 |
| R-010 | 添加更新签名和版本固定 | T-PERSIST-002 |
7. 附录
7.1 ATLAS 技术映射
| ATLAS ID | 技术名称 | OpenClaw 威胁 |
|---|---|---|
| AML.T0006 | 主动扫描 | T-RECON-001, T-RECON-002 |
| AML.T0009 | 收集 | T-EXFIL-001, T-EXFIL-002, T-EXFIL-003 |
| AML.T0010.001 | 供应链:AI 软件 | T-PERSIST-001, T-PERSIST-002 |
| AML.T0010.002 | 供应链:数据 | T-PERSIST-003 |
| AML.T0031 | 侵蚀 AI 模型完整性 | T-IMPACT-001, T-IMPACT-002, T-IMPACT-003 |
| AML.T0040 | AI 模型推理 API 访问 | T-ACCESS-001, T-ACCESS-002, T-ACCESS-003, T-DISC-001, T-DISC-002 |
| AML.T0043 | 构造对抗性数据 | T-EXEC-004, T-EVADE-001, T-EVADE-002 |
| AML.T0051.000 | LLM 提示注入:直接 | T-EXEC-001, T-EXEC-003 |
| AML.T0051.001 | LLM 提示注入:间接 | T-EXEC-002 |
7.2 关键安全文件
| 路径 | 用途 | 风险等级 |
|---|---|---|
src/infra/exec-approvals.ts |
命令审批逻辑 | 严重 |
src/gateway/auth.ts |
网关身份验证 | 严重 |
src/infra/net/ssrf.ts |
SSRF 防护 | 严重 |
src/security/external-content.ts |
提示注入缓解 | 严重 |
src/agents/sandbox/tool-policy.ts |
沙箱工具allow/deny策略 | 严重 |
src/routing/resolve-route.ts |
会话隔离 / 路由 | 中 |
7.3 术语表
| 学期 | 定义 |
|---|---|
| ATLAS | MITRE 的 AI 系统对抗性威胁全景图 |
| ClawHub | OpenClaw 的技能市场 |
| 网关 | OpenClaw 的消息路由和身份验证层 |
| MCP | 模型上下文协议 - 工具提供方接口 |
| 快速注入 | 将恶意指令嵌入输入中的攻击 |
| 技能 | OpenClaw 代理可下载的扩展 |
| SSRF | 服务端请求伪造 |
这个威胁模型是一个动态文档。向 [email protected] 报告安全问题或查看 Trust page.
各部分移动的地方
先前单页版本中的每个标题都保留其锚点,因此现有链接(例如 /security/THREAT-MODEL-ATLAS#t-exec-002-indirect-prompt-injection)仍然可以解析。每个条目都指向现在保存内容的页面。
- 3.1 侦察 (AML.TA0002)
- T-RECON-001:代理端点发现
- T-RECON-002:渠道整合发现
- 3.2 初始访问 (AML.TA0004)
- T-ACCESS-001:配对码拦截
- T-ACCESS-002:AllowFrom 欺骗
- T-ACCESS-003:代币被盗
- 3.3 执行 (AML.TA0005)
- T-EXEC-001:直接提示注入
- T-EXEC-002:间接提示注入
- T-EXEC-003:工具参数注入
- T-EXEC-004:执行批准绕过
- 3.4 持久性 (AML.TA0006)
- T-PERSIST-001:恶意技能安装
- T-PERSIST-002:技能更新中毒
- T-PERSIST-003:代理配置篡改
- 3.5 防御规避 (AML.TA0007)
- T-EVADE-001:审核模式绕过
- T-EVADE-002:内容包装转义
- 3.6 发现 (AML.TA0008)
- T-DISC-001:工具枚举
- T-DISC-002:会话数据提取
- 3.7 收集和渗漏(AML.TA0009、AML.TA0010)
- T-EXFIL-001:通过web_fetch窃取数据
- T-EXFIL-002:未经授权的消息发送
- T-EXFIL-003:凭证收集
- 3.8 冲击 (AML.TA0011)
- T-IMPACT-001:未经授权的命令执行
- T-IMPACT-002:资源耗尽(DoS)
- T-IMPACT-003:声誉受损