Aport Agent Guardrail

🛡️ AI代理执行的确定性安全护栏

AI代理预执行安全护栏,通过before_tool_call钩子实现工具调用的确定性策略拦截,防止未授权命令、数据泄露与恶意操作。支持本地离线模式与API托管模式,提供防篡改审计日志。

收藏
7.3k
安装
1.6k
版本
1.1.11
CLS 安全扫描中
预计需要 3 分钟...

使用说明

APort Agent Guardrail是一款专为AI代理设计的预执行授权系统,通过在OpenClaw、IronClaw、PicoClaw等框架的before_tool_call钩子中介入,在工具实际执行前完成身份验证与策略评估。其核心机制基于Open Agent Passport (OAP) v1.0标准,将代理身份、能力边界与操作限制结构化定义,形成不可绕过的确定性强制控制。

核心优势在于其架构设计的彻底性:与依赖提示词防护的方案不同,该工具在平台层面拦截,代理无法通过提示注入或社会工程绕过;默认故障关闭(fail-closed)策略确保任何评估异常均阻断执行而非放行;本地模式实现零网络传输的完全隐私保护,API模式则引入Ed25519签名决策与全球暂停能力,满足合规审计的法庭可采信要求。开箱即用的防护覆盖40余种危险命令模式(如rm -rf、sudo、dd等)、SSRF防护、消息发送速率限制及文件路径访问控制,大幅降低安全配置门槛。

显著局限性包括:应用层定位意味着无法防御操作系统级攻击(如文件系统提权、OpenClaw运行时漏洞)、供应链污染或网络层中间人攻击;API模式引入约60-100ms延迟,本地模式虽支持离线但策略更新需手动同步;自定义策略在本地模式下需直接修改脚本,体验不及API模式的结构化配置。此外,项目生态目前深度绑定OpenClaw系列框架,对其他代理运行时(如LangChain原生、AutoGPT等)的支持依赖社区适配。

适用人群涵盖三类场景:企业合规团队需要SOC 2/HIPAA/SOX审计追踪与集中策略管控;个人开发者使用社区技能时担忧恶意代码注入; air-gapped环境部署者追求离线安全保障。特别适用于金融、医疗等对操作可审计性要求严格的领域。

常规风险需关注:本地模式的护照文件篡改风险(需配合文件完整性监控);API模式的密钥管理(APORT_API_KEY需环境变量注入避免配置泄露);以及策略配置错误导致的可用性中断——过于严格的允许列表可能阻断正常开发工作流。建议生产环境采用API模式获取签名决策,开发环境本地模式快速迭代,并建立决策日志的定期审计机制。

Aport Agent Guardrail 内容

手动下载zip · 5.5 kB
SKILL.mdtext/markdown
请选择文件