agentguard
AI Agent 实时安全守卫，Hook 层拦截危险命令，Scanner 层扫描恶意技能，Patrol 层每日巡检
加载项目详情…
本应用为开源项目，仅供学习研究，请遵守其开源协议。
微信扫码咨询客服
POMOAI — 让开源 AI 即刻运行
AI Agent 实时安全守卫，Hook 层拦截危险命令，Scanner 层扫描恶意技能，Patrol 层每日巡检
加载项目详情…
本应用为开源项目，仅供学习研究，请遵守其开源协议。
想象一下：你给一位能力超强但完全没有安全意识的「超级助手」开放了全部权限——它可以运行任何命令、读取任何文件、安装任何插件。这位助手技术一流，却完全分不清好坏。一条恶意指令，就能让你的 SSH 密钥全部泄露；一个伪装成工具的陷阱脚本，就能清空你的钱包。
这正是 AI Coding Agent 在生产环境中面临的真实困境。而 GoPlus AgentGuard 正是为解决这一痛点而生的安全守卫。
图1：GoPlus AgentGuard 官方 Logo
AI Coding Agent（如 Claude Code、OpenClaw、Codex 等）的设计初衷是让 AI 能够像人类开发者一样完成复杂任务——读写文件、执行终端命令、安装依赖、甚至修改系统配置。这种「全权限」设计在提升效率的同时，也打开了巨大的安全缺口。
已有多起真实事件证明这一风险的严重性：
GoPlus Security 是 Web3 安全领域的基础设施提供商，曾推出过多个被广泛使用的安全工具（如 Token approval 安全检测服务）。AgentGuard 是其在 AI 安全方向的新布局，延续了其「开放、用户驱动的安全服务」理念。
AgentGuard 采用「三明治」式分层安全架构，从被动拦截到主动巡检，层层设防：
这是 AgentGuard 最核心的被动防御机制。通过在 Agent 的命令执行路径上插入安全钩子，实时拦截危险操作，无需联网，本地即可工作。
核心防护规则包括：
rm -rf /（递归删除根目录）、fork bombs（叉形炸弹）、curl | bash 等高危操作.env、.ssh/、~/.aws/ 等敏感目录写入，防止密钥被窃取或覆写安装方式极为简单，一条命令即可自动适配当前 Agent 平台：
npm install -g @goplus/agentguard
agentguard init --agent auto
agentguard status
这是主动防御层。当 Agent 准备安装或加载新的技能包时，Deep Scan 模块会用 24 条检测规则 对代码进行全面「安检」，在恶意代码实际运行之前将其拦截。
检测能力覆盖：
# 扫描本地技能包
agentguard scan ./examples/vulnerable-skill
这是常态化安全运营层。通过定时任务每天自动执行 8 项综合安全检查，发现技能被篡改、密钥暴露、网络风险和可疑文件变更等异常情况。
# 每小时自动巡检
agentguard subscribe --cron "0 * * * *"
图2：GoPlusSecurity 组织头像
从源码结构来看，AgentGuard 的架构设计非常清晰：
核心模块（src/）：
scanner/：技能扫描引擎，内置规则库 + 支持调用 Cisco AI Defense skill-scanner 进行高级行为分析registry/：信任注册表，基于能力的权限模型，追踪每个技能的权限范围action/detectors/：运行时行为检测器，分 exec（命令执行）、network（网络请求）、secret-leak（密钥泄露）三大方向runtime/：运行时评估引擎，决策引擎本地优先，必要时连接 GoPlus Cloud 查询云端策略adapters/：多平台适配层，抽象出通用 Hook 接口，对接不同 Agent 平台cloud/：与 AgentGuard Cloud 的通信客户端多 Agent 平台适配（src/adapters/）：
AgentGuard 并没有针对单一平台开发，而是抽象出了通用的 Hook 接口，目前支持：
hermes-hooks.yaml 配置evaluateHook() 接口这种架构的优势在于：安全规则只需编写一次，便可在所有主流 Agent 平台上生效。同时，每个平台都有对应的插件实现（如 plugins/hermes/ 为 Python 实现），确保与宿主 Agent 的深度集成。
AgentGuard 的安装体验设计得很好——一条 npm install + agentguard init --agent auto 即可完成核心安装，且本地运行时不需要云端账号、不需要网络连接。
但值得注意的是：「安装完成」并不等于「防护生效」。真正起作用的是 init 过程——它需要检测当前 Agent 平台（OpenClaw/QClaw/Claude Code/Hermes/Codex），并将对应的 Hook 插件注册到 Agent 的执行链中。
| 方式 | 说明 |
|---|---|
| npm 全局安装（推荐） | npm install -g @goplus/agentguard，最简洁 |
| setup.sh 脚本 | 支持指定目标路径和卸载，适合高级用户 |
| Docker Compose | examples/openclaw-docker/ 提供一键体验环境 |
由于是 CLI 工具，没有独立的 Web UI，但支持通过 MCP 服务器模式运行（agentguard-mcp），可以与支持 MCP 的 Agent 平台集成。
1. 平台覆盖仍有空白：虽然支持主流 Agent 平台，但对于一些国产或小众 Agent 框架的支持尚未纳入。
2. 云端策略 vs 本地策略的信任问题：完整的安全防护需要连接 AgentGuard Cloud，用户需要在隐私和安全之间做权衡。
3. 规则更新速度的挑战：AI Agent 的攻击手段在快速演化，24 条检测规则能否跟上新型攻击的节奏，取决于 GoPlus 社区的安全研究能力。
AI Agent 安全是 2025-2026 年最受关注的安全细分领域之一。随着 Claude Code、Copilot Workspace、OpenClaw 等 AI Coding Agent 的普及，「让 AI 有能力但没有安全意识」的问题已经从小众极客圈走向了企业级关注。
AgentGuard 的出现填补了这一空白——它是目前首个针对 AI Agent 提供实时安全防护的开源工具，通过 Hook 机制实现了对 Agent 行为的全程监控，且不依赖特定的云服务。
432 颗 GitHub Stars 和 65 个 Forks 说明它已经引起了开发者的关注。随着 AI Agent 在软件开发中的渗透率持续提升，AgentGuard 及其背后的安全规则生态有望成为 AI 编程时代的基础设施组件。
如果你在生产环境中使用 AI Coding Agent，AgentGuard 值得成为你安全体系中的一环。