SuperAPI AI 工具集

openclaw-traffic-guardian

安全与审计

查看项目

更新于 10-16 03:49

技能介绍

用途:作为 OpenClaw 运行时流量监控的规范落地技能,面向构建者提供基线定义,覆盖运营商范围内的 HTTP 代理检查、可选 HTTPS 检查(需逐进程 CA 信任)、出站外泄检测、入站注入检测、审批敏感的社交账号变更审查、脱敏本地威胁日志,以及可选的 OpenClaw 钩子/状态集成。资料明确说明本技能不包含代理或运行时实现,仅为基线规范。

安装:使用 Vercel Skills CLI 安装:npx skills add prompt-security/clawsec --skill openclaw-traffic-guardian -a openclaw -y。独立安装时需先验证签名发布清单,再信任 SKILL.md、skill.json 或归档文件;skill.json 为包元数据/SBOM 来源,发布流水线用 ClawSec 发布密钥对 checksums.json 签名。资料给出了完整验证脚本,包含公钥指纹校验、checksums.json 签名验证、归档与清单文件 SHA-256 比对,验证成功后才可解压安装。

安全契约:仅限主动启用;默认只检测并记录;不自动安装系统 CA;不修改全局 HTTP_PROXY 或 HTTPS_PROXY;首个实现不做阻断;日志或对话告警前先脱敏密钥;所有状态存放于 OPENCLAW_TRAFFIC_GUARDIAN_HOME 或 ~/.openclaw/security/clawsec/traffic-guardian。

构建入口:实现前先读 SPEC.md。lib/ 放检测规则、脱敏、事件模式与报告格式;scripts/ 放启动、停止、状态、配置校验与日志查询辅助;hooks/openclaw-traffic-guardian-hook/ 为可选 OpenClaw 钩子集成;test/ 放单元测试、代理夹具测试、脱敏测试与进程范围测试。

首次实现行为要求:不启动代理即可校验配置;前台或显式后台启动监控;将代理环境变量限定到目标 OpenClaw 进程;在限定字节内检查 HTTP 请求/响应文本;仅当运营商提供逐进程信任配置时支持可选 HTTPS MITM;将符合 SPEC.md 出站 POLICY_REVIEW 的请求标记为运营商审查发现,包括 TweetClaw 或其他 X/Twitter 自动化写入,以及无新鲜运营商审批标记的调度器/后台运行器重复请求;从路径、头部、user-agent、客户端上下文、工具调用元数据或调度器标识等受限请求元数据识别重复/后台运行上下文;输出 JSONL 发现,含脱敏片段、来源类型、变更类别、审批标记存在性及直接运营商与后台运行上下文区分;提供 status 命令报告模式、监听器、CA 指纹(若有)与最近发现。

限制:v0.0.1 范围内不含自动修改系统信任库、透明网络拦截、默认阻断、向外部服务发送流量、收集完整请求/响应体。备注:本技能不是代理或运行时实现,仅为基础规范。