Skip to main content

为 OpenClaw 威胁模型做贡献

感谢你帮助提升 OpenClaw 的安全性。这份威胁模型是一份持续更新的文档,我们欢迎任何人的贡献——你不需要是安全专家。

贡献方式

添加威胁

发现了我们未涵盖的攻击向量或风险?请在 openclaw/trust 上创建 issue,用你自己的话描述。你不需要了解任何框架或填写每个字段——只需描述场景即可。 提供以下信息会很有帮助(但不是必须的):
  • 攻击场景及其可能被利用的方式
  • OpenClaw 的哪些部分受到影响(CLI、Gateway、频道、ClawHub、MCP 服务器等)
  • 你认为的严重程度(低 / 中 / 高 / 严重)
  • 相关研究、CVE 或真实案例的链接
我们会在审查过程中处理 ATLAS 映射、威胁 ID 和风险评估。如果你想包含这些细节,很好——但这不是必需的。
这是用于添加到威胁模型的,不是用于报告实时漏洞。 如果你发现了可利用的漏洞,请参阅我们的信任页面获取负责任披露说明。

建议缓解措施

有关于如何应对现有威胁的想法?请创建 issue 或 PR 并引用该威胁。有用的缓解措施应该是具体且可操作的——例如,“在 Gateway 层实施每发送者 10 条消息/分钟的速率限制”比”实施速率限制”要好。

提出攻击链

攻击链展示了多个威胁如何组合成现实的攻击场景。如果你发现了危险的组合,请描述步骤以及攻击者如何将它们链接在一起。一个简短的攻击实际展开叙述比正式模板更有价值。

修复或改进现有内容

错字、澄清、过时信息、更好的示例——欢迎提交 PR,无需 issue。

我们使用的工具

MITRE ATLAS

这份威胁模型基于 MITRE ATLAS(AI 系统对抗性威胁态势)构建,这是一个专为 AI/ML 威胁(如提示注入、工具滥用和代理利用)设计的框架。你不需要了解 ATLAS 就能做贡献——我们会在审查过程中将提交映射到该框架。

威胁 ID

每个威胁都会获得一个类似 T-EXEC-003 的 ID。类别如下:
代码类别
RECON侦察 - 信息收集
ACCESS初始访问 - 获取入口
EXEC执行 - 运行恶意操作
PERSIST持久化 - 维持访问
EVADE防御规避 - 避免检测
DISC发现 - 了解环境
EXFIL数据窃取 - 盗取数据
IMPACT影响 - 破坏或中断
ID 由维护者在审查过程中分配。你不需要自己选择。

风险级别

级别含义
严重系统完全被攻陷,或高可能性 + 严重影响
可能造成重大损害,或中等可能性 + 严重影响
中等风险,或低可能性 + 高影响
不太可能发生且影响有限
如果你不确定风险级别,只需描述影响,我们会进行评估。

审查流程

  1. 分类 - 我们在 48 小时内审查新提交
  2. 评估 - 我们验证可行性,分配 ATLAS 映射和威胁 ID,验证风险级别
  3. 文档化 - 我们确保所有内容格式正确且完整
  4. 合并 - 添加到威胁模型和可视化中

资源

联系方式

  • 安全漏洞: 请参阅我们的信任页面获取报告说明
  • 威胁模型问题:openclaw/trust 上创建 issue
  • 一般交流: Discord #security 频道

认可

威胁模型的贡献者将在威胁模型致谢、发布说明以及 OpenClaw 安全名人堂中获得认可(针对重大贡献)。