APort Agent Guardrail

AI 智能体的预操作授权机制：每次工具调用均在执行 之前 进行检查。兼容 OpenClaw、IronClaw、PicoClaw 及其他支持框架。仅需运行一次安装程序；此后 OpenClaw 插件将自动对每次工具调用强制执行策略。您 无需 手动运行 guardrail 脚本。

依赖要求：Node 18+、jq。通过 npx @aporthq/agent-guardrails 或从代码仓库执行 ./bin/openclaw 安装。

安装

# 推荐方式（无需克隆仓库）
npx @aporthq/agent-guardrails

# 托管护照（Hosted Passport）：传入来自 aport.io 的 agent_id，跳过向导
npx @aporthq/agent-guardrails 

在 aport.io 创建护照后，即可获取托管护照对应的 agent_id。可选步骤

从代码仓库安装（需先克隆）：github.com/aporthq/aport-agent-guardrails —— 然后在仓库根目录下运行 ./bin/openclaw 或 ./bin/openclaw 。完整指南见：QuickStart: OpenClaw Plugin · Hosted passport setup。

您可在本地预览护照文件：~/.openclaw/aport/passport.json（若您指定了自定义配置目录，则路径为 /aport/passport.json；旧版安装可能使用 /passport.json）。

安装器为交互式程序：它将设置您的配置目录、护照（本地或托管）、安装 APort OpenClaw 插件、写入配置并安装封装脚本（wrappers）。安装完成后无需任何额外操作——直接启动 OpenClaw（或使用正在运行的 gateway）即可；插件将在每次工具调用前自动执行策略检查。

封装脚本（默认配置目录为 ~/.openclaw）：~/.openclaw/.skills/aport-guardrail.sh（本地模式），~/.openclaw/.skills/aport-guardrail-api.sh（API / 托管模式）。插件内部调用这些脚本；除非用于测试，否则您无需手动调用。

使用方法

常规使用：仅需运行一次安装程序。此后无需任何手动操作——插件将在每次工具调用前自动执行策略检查。

可选 — 直接调用脚本（例如测试或其他自动化流程）：

~/.openclaw/.skills/aport-guardrail.sh system.command.execute '{"command":"ls"}'
~/.openclaw/.skills/aport-guardrail.sh messaging.message.send '{"channel":"whatsapp","to":"+15551234567"}'

• 退出码 0 = 允许（工具可继续执行）
• 退出码 1 = 拒绝（原因码详见 /aport/decision.json 或 /decision.json）

API 模式 / 托管护照场景下：

APORT_API_URL=https://api.aport.io ~/.openclaw/.skills/aport-guardrail-api.sh system.command.execute '{"command":"ls"}'

工具名称映射

上下文参数必须为合法 JSON 格式，例如：'{"command":"ls"}' 或 '{"channel":"whatsapp","to":"+1..."}'。

为何需要该技能？

• 确定性执行 —— 在 before_tool_call 阶段运行；智能体无法绕过该检查。
• 结构化策略 —— 基于 Open Agent Passport（OAP）v1.0 规范及策略包（policy packs）实现。
• 故障关闭（Fail-closed） —— 若 guardrail 自身发生错误，对应工具调用将被阻断。
• 审计就绪（Audit-ready） —— 所有决策均被记录（本地 JSON 日志或通过 APort API 生成带签名的凭证）。

如需增强防护能力，可将其与其他威胁检测工具协同使用；所有策略应统一经由本 guardrail 强制执行，确保不安全操作永不被执行。

文档

本仓库：QuickStart: OpenClaw Plugin · Hosted passport · Tool / policy mapping

OpenClaw： CLI: skills · Skills · Skills config · ClawHub