signet-guardian

🛡️ AI 代理支付策略防火墙与审计

Signet Guardian 为 AI 代理提供支付策略防火墙,通过预检-记录模式 enforce 限额与审计,默认拒绝策略确保资金安全。

收藏
4.1k
安装
1.4k
版本
v0.1.0
CLS 安全性认证2026-05-02
点击查看完整报告 >

使用说明

核心用法

Signet Guardian 采用预检-决策-记录的三阶段工作流,为 AI 代理的支付行为建立策略防火墙。在任何支付技能执行前,必须调用 signet-preflight 提交金额、货币、收款方和用途,系统根据用户策略返回 ALLOW(允许)、CONFIRM_REQUIRED(需用户确认)或 DENY(拒绝)。只有在获得明确许可后,支付技能方可执行真实交易。支付完成后,必须调用 signet-record 将交易记录至本地审计日志,该步骤在文件锁保护下重新校验月度限额,确保并发场景下的额度安全。

用户通过 signet-policy 配置支付策略,包括总开关、单笔限额、月度上限、确认阈值及商户黑白名单。所有交易记录以 JSONL 格式存储于本地 ledger.jsonl,支持通过 signet-report 生成消费报告。系统采用默认拒绝原则:若策略文件缺失或损坏,所有支付请求将被拒绝。

显著优点

首先,集中式策略管理让多个支付技能共享统一的权限控制,避免各自实现安全逻辑的不一致性。其次,默认拒绝(Default Deny)的安全模型确保在无配置或异常情况下资金不会误流出。第三,完善的审计追踪机制记录每笔交易的状态(完成/拒绝)、时间戳、调用方技能和幂等性密钥,满足合规需求。第四,并发安全设计通过文件锁(.ledger.lock)保护月度限额检查,结合幂等性密钥防止重复计数,在多代理并行场景下依然可靠。最后,纯本地运行模式确保支付敏感数据不出境,无网络传输风险。

潜在缺点与局限性

该技能采用 advisory(建议性)预检模式,而非运行时强制拦截,这意味着支付技能必须主动遵守"先预检后支付"的契约,恶意或缺陷技能理论上可绕过检查。此外,不支持货币转换(FX),请求货币必须与策略货币完全匹配,多货币场景需外部转换。月度限额在 signet-record 阶段才最终强制执行,若支付成功后记录失败(如已达上限),会出现"已支付但未记账"的不一致状态,需人工介入处理。

适合的目标群体

本技能适用于为 AI 代理配置自动化支付安全护栏的个人用户和小型团队,特别是使用 OpenClaw 或其他支持该中间件的代理框架的场景。适合需要限制 AI 消费额度(如每月 £500)、防止意外大额支出(如单笔超过 £20 需确认)的用例。对于需要完整支付审计日志、满足内部合规要求的自动化财务流程也极具价值。

使用风险

配置风险:若 paymentsEnabled 误设为 false 或策略文件损坏,将导致所有合法支付被拒绝,影响业务连续性。并发竞态:虽然文件锁保护记录阶段,但预检(preflight)与记录(record)之间存在时间窗口,高频并发可能导致多个预检同时通过但后续记录超限。环境依赖:策略文件路径依赖 OPENCLAW_BASE_DIR 等环境变量,配置错误可能导致策略失效或日志丢失。编辑器调用signet-policy --edit 通过 spawnSync 调用 $EDITOR 环境变量指定的编辑器,若环境变量被恶意篡改可能执行非预期程序。

安全解读

核心功能

Signet Guardian 是专为 AI Agent 设计的支付守卫中间件,采用"默认拒绝"安全模型。任何支付技能在执行交易前必须调用 signet-preflight 进行策略预检,交易成功后必须调用 signet-record 记录审计。系统通过双重验证机制确保资金安全:预检阶段快速验证支付开关、单笔限额、商家白名单/黑名单;记录阶段在文件锁保护下强制执行月度总限额,防止并发竞态导致超额。

显著优势

安全架构严谨:采用 T2 级可信组织代码(OpenClaw),无外部网络调用,所有数据本地存储于 references/ 目录。文件锁机制确保月度限额在并发场景下准确执行,idempotency-key 设计避免重复计费。

策略灵活可配:支持主开关、单笔/月度限额、强制确认阈值、商家黑白名单多层控制,货币严格匹配防止汇率风险。交互式向导降低配置门槛,同时保留 JSON 直接编辑能力。

审计完整透明:所有允许、拒绝、确认请求均记录为 JSONL 格式,支持按日/按月报告查询,满足合规追溯需求。

潜在局限

  • 无预留扣款机制:预检为"建议性"检查,月度限额仅在 signet-record 阶段强制执行。若支付已成功但记录时发现超限额,系统无法回滚交易,需人工介入。
  • 货币无转换:请求货币必须与策略货币完全一致,跨国支付需外部处理汇率。
  • 单点依赖风险:政策文件损坏或缺失即触发全局拒绝,虽安全但可能影响业务连续性。
  • 编辑器调用风险--edit 功能依赖 $EDITOR 环境变量,存在理论命令注入可能(已识别为 LOW 风险)。

适合人群

需要为 AI Agent 增加支付风控层的开发者与组织,尤其适合:有定期小额自动支付场景(订阅、账单)、对资金上限有严格预算控制需求、重视审计追踪的合规场景。

常规风险

  • 配置错误风险:限额设置过高或 paymentsEnabled 误开启可能导致超额支付。
  • 并发边界情况:极端并发下预检通过但记录拒绝的场景需人工处理。
  • 供应链风险:依赖 prompts@2.4.2 虽无已知 CVE,仍需持续监控更新。

signet-guardian 内容

docs文件夹
openclaw-extension文件夹
signet-guardian文件夹
references文件夹
scripts文件夹
手动下载zip · 19.2 kB
DASHBOARD_TEST.mdtext/markdown
请选择文件