← Back to Skills Marketplace
124
Downloads
0
Stars
0
Active Installs
2
Versions
Install in OpenClaw
/install memory-guardian
Description
Memory health monitoring, integrity checks, and 3-layer memory architecture for AI agents. Use when agents need to prevent memory loss, detect context overfl...
Usage Guidance
This skill bundles a benign-looking file-scanner but its markdown instructions instruct the agent to extract and permanently store credentials and to perform promotions/deletions—behavior not implemented in the shipped script. If you want to use it: (1) Do not run it against a workspace that contains real secrets until you audit and sandbox it. (2) Confirm with the author whether automatic promotion/deletion or credential extraction is implemented; prefer a read-only mode. (3) If you must run it, set OPENCLAW_WORKSPACE to a safe test directory and back up your memory directory first. (4) Ask the publisher to explicitly declare required env vars and to remove any instructions that aggregate credentials into permanent storage or to implement strict safeguards for secrets handling.
Capability Analysis
Type: OpenClaw Skill
Name: memory-guardian
Version: 1.1.0
The skill bundle implements a memory management system for AI agents but contains high-risk instructions in SKILL.md. Specifically, the 'Promotion Protocol' directs the agent to extract and store 'Credentials/keys' into permanent plaintext markdown files (e.g., permanent/user-system.md) to prevent data loss. While the provided script scripts/memory_check.py is a benign diagnostic tool for monitoring file sizes and duplicates, the instruction to store secrets in the workspace is a significant security vulnerability that could lead to credential exposure.
Capability Assessment
Purpose & Capability
The script implements file-scanning, size/staleness/duplicate detection, and index checks under a workspace path—this aligns with a 'memory health' tool. However, the SKILL.md claims broader behaviors (automatic promotions, migrations to FAISS/Neo4j, and an explicit protocol to 'extract: Credentials/keys → permanent') that are not implemented in the code. Asking the agent to extract and centralize credentials is not necessary for a read-only checker and is disproportionate to the stated purpose.
Instruction Scope
Runtime instructions instruct running the provided scanner (fine) but also instruct policy-level actions such as promoting secrets/credentials into permanent storage and deleting session files. Those instructions broaden scope to sensitive data handling. The scanner itself only reads files and prints a report; the SKILL.md gives the agent authority to perform destructive/promotional actions that would affect secrets and long-term storage, which is scope creep and risky.
Install Mechanism
No install spec is provided (instruction-only with a bundled script). No downloads or installers—low installation risk.
Credentials
The code reads OPENCLAW_WORKSPACE (defaulting to ~/.openclaw/workspace) but the skill declares no required environment variables. There's a mismatch between declared requirements and actual behavior. More importantly, the SKILL.md explicitly instructs extracting/storing credentials into permanent memory yet requests no credentials itself—this is an unexplained handling of sensitive data.
Persistence & Privilege
The skill is not set to always:true and does not autonomously modify other skills. The provided script, as written, is read-only: it scans and prints a report. However, the human instructions reference deleting session files and promoting contents, which would be destructive if implemented. At present the code does not implement --fix/auto-repair behavior despite the documentation, which is an implementation mismatch to watch for.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install memory-guardian - After installation, invoke the skill by name or use
/memory-guardian - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.1.0
Tightened health check thresholds, clearer 3-layer architecture docs, added migration triggers.
v1.0.0
Initial release of Memory Guardian: streamline memory management and health for AI agents.
- Introduces a 3-layer memory architecture (Working, Permanent, Archive) to prevent memory loss and context overflow.
- Automated health checks catch oversized files, total memory bloat, duplicates, staleness, index inconsistencies, and orphans.
- Defines clear danger zones based on memory usage, with actionable thresholds.
- Outlines strict protocols for promoting critical information before deletion.
- Includes migration triggers for semantic storage backends (e.g., FAISS) as memory grows.
- Provides emergency recovery steps leveraging git history.
Metadata
Frequently Asked Questions
What is Memory Guardian?
Memory health monitoring, integrity checks, and 3-layer memory architecture for AI agents. Use when agents need to prevent memory loss, detect context overfl... It is an AI Agent Skill for Claude Code / OpenClaw, with 124 downloads so far.
How do I install Memory Guardian?
Run "/install memory-guardian" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Memory Guardian free?
Yes, Memory Guardian is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Memory Guardian support?
Memory Guardian is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Memory Guardian?
It is built and maintained by KairoKid (@dodge1218); the current version is v1.1.0.
More Skills