← Back to Skills Marketplace
AgentGuard by Nano
by
sendwealth
· GitHub ↗
· v0.4.0
444
Downloads
0
Stars
0
Active Installs
4
Versions
Install in OpenClaw
/install nano-agentguard
Description
Agent Identity & Permission Guardian - Trust middleware for credential management, permission scopes, human approval workflows, and audit trails. Use when AI...
Usage Guidance
What to consider before installing:
1) Undeclared requirements: The package actually runs shell commands (1Password CLI 'op') and may spawn tmux sessions, and it reads env vars like AGENTGUARD_PASSWORD, AGENTGUARD_USE_TMUX, OP_ACCOUNT, FEISHU_OPEN_ID. The skill metadata did not declare these — verify and set them intentionally.
2) Review the code paths that execute shell commands: src/1password.js uses child_process.execSync and a tmux-based execution path that creates sockets and sessions. If you don't trust the package source, these execs could be abused to run arbitrary commands on your machine.
3) Secrets handling: CLI commands print credentials (vault get prints the value to stdout) and the tool writes audit logs under ~/.agentguard. Ensure you understand where master passwords and API keys are stored and whether you're comfortable with the local storage and stdout behaviors.
4) External notifications: The human-gate integrates with Feishu/other channels. Inspect src/feishu-notifier.js (and other notifiers) to confirm what is sent externally and whether any sensitive data could be exfiltrated in approval payloads.
5) Metadata inconsistency: The registry said 'instruction-only' while the repo contains code and package.json. Prefer to install from a known trustworthy source (official npm package or vetted repo) and verify package integrity (source repo, npm publisher, checksums) before running.
6) Safety steps: run the package in an isolated environment (sandbox/VM) first; search the repository for exec/child_process usages and all network endpoints; set a strong AGENTGUARD_PASSWORD rather than relying on the default; avoid exposing the master password in a shared environment variable; and consider disabling AGENTGUARD_USE_TMUX unless you need the tmux flow.
Given the coherent functionality but the undeclared env/exec behavior and tmux usage, the package looks plausible for its stated purpose but has enough mismatches and risky operations to mark it suspicious until you confirm provenance and review the exec/network code paths.
Capability Analysis
Type: OpenClaw Skill
Name: nano-agentguard
Version: 0.4.0
The skill is classified as suspicious due to a critical shell injection vulnerability found in `src/1password.js`. User-controlled inputs (such as agent IDs or credential keys) are directly interpolated into `child_process.execSync` calls without proper sanitization or escaping when interacting with the `op` CLI. This flaw, exposed through `src/vault-op.js` and the `agentguard` CLI (`src/cli.js`), could allow an attacker to execute arbitrary commands on the host system. While the skill's stated purpose is security-focused, this severe vulnerability poses a significant risk of remote code execution. Additionally, `src/cli.js` uses a weak default master password ('default-password-change-me') if not provided via environment variables, which is a minor security vulnerability.
Capability Assessment
Purpose & Capability
The skill claims to be a credential/approval middleware and the code implements vaults, audit, human gate and 1Password integration — so the capability set aligns with the description. However the package and SKILL metadata declare no required environment variables or binaries while the code expects/processes many env vars (AGENTGUARD_PASSWORD, AGENTGUARD_USE_TMUX, OP_ACCOUNT, FEISHU_OPEN_ID, etc.) and shell tools (1Password 'op' CLI, tmux). That mismatch between declared requirements and actual dependencies is incoherent and risky.
Instruction Scope
SKILL.md and README describe local files (~/.agentguard/*) and an API/CLI usage that is consistent. But runtime instructions and the implementation invoke external CLIs (op), spawn tmux sessions, and execute shell commands via child_process. Those behaviors access system-level resources and can read/write files and invoke external channels (Feishu/other notifiers). The SKILL.md does not fully disclose these execution behaviors or the environment variables they rely on.
Install Mechanism
The registry metadata said 'no install spec' but SKILL.md and package.json advertise npm install (package name 'agentguard') and there are full source files included. Installing via npm is a common mechanism and not inherently malicious, but the metadata inconsistency (instruction-only vs. packaged code) should be resolved. There are no arbitrary download URLs or extract steps in the files provided.
Credentials
The code uses multiple environment variables and system tools (AGENTGUARD_PASSWORD, AGENTGUARD_USE_TMUX, OP_ACCOUNT, OPENCLAW_TMUX_SOCKET_DIR, FEISHU_* etc.) but the skill registry declares no required env vars. It also defaults to a weak fallback master password ('default-password-change-me') if AGENTGUARD_PASSWORD is not set. Requesting access to 1Password CLI and external notification channels is plausible for the described feature set, but the missing declaration of these requirements and the default fallback behavior are disproportionate and should be explicit to users.
Persistence & Privilege
The skill stores data under ~/.agentguard/, writes audit logs, and expects to be installed into the OpenClaw skills directory. It is not marked 'always: true' and does not appear to alter other skills' configurations. These file writes are consistent with its purpose, but the code also may create tmux sockets and sessions and will run shell commands — this level of system interaction is broader than a purely in-process library and should be considered when granting installation.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install nano-agentguard - After installation, invoke the skill by name or use
/nano-agentguard - Provide required inputs per the skill's parameter spec and get structured output
Version History
v0.4.0
Added Compliance Reporting: GDPR/CCPA reports, risk assessment, regulatory recommendations
v0.3.0
Added Credit Score System: 6-tier reputation scoring, agent rankings, credit reports, trust-based automation
v0.2.0
Added Feishu notification integration
v0.1.0
Initial release: Credential Vault, Permission Scopes, Human Gate, Audit Trail, 1Password Integration
Metadata
Frequently Asked Questions
What is AgentGuard by Nano?
Agent Identity & Permission Guardian - Trust middleware for credential management, permission scopes, human approval workflows, and audit trails. Use when AI... It is an AI Agent Skill for Claude Code / OpenClaw, with 444 downloads so far.
How do I install AgentGuard by Nano?
Run "/install nano-agentguard" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is AgentGuard by Nano free?
Yes, AgentGuard by Nano is completely free (open-source). You can download, install and use it at no cost.
Which platforms does AgentGuard by Nano support?
AgentGuard by Nano is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created AgentGuard by Nano?
It is built and maintained by sendwealth (@sendwealth); the current version is v0.4.0.
More Skills