Axora AgentGuard 是一个 AI 智能体安全防护框架,以技能形式安装使用,核心命令为 agentguard。
用途 AgentGuard 用于对 AI 智能体环境进行安全审计与运行时防护。它可以扫描已安装的技能或代码库中的安全风险,评估运行时操作是否安全,管理技能信任等级,并生成安全健康检查报告。
主要能力
- 安全扫描:scan 子命令可扫描指定路径的技能或代码库,支持全部检测规则,输出格式支持 text(默认 markdown)与 sarif(SARIF 2.1.0 JSON),并可通过 --output 写入文件。
- 运行时操作评估:action 子命令用于判断某个运行时操作是否安全。
- 安全巡检:patrol 子命令提供每日安全巡检,支持 run、setup、status,适用于受支持的智能体与本地调度环境。
- 信任管理:trust 子命令支持 lookup、attest、revoke、list、seed,用于管理技能信任等级。
- 审计报告:report 子命令查看审计日志中的近期安全事件。
- 保护级别配置:config 子命令可设置 strict、balanced、permissive 三种保护级别。
- 健康检查:checkup 子命令运行全面的智能体健康检查并生成可视化 HTML 报告;也支持 CLI 的 --json 输出,以及针对单条情报的 --against-advisory <id> 定向自检模式。
- 威胁情报订阅:subscribe 子命令拉取 AgentGuard Cloud 威胁情报通告、自检本地技能,并可选安装定时通知任务。
- Hermes 运行时钩子:hermes-hooks 子命令展示或安装 Hermes shell 钩子配置,用于运行时保护。
- CLI 直通:cli 子命令可直接运行已安装的 agentguard CLI 命令。
使用方式 安装后建议执行 agentguard init --agent auto 完成必需设置;当主机已知且需要针对性设置时,可指定具体智能体,如 hermes、qclaw、openclaw、claude-code 或 codex。agentguard connect 与 agentguard checkup 属于可选后续步骤。
技能内所有命令引用 scripts/ 相对路径,运行前必须解析为该技能目录的绝对路径。例如若 SKILL.md 位于 ~/.openclaw/skills/agentguard/SKILL.md,则应先 cd ~/.openclaw/skills/agentguard 再运行 node scripts/checkup-report.js。
命令路由:解析参数确定子命令,包括 init、connect、scan、action、patrol、trust、subscribe、report、config、checkup、hermes-hooks、cli。若无子命令或第一个参数是路径,默认执行 scan。技能路由的子命令优先于同名 CLI 命令,除非用户显式使用 /agentguard cli 前缀。
Cloud 连接:agentguard connect 支持 API-key 认证或 Agent JWT 认证,二者只需其一。在 OpenClaw 环境中,不带 --key、--api-key 或 AGENTGUARD_API_KEY 的 connect 是有效的,CLI 会使用 Agent JWT 注册并打印激活链接。建议优先使用 AGENTGUARD_API_KEY 环境变量而非在参数中传递密钥。
审批流程:当 AgentGuard 返回 confirm 或包含审批命令的阻止原因时,在用户明确批准前不得重试受保护操作。需向用户展示确切的审批命令,绝不主动运行审批命令,也不得从上下文或智能体自身计划推断批准。用户在看到命令并理解所批准的操作后,回复“yes”“approve”“同意”“确认”等可视为对最近一次受保护操作的明确批准。批准后运行提供的 agentguard approve --action-id ... --once 命令,然后重试原操作一次。
Hermes 钩子:Hermes 不会自动从 SKILL.md 加载钩子,需在 ~/.hermes/config.yaml 中配置 shell 钩子。agentguard init --agent hermes 可自动安装技能并合并钩子条目。钩子覆盖 terminal、execute_code、write_file、patch、skill_manage、read_file、web_search、web_extract、browser_navigate 等工具,pre_tool_call 支持 allow/block,post_tool_call 仅审计。若 AgentGuard 返回 ask,Hermes 钩子会报告为 block 并附带确认导向消息。
订阅与定时:agentguard subscribe 可拉取威胁情报通告。使用 --quiet 时执行完整自动化流程:拉取新通告、自检本地技能、将本地匹配上报 Cloud,仅在发现本地匹配时通知。使用 --cron <expr> 时先运行一次订阅流程,再安装标准五字段 cron 表达式(如 "0 * * * *")的循环任务。--cron-target auto 为默认值,使用 agentguard init --agent 保存的智能体主机;openclaw 使用原生 openclaw cron add 并回退到 127.0.0.1:18789 的 OpenClaw Gateway,qclaw 使用 127.0.0.1:28789 的 QClaw Gateway,hermes 使用原生 hermes cron create,claude-code、codex、dsh 在类 Unix 主机使用用户 crontab,在 Windows 使用原生任务计划程序。系统 cron 与 Windows 任务计划程序将输出写入 ~/.agentguard/feed-cron.log。
适用场景 适用于需要对 AI 智能体技能与代码进行安全扫描、运行时操作防护、技能信任管理、安全巡检与审计、威胁情报订阅,以及为 Hermes Agent 配置运行时钩子的场景。
限制 Hermes pre_tool_call 仅支持 allow/block,不支持 ask。系统 cron 与 Windows 任务计划程序不发送 OpenClaw 智能体通道通知。若保存的主机存在且传入不匹配的 --cron-target,CLI 会拒绝安装。若未保存智能体主机,auto 会要求先运行 agentguard init --agent <...> 或显式传入目标。部分功能(如语义隐私增强)为可选且需显式启用。