← Back to Skills Marketplace
fatcatmaofei

OpenClaw Guardian

by fatcatMaoFei · GitHub ↗ · v1.0.1
cross-platform ⚠ suspicious
714
Downloads
0
Stars
8
Active Installs
2
Versions
Install in OpenClaw
/install openclaw-guardian
Description
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...
Usage Guidance
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.
Capability Analysis
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.
Capability Assessment
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).
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install openclaw-guardian
  3. After installation, invoke the skill by name or use /openclaw-guardian
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.1
Fix: match actual implementation (blacklist + LLM voting, no scoring). Updated core code to PR #25480.
v1.0.0
Initial release
Metadata
Slug openclaw-guardian
Version 1.0.1
License
All-time Installs 11
Active Installs 8
Total Versions 2
Frequently Asked Questions

What is 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... It is an AI Agent Skill for Claude Code / OpenClaw, with 714 downloads so far.

How do I install OpenClaw Guardian?

Run "/install openclaw-guardian" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is OpenClaw Guardian free?

Yes, OpenClaw Guardian is completely free (open-source). You can download, install and use it at no cost.

Which platforms does OpenClaw Guardian support?

OpenClaw Guardian is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created OpenClaw Guardian?

It is built and maintained by fatcatMaoFei (@fatcatmaofei); the current version is v1.0.1.

💬 Comments