Appearance
OpenClaw 威胁模型 v1.0
MITRE ATLAS 框架
版本: 1.0-draft 最后更新: 2026-02-04 方法论: MITRE ATLAS + 数据流图 框架: MITRE ATLAS(AI 系统对抗威胁态势)
框架说明
本威胁模型基于 MITRE ATLAS 构建,这是记录 AI/ML 系统对抗威胁的行业标准框架,由 MITRE 与 AI 安全社区联合维护。
ATLAS 关键资源:
参与贡献本威胁模型
这是一份由 OpenClaw 社区维护的活文档。贡献指南请见 CONTRIBUTING-THREAT-MODEL.md:
- 报告新威胁
- 更新已有威胁
- 提出攻击链
- 建议缓解措施
1. 简介
1.1 目的
本威胁模型使用专为 AI/ML 系统设计的 MITRE ATLAS 框架,记录针对 OpenClaw AI 智能体平台和 ClawHub 技能市场的对抗威胁。
1.2 范围
| 组件 | 纳入 | 备注 |
|---|---|---|
| OpenClaw 智能体运行时 | 是 | 核心智能体执行、工具调用、会话 |
| Gateway | 是 | 认证、路由、频道集成 |
| 频道集成 | 是 | WhatsApp、Telegram、Discord、Signal、Slack 等 |
| ClawHub 市场 | 是 | 技能发布、审核、分发 |
| MCP 服务器 | 是 | 外部工具提供商 |
| 用户设备 | 部分 | 移动端应用、桌面客户端 |
1.3 范围外
本威胁模型没有明确排除的内容。
2. 系统架构
2.1 信任边界
┌─────────────────────────────────────────────────────────────────┐
│ 非信任区域 │
│ ┌─────────────┐ ┌─────────────┐ ┌─────────────┐ │
│ │ WhatsApp │ │ Telegram │ │ Discord │ ... │
│ └──────┬──────┘ └──────┬──────┘ └──────┬──────┘ │
│ │ │ │ │
└─────────┼────────────────┼────────────────┼──────────────────────┘
│ │ │
▼ ▼ ▼
┌─────────────────────────────────────────────────────────────────┐
│ 信任边界 1:频道访问 │
│ ┌──────────────────────────────────────────────────────────┐ │
│ │ GATEWAY │ │
│ │ • 设备配对(30秒宽限期) │ │
│ │ • AllowFrom / AllowList 验证 │ │
│ │ • Token/密码/Tailscale 认证 │ │
│ └──────────────────────────────────────────────────────────┘ │
└─────────────────────────────────────────────────────────────────┘
│
▼
┌─────────────────────────────────────────────────────────────────┐
│ 信任边界 2:会话隔离 │
│ ┌──────────────────────────────────────────────────────────┐ │
│ │ 智能体会话 │ │
│ │ • 会话密钥 = agent:channel:peer │ │
│ │ • 每个智能体的工具策略 │ │
│ │ • 对话记录日志 │ │
│ └──────────────────────────────────────────────────────────┘ │
└─────────────────────────────────────────────────────────────────┘
│
▼
┌─────────────────────────────────────────────────────────────────┐
│ 信任边界 3:工具执行 │
│ ┌──────────────────────────────────────────────────────────┐ │
│ │ 执行沙箱 │ │
│ │ • Docker 沙箱 或 宿主机(exec-approvals) │ │
│ │ • Node 远程执行 │ │
│ │ • SSRF 防护(DNS 固定 + IP 封锁) │ │
│ └──────────────────────────────────────────────────────────┘ │
└─────────────────────────────────────────────────────────────────┘
│
▼
┌─────────────────────────────────────────────────────────────────┐
│ 信任边界 4:外部内容 │
│ ┌──────────────────────────────────────────────────────────┐ │
│ │ 抓取的 URL / 邮件 / Webhooks │ │
│ │ • 外部内容包装(XML 标签) │ │
│ │ • 安全提示注入 │ │
│ └──────────────────────────────────────────────────────────┘ │
└─────────────────────────────────────────────────────────────────┘
│
▼
┌─────────────────────────────────────────────────────────────────┐
│ 信任边界 5:供应链 │
│ ┌──────────────────────────────────────────────────────────┐ │
│ │ CLAWHUB │ │
│ │ • 技能发布(semver、SKILL.md 必填) │ │
│ │ • 基于规则的审核标记 │ │
│ │ • VirusTotal 扫描(即将推出) │ │
│ │ • GitHub 账户年龄验证 │ │
│ └──────────────────────────────────────────────────────────┘ │
└─────────────────────────────────────────────────────────────────┘2.2 数据流
| 流 | 来源 | 目标 | 数据 | 保护措施 |
|---|---|---|---|---|
| F1 | 频道 | Gateway | 用户消息 | TLS、AllowFrom |
| F2 | Gateway | 智能体 | 路由消息 | 会话隔离 |
| F3 | 智能体 | 工具 | 工具调用 | 策略执行 |
| F4 | 智能体 | 外部 | web_fetch 请求 | SSRF 封锁 |
| F5 | ClawHub | 智能体 | 技能代码 | 审核、扫描 |
| F6 | 智能体 | 频道 | 响应内容 | 输出过滤 |
3. 按 ATLAS 战术的威胁分析
3.1 侦察(AML.TA0002)
T-RECON-001:智能体端点发现
| 属性 | 值 |
|---|---|
| ATLAS ID | AML.T0006 - 主动扫描 |
| 描述 | 攻击者扫描暴露的 OpenClaw gateway 端点 |
| 攻击向量 | 网络扫描、shodan 查询、DNS 枚举 |
| 受影响组件 | Gateway、暴露的 API 端点 |
| 当前缓解措施 | Tailscale 认证选项,默认绑定到回环地址 |
| 残余风险 | 中 - 公共 Gateway 可被发现 |
| 建议 | 记录安全部署文档,在发现端点上添加速率限制 |
T-RECON-002:频道集成探测
| 属性 | 值 |
|---|---|
| ATLAS ID | AML.T0006 - 主动扫描 |
| 描述 | 攻击者探测消息频道以识别 AI 托管账户 |
| 攻击向量 | 发送测试消息、观察响应模式 |
| 受影响组件 | 所有频道集成 |
| 当前缓解措施 | 无特定措施 |
| 残余风险 | 低 - 仅发现的价值有限 |
| 建议 | 考虑响应时间随机化 |
3.2 初始访问(AML.TA0004)
T-ACCESS-001:配对码拦截
| 属性 | 值 |
|---|---|
| ATLAS ID | AML.T0040 - AI 模型推理 API 访问 |
| 描述 | 攻击者在 30 秒宽限期内拦截配对码 |
| 攻击向量 | 偷窥、网络嗅探、社会工程学 |
| 受影响组件 | 设备配对系统 |
| 当前缓解措施 | 30 秒过期,码通过现有频道发送 |
| 残余风险 | 中 - 宽限期可被利用 |
| 建议 | 缩短宽限期,添加确认步骤 |
T-ACCESS-002:AllowFrom 欺骗
| 属性 | 值 |
|---|---|
| ATLAS ID | AML.T0040 - AI 模型推理 API 访问 |
| 描述 | 攻击者在频道中伪造允许的发送者身份 |
| 攻击向量 | 取决于频道 - 电话号码欺骗、用户名冒充 |
| 受影响组件 | 每个频道的 AllowFrom 验证 |
| 当前缓解措施 | 频道特定身份验证 |
| 残余风险 | 中 - 部分频道易受欺骗 |
| 建议 | 记录频道特定风险,在可能的地方添加加密验证 |
T-ACCESS-003:Token 盗取
| 属性 | 值 |
|---|---|
| ATLAS ID | AML.T0040 - AI 模型推理 API 访问 |
| 描述 | 攻击者从配置文件中盗取认证 token |
| 攻击向量 | 恶意软件、未授权设备访问、配置备份泄露 |
| 受影响组件 | ~/.openclaw/credentials/、配置存储 |
| 当前缓解措施 | 文件权限 |
| 残余风险 | 高 - Token 以明文存储 |
| 建议 | 实现静态 token 加密,添加 token 轮换 |
3.3 执行(AML.TA0005)
T-EXEC-001:直接提示注入
| 属性 | 值 |
|---|---|
| ATLAS ID | AML.T0051.000 - LLM 提示注入:直接 |
| 描述 | 攻击者发送精心构造的提示以操控智能体行为 |
| 攻击向量 | 包含对抗性指令的频道消息 |
| 受影响组件 | 智能体 LLM、所有输入面 |
| 当前缓解措施 | 模式检测、外部内容包装 |
| 残余风险 | 严重 - 仅检测,不拦截;复杂攻击可绕过 |
| 建议 | 实现多层防御、输出验证、敏感操作需用户确认 |
T-EXEC-002:间接提示注入
| 属性 | 值 |
|---|---|
| ATLAS ID | AML.T0051.001 - LLM 提示注入:间接 |
| 描述 | 攻击者在抓取内容中嵌入恶意指令 |
| 攻击向量 | 恶意 URL、投毒邮件、被攻陷的 webhook |
| 受影响组件 | web_fetch、邮件摄取、外部数据源 |
| 当前缓解措施 | 使用 XML 标签和安全通知进行内容包装 |
| 残余风险 | 高 - LLM 可能忽略包装指令 |
| 建议 | 实现内容清洗、独立执行上下文 |
T-EXEC-003:工具参数注入
| 属性 | 值 |
|---|---|
| ATLAS ID | AML.T0051.000 - LLM 提示注入:直接 |
| 描述 | 攻击者通过提示注入操控工具参数 |
| 攻击向量 | 影响工具参数值的精心构造提示 |
| 受影响组件 | 所有工具调用 |
| 当前缓解措施 | 危险命令的 exec approvals |
| 残余风险 | 高 - 依赖用户判断 |
| 建议 | 实现参数验证、参数化工具调用 |
T-EXEC-004:Exec 审批绕过
| 属性 | 值 |
|---|---|
| ATLAS ID | AML.T0043 - 构造对抗性数据 |
| 描述 | 攻击者构造绕过审批白名单的命令 |
| 攻击向量 | 命令混淆、别名利用、路径操控 |
| 受影响组件 | exec-approvals.ts、命令白名单 |
| 当前缓解措施 | 白名单 + ask 模式 |
| 残余风险 | 高 - 无命令清洗 |
| 建议 | 实现命令规范化、扩展黑名单 |
3.4 持久化(AML.TA0006)
T-PERSIST-001:恶意技能安装
| 属性 | 值 |
|---|---|
| ATLAS ID | AML.T0010.001 - 供应链入侵:AI 软件 |
| 描述 | 攻击者向 ClawHub 发布恶意技能 |
| 攻击向量 | 创建账户,发布含隐藏恶意代码的技能 |
| 受影响组件 | ClawHub、技能加载、智能体执行 |
| 当前缓解措施 | GitHub 账户年龄验证、基于模式的审核标记 |
| 残余风险 | 严重 - 无沙箱,审核有限 |
| 建议 | VirusTotal 集成(进行中)、技能沙箱、社区审核 |
T-PERSIST-002:技能更新投毒
| 属性 | 值 |
|---|---|
| ATLAS ID | AML.T0010.001 - 供应链入侵:AI 软件 |
| 描述 | 攻击者入侵热门技能并推送恶意更新 |
| 攻击向量 | 账户入侵、对技能所有者的社会工程学 |
| 受影响组件 | ClawHub 版本管理、自动更新流程 |
| 当前缓解措施 | 版本指纹 |
| 残余风险 | 高 - 自动更新可能拉取恶意版本 |
| 建议 | 实现更新签名、回滚能力、版本固定 |
T-PERSIST-003:智能体配置篡改
| 属性 | 值 |
|---|---|
| ATLAS ID | AML.T0010.002 - 供应链入侵:数据 |
| 描述 | 攻击者修改智能体配置以持久保持访问 |
| 攻击向量 | 配置文件修改、设置注入 |
| 受影响组件 | 智能体配置、工具策略 |
| 当前缓解措施 | 文件权限 |
| 残余风险 | 中 - 需要本地访问 |
| 建议 | 配置完整性验证、配置变更审计日志 |
3.5 防御规避(AML.TA0007)
T-EVADE-001:审核模式绕过
| 属性 | 值 |
|---|---|
| ATLAS ID | AML.T0043 - 构造对抗性数据 |
| 描述 | 攻击者构造技能内容以规避审核模式 |
| 攻击向量 | Unicode 同形异义字、编码技巧、动态加载 |
| 受影响组件 | ClawHub moderation.ts |
| 当前缓解措施 | 基于模式的 FLAG_RULES |
| 残余风险 | 高 - 简单正则很容易被绕过 |
| 建议 | 添加行为分析(VirusTotal Code Insight)、基于 AST 的检测 |
T-EVADE-002:内容包装逃逸
| 属性 | 值 |
|---|---|
| ATLAS ID | AML.T0043 - 构造对抗性数据 |
| 描述 | 攻击者构造内容以逃脱 XML 包装上下文 |
| 攻击向量 | 标签操控、上下文混淆、指令覆盖 |
| 受影响组件 | 外部内容包装 |
| 当前缓解措施 | XML 标签 + 安全通知 |
| 残余风险 | 中 - 新型逃逸方法定期被发现 |
| 建议 | 多层包装、输出侧验证 |
3.6 发现(AML.TA0008)
T-DISC-001:工具枚举
| 属性 | 值 |
|---|---|
| ATLAS ID | AML.T0040 - AI 模型推理 API 访问 |
| 描述 | 攻击者通过提示枚举可用工具 |
| 攻击向量 | "你有哪些工具?"类型的查询 |
| 受影响组件 | 智能体工具注册表 |
| 当前缓解措施 | 无特定措施 |
| 残余风险 | 低 - 工具通常已记录在文档中 |
| 建议 | 考虑工具可见性控制 |
T-DISC-002:会话数据提取
| 属性 | 值 |
|---|---|
| ATLAS ID | AML.T0040 - AI 模型推理 API 访问 |
| 描述 | 攻击者从会话上下文中提取敏感数据 |
| 攻击向量 | "我们讨论过什么?"查询、上下文探测 |
| 受影响组件 | 会话记录、上下文窗口 |
| 当前缓解措施 | 按发送者隔离会话 |
| 残余风险 | 中 - 会话内数据可访问 |
| 建议 | 在上下文中实现敏感数据编辑 |
3.7 收集与外泄(AML.TA0009, AML.TA0010)
T-EXFIL-001:通过 web_fetch 数据盗取
| 属性 | 值 |
|---|---|
| ATLAS ID | AML.T0009 - 收集 |
| 描述 | 攻击者通过指示智能体发送数据到外部 URL 来外泄数据 |
| 攻击向量 | 提示注入导致智能体向攻击者服务器 POST 数据 |
| 受影响组件 | web_fetch 工具 |
| 当前缓解措施 | 内网 SSRF 封锁 |
| 残余风险 | 高 - 允许外部 URL |
| 建议 | 实现 URL 白名单、数据分类意识 |
T-EXFIL-002:未授权消息发送
| 属性 | 值 |
|---|---|
| ATLAS ID | AML.T0009 - 收集 |
| 描述 | 攻击者导致智能体发送含敏感数据的消息 |
| 攻击向量 | 提示注入导致智能体向攻击者发消息 |
| 受影响组件 | 消息工具、频道集成 |
| 当前缓解措施 | 出站消息门控 |
| 残余风险 | 中 - 门控可能被绕过 |
| 建议 | 要求对新收件人明确确认 |
T-EXFIL-003:凭证收割
| 属性 | 值 |
|---|---|
| ATLAS ID | AML.T0009 - 收集 |
| 描述 | 恶意技能从智能体上下文中收割凭证 |
| 攻击向量 | 技能代码读取环境变量、配置文件 |
| 受影响组件 | 技能执行环境 |
| 当前缓解措施 | 技能层面无特定措施 |
| 残余风险 | 严重 - 技能以智能体权限运行 |
| 建议 | 技能沙箱、凭证隔离 |
3.8 影响(AML.TA0011)
T-IMPACT-001:未授权命令执行
| 属性 | 值 |
|---|---|
| ATLAS ID | AML.T0031 - 侵蚀 AI 模型完整性 |
| 描述 | 攻击者在用户系统上执行任意命令 |
| 攻击向量 | 提示注入结合 exec 审批绕过 |
| 受影响组件 | Bash 工具、命令执行 |
| 当前缓解措施 | Exec approvals、Docker 沙箱选项 |
| 残余风险 | 严重 - 无沙箱的宿主机执行 |
| 建议 | 默认使用沙箱,改善审批 UX |
T-IMPACT-002:资源耗尽(DoS)
| 属性 | 值 |
|---|---|
| ATLAS ID | AML.T0031 - 侵蚀 AI 模型完整性 |
| 描述 | 攻击者耗尽 API 额度或计算资源 |
| 攻击向量 | 自动化消息洪水、昂贵的工具调用 |
| 受影响组件 | Gateway、智能体会话、API 提供商 |
| 当前缓解措施 | 无 |
| 残余风险 | 高 - 无速率限制 |
| 建议 | 实现每发送者速率限制、费用预算 |
T-IMPACT-003:声誉损害
| 属性 | 值 |
|---|---|
| ATLAS ID | AML.T0031 - 侵蚀 AI 模型完整性 |
| 描述 | 攻击者导致智能体发送有害/冒犯性内容 |
| 攻击向量 | 提示注入导致不当响应 |
| 受影响组件 | 输出生成、频道消息 |
| 当前缓解措施 | LLM 提供商内容策略 |
| 残余风险 | 中 - 提供商过滤不完善 |
| 建议 | 输出过滤层、用户控制 |
4. ClawHub 供应链分析
4.1 当前安全控制
| 控制 | 实现 | 有效性 |
|---|---|---|
| GitHub 账户年龄 | requireGitHubAccountAge() | 中 - 提高新攻击者的门槛 |
| 路径清洗 | sanitizePath() | 高 - 防止路径遍历 |
| 文件类型验证 | isTextFile() | 中 - 仅文本文件,但仍可能是恶意的 |
| 大小限制 | 50MB 总包大小 | 高 - 防止资源耗尽 |
| 必填 SKILL.md | 必填自述文件 | 安全价值低 - 仅信息性 |
| 模式审核 | moderation.ts 中的 FLAG_RULES | 低 - 容易被绕过 |
| 审核状态 | moderationStatus 字段 | 中 - 可人工审核 |
4.2 审核标记模式
moderation.ts 中的当前模式:
javascript
// 已知恶意标识符
/(keepcold131\/ClawdAuthenticatorTool|ClawdAuthenticatorTool)/i
// 可疑关键词
/(malware|stealer|phish|phishing|keylogger)/i
/(api[-_ ]?key|token|password|private key|secret)/i
/(wallet|seed phrase|mnemonic|crypto)/i
/(discord\.gg|webhook|hooks\.slack)/i
/(curl[^\n]+\|\s*(sh|bash))/i
/(bit\.ly|tinyurl\.com|t\.co|goo\.gl|is\.gd)/i局限性:
- 仅检查 slug、displayName、summary、frontmatter、metadata、文件路径
- 不分析实际技能代码内容
- 简单正则容易通过混淆绕过
- 无行为分析
4.3 计划中的改进
| 改进 | 状态 | 影响 |
|---|---|---|
| VirusTotal 集成 | 进行中 | 高 - Code Insight 行为分析 |
| 社区举报 | 部分(skillReports 表已存在) | 中 |
| 审计日志 | 部分(auditLogs 表已存在) | 中 |
| 徽章系统 | 已实现 | 中 - highlighted、official、deprecated、redactionApproved |
5. 风险矩阵
5.1 可能性 vs 影响
| 威胁 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:基于技能的数据盗取
T-PERSIST-001 → T-EVADE-001 → T-EXFIL-003
(发布恶意技能)→(规避审核)→(收割凭证)攻击链 2:提示注入到 RCE
T-EXEC-001 → T-EXEC-004 → T-IMPACT-001
(注入提示)→(绕过 exec 审批)→(执行命令)攻击链 3:通过抓取内容的间接注入
T-EXEC-002 → T-EXFIL-001 → 外部外泄
(投毒 URL 内容)→(智能体抓取并执行指令)→(数据发送给攻击者)6. 建议摘要
6.1 立即处理(P0)
| ID | 建议 | 解决的威胁 |
|---|---|---|
| R-001 | 完成 VirusTotal 集成 | T-PERSIST-001, T-EVADE-001 |
| 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 | 添加静态 token 加密 | T-ACCESS-003 |
| R-006 | 改善 exec 审批 UX 和验证 | T-EXEC-004 |
| R-007 | 为 web_fetch 实现 URL 白名单 | T-EXFIL-001 |
6.3 中期(P2)
| ID | 建议 | 解决的威胁 |
|---|---|---|
| R-008 | 在可能的地方添加加密频道验证 | 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 | Gateway 认证 | 严重 |
src/web/inbound/access-control.ts | 频道访问控制 | 严重 |
src/infra/net/ssrf.ts | SSRF 防护 | 严重 |
src/security/external-content.ts | 提示注入缓解 | 严重 |
src/agents/sandbox/tool-policy.ts | 工具策略执行 | 严重 |
convex/lib/moderation.ts | ClawHub 审核 | 高 |
convex/lib/skillPublish.ts | 技能发布流程 | 高 |
src/routing/resolve-route.ts | 会话隔离 | 中 |
7.3 术语表
| 术语 | 定义 |
|---|---|
| ATLAS | MITRE 的 AI 系统对抗威胁态势 |
| ClawHub | OpenClaw 的技能市场 |
| Gateway | OpenClaw 的消息路由和认证层 |
| MCP | Model Context Protocol - 工具提供商接口 |
| 提示注入 | 恶意指令嵌入输入的攻击 |
| Skill | OpenClaw 智能体的可下载扩展 |
| SSRF | 服务器端请求伪造 |
本威胁模型是活文档。安全问题请报告至 security@openclaw.ai