Openclaw Egress

✨ Openclaw Egress

Openclaw Egress

收藏
9.2k
安装
2.2k
版本
1.0.2
CLS 安全性认证2026-08-04
点击查看完整报告 >

使用说明

安全解读

核心用法

OpenClaw Egress 是一款专为 Agent 工作空间设计的网络数据防泄漏(DLP)检测工具。它通过静态代码分析扫描 Skill 文件和项目代码,识别潜在的出站网络风险,包括恶意 URL、数据外泄端点、网络函数调用等。

用户可通过 Python 直接调用四个核心命令:scan 执行完整扫描或仅扫描 Skill 目录;domains 生成工作空间中所有外部域名的映射清单;status 快速查看当前安全状态;protect(隐含功能)可对检测到的风险进行隔离处理。

工具采用分级风险评级体系:CRITICAL 级别涵盖 Base64/十六进制载荷、Pastebin 类服务、动态 DNS 等高风险模式;HIGH 级别包括 requests、urllib、curl 等网络函数调用及 webhook 地址;WARNING 级别标记可疑顶级域名、URL 短链和 IP 端点;INFO 级别则记录所有不在白名单中的外部 URL。执行后会返回标准退出码,便于 CI/CD 流程集成。

显著优点

零依赖架构是该工具最突出的特性。完全基于 Python 标准库构建(argparse、re、pathlib、urllib.parse 等),无需 pip 安装任何第三方包,彻底消除供应链攻击风险,在受限网络环境中也能直接运行。

纯本地执行确保隐私安全。所有正则匹配和模式检测均在本地完成,不发起任何实际网络请求,用户代码和数据不会离开本机环境,符合企业数据合规要求。

跨平台兼容性覆盖主流 Agent 生态。支持 OpenClaw、Claude Code、Cursor 等遵循 Agent Skills 规范的工具,且适配 macOS、Linux、Windows 三大操作系统。

透明可信来源由 GitHub 组织 AtlasPA 维护,采用 MIT 开源许可证,代码公开可审计,安全认证评分达 95 分,属 S 级优秀安全级别。

潜在缺点与局限性

功能边界明确:作为静态分析工具,它无法检测运行时的动态行为或混淆代码中的隐藏网络调用,对于加密字符串、动态生成的 URL 等高级绕过手段存在检测盲区。

扫描范围较宽:当前版本递归扫描整个工作目录,缺少 --max-depth 深度限制和 --exclude 排除目录功能,在大型项目中可能产生较多噪音结果。

交互体验待优化:缺少进度指示器,大批量文件扫描时用户无法感知执行进度;文件修改操作(如 block 隔离)仅输出到控制台,缺乏结构化审计日志。

测试覆盖不足:代码库缺少单元测试套件,核心正则匹配逻辑、风险评级算法等缺乏自动化验证,可能影响长期维护稳定性。

适合的目标群体

该工具特别适合以下场景和用户:使用 Claude Code、Cursor 等 AI 编程工具的开发者,需要审计第三方 Skill 的网络行为;企业安全团队建立 Agent 工作空间的准入检测机制;开源项目维护者在 CI 流程中集成自动化安全扫描;对数据合规有严格要求的金融、医疗、法律等行业用户;以及任何希望了解其 Agent 环境潜在网络风险的技术决策者

使用风险与注意事项

误报风险:正则模式匹配可能将正常的 API 文档链接、配置示例中的 URL 标记为风险,需要人工复核确认。

权限要求:需要对工作目录有读权限,执行 protect 操作时需要写权限创建备份和修改文件,建议在隔离环境中先行测试。

环境变量依赖:默认读取 OPENCLAW_WORKSPACE 环境变量,若未设置需显式通过 --workspace 参数指定路径,否则可能导致扫描范围错误。

非实时监控:作为离线扫描工具,无法阻止 Skill 在扫描间隙发起的网络请求,建议结合运行时的网络防火墙策略形成纵深防御。

版本维护:Skill 生态快速发展,风险模式库需要持续更新以覆盖新型外泄手段,建议关注上游版本更新。

Openclaw Egress 内容

scripts文件夹
手动下载zip · 10.3 kB
egress.pytext/plain
请选择文件