← 返回 Skills 市场
OpenClaw Guardian
作者
fatcatMaoFei
· GitHub ↗
· v1.0.1
714
总下载
0
收藏
8
当前安装
2
版本数
在 OpenClaw 中安装
/install openclaw-guardian
功能描述
A security layer plugin for OpenClaw that intercepts dangerous tool calls (exec, write, edit) through two-tier regex blacklist rules and LLM-based intent ver...
安全使用建议
This plugin is internally consistent with its purpose, but before installing: (1) verify the plugin source (the README suggests a GitHub repo) and review the included code yourself or from a trusted reviewer; (2) understand that Guardian will read recent conversation session files and send them to whichever model provider is configured in OpenClaw (so ensure you trust that provider and that it’s configured to not leak sensitive data); (3) check and possibly restrict which provider/config entries it can use, and review the audit log location (~/.openclaw/guardian-audit.jsonl); (4) consider lowering automatic trust (trustBudget) or testing in a safe environment before enabling broadly. If you want, I can point out specific lines to review or summarize exactly which files/fields are sent to the LLM calls.
功能分析
Type: OpenClaw Skill
Name: openclaw-guardian
Version: 1.0.1
The OpenClaw Guardian skill bundle is designed as a security layer to intercept and verify dangerous tool calls, implementing a robust two-tier regex blacklist (`scripts/blacklist.ts`) and an LLM-based intent verification system (`scripts/llm-voter.ts`). While its intent is clearly defensive, the LLM verification component is susceptible to prompt injection. The `readRecentContext` function in `scripts/llm-voter.ts` feeds recent user messages directly to the LLM to determine if a dangerous action was explicitly requested. A sophisticated attacker could craft user messages that manipulate the LLM into confirming a blacklisted operation, thereby bypassing the intended security control. This constitutes a significant vulnerability, classifying the skill as suspicious rather than malicious, as the code itself is not designed for harmful behavior but contains a flaw that could be exploited.
能力评估
Purpose & Capability
Name/description match the code and runtime instructions: it intercepts exec/write/edit calls, applies two-tier regex blacklists, and uses LLM-based voting for flagged operations. No unrelated services or credentials are requested.
Instruction Scope
The SKILL.md and code explicitly read recent conversation session files for context and send that context to model providers for intent checks. Reading user messages is necessary for its stated 'did the user ask for this?' function, but it's a sensitive action (conversation contents may include secrets). Audit logging to ~/.openclaw/guardian-audit.jsonl is also performed for blacklist hits.
Install Mechanism
No packaged installer is included (the README suggests cloning a GitHub repo or using openclaw plugins install). The skill bundle contains the source files, so there is no hidden download step in the provided package, but manual installation instructions point to an external GitHub repo (verify source/trust before cloning).
Credentials
The plugin does not declare extra env vars, but it auto-discovers the user's OpenClaw model providers and reads provider.baseUrl and provider.apiKey from OpenClaw config to call LLM endpoints. This is proportionate to the claimed LLM voting feature but means your existing model credentials and conversation context will be used/sent to those providers — review provider trust and config privacy settings.
Persistence & Privilege
It registers a before_tool_call hook (expected for a safety gate), does not set always: true, and does not modify other plugins. It writes an audit log to the user's home directory (normal for an audit trail).
如何使用
- 确保已安装 OpenClaw(本地或 Docker 部署)
- 在对话框中输入安装命令:
/install openclaw-guardian - 安装完成后,直接呼叫该 Skill 的名称或使用
/openclaw-guardian触发 - 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
版本历史
v1.0.1
Fix: match actual implementation (blacklist + LLM voting, no scoring). Updated core code to PR #25480.
v1.0.0
Initial release
元数据
常见问题
OpenClaw Guardian 是什么?
A security layer plugin for OpenClaw that intercepts dangerous tool calls (exec, write, edit) through two-tier regex blacklist rules and LLM-based intent ver... 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 714 次。
如何安装 OpenClaw Guardian?
在 OpenClaw 或 Claude Code 对话框中运行命令「/install openclaw-guardian」即可一键安装,无需额外配置。
OpenClaw Guardian 是免费的吗?
是的,OpenClaw Guardian 完全免费(开源免费),可自由下载、安装和使用。
OpenClaw Guardian 支持哪些平台?
OpenClaw Guardian 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(cross-platform)。
谁开发了 OpenClaw Guardian?
由 fatcatMaoFei(@fatcatmaofei)开发并维护,当前版本 v1.0.1。
推荐 Skills