โ Back to Skills Marketplace
๐ฉบ memory-health-check
by
chongjie-ran
ยท GitHub โ
ยท v1.0.0
ยท MIT-0
71
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install memory-health-check
Description
Performs a 6-dimension memory health check assessing integrity, freshness, bloat, orphans, duplicates, and coverage with optional auto-repair.
Usage Guidance
This skill appears to implement the described memory health checks, but exercise caution before running it on a real profile:
- Review scripts/auto_repair.py before using --auto-repair. The auto-repair feature can delete files (orphans, temp files). Run it in dry-run mode first and back up your memory directory.
- Note the skill scans ~/.openclaw/workspace/*/memory/ and ~/.openclaw/memory/*.sqlite โ it may read other agents' memory on the same host. If you don't want cross-workspace scanning, run the scripts with an explicit base-dir argument or inspect/modify find_memory_dbs/find paths.
- The health_score recommendations reference external skill paths (dreaming-optimizer) that are not declared; those recommended commands may not exist and could be confusing or misleading.
- There are no network downloads or obvious exfil endpoints in the provided files, but the package writes reports to ~/.openclaw/workspace/memory/health-reports/ (inspect generate_report.py to confirm it does not upload reports anywhere). If you need higher assurance, open and review generate_report.py and scripts/auto_repair.py for any network or deletion behaviour not covered here.
- Recommended actions: run the tool first in a safe/testing environment (or with --dims to limit what runs), review auto-repair's deletion rules, run dry-run, and keep backups. If you want the skill to only scan a single agent's memory, pass a specific --base-dir or edit the search logic to narrow paths.
What would change this assessment: seeing the full auto_repair.py and generate_report.py contents (to confirm exact deletion and any network/upload behavior) would increase confidence; explicit declaration of any cross-skill dependencies (dreaming-optimizer) or limiting scans to a single agent workspace would reduce the 'suspicious' flags.
Capability Analysis
Type: OpenClaw Skill
Name: memory-health-check
Version: 1.0.0
The memory-health-check skill bundle is a diagnostic toolset designed to monitor and maintain the OpenClaw agent's memory environment. It includes scripts for SQLite integrity checks (integrity_scan.py), storage analysis (bloat_detector.py), and content maintenance (dedup_scanner.py, orphan_finder.py). While the auto_repair.py script performs file deletions, its actions are restricted to maintenance tasks like removing temporary system files or empty notes, consistent with its stated purpose. No evidence of data exfiltration, malicious persistence, or unauthorized remote execution was found.
Capability Tags
Capability Assessment
Purpose & Capability
The name/description match the code: scripts scan SQLite and Markdown memory files, compute bloat/freshness/dedup/coverage, and generate reports. However the code is broader than a single-agent scan: it enumerates ~/.openclaw/workspace/*/memory/ (other workspace agents) and ~/.openclaw/memory/*.sqlite, which means it will inspect memory belonging to other agent workspaces on the same host. The health_score code also emits CLI recommendations that point to another skill's path (~/.openclaw/workspace/skills/dreaming-optimizer/...), but the skill does not declare a dependency on that other skill โ this is a cross-skill reference that is unexpected and could lead to non-functional or surprising recommendations.
Instruction Scope
Runtime instructions and code will read file contents and SQLite DBs under ~/.openclaw and workspace subdirs (including other agents). The skill includes an auto-repair feature (scripts/auto_repair.py) which is invoked by the main entrypoint when run with --auto-repair; that script can remove orphaned files and temp files. The package will write reports to ~/.openclaw/workspace/memory/health-reports/*.json. These file reads/writes and deletion capabilities are consistent with the stated purpose but expand scope to other agents' memories and include potentially destructive actions โ the skill's SKILL.md says auto-repair is 'on user approval' but the CLI will run auto_repair.py automatically when the flag is passed, and an autonomous agent invocation could choose that flag unless additional safeguards exist.
Install Mechanism
There is no external install spec or network download; this is an instruction+code package with all scripts included. That lowers supply-chain risk: code will run from the skill bundle itself. No brew/npm/URL installs are present in the manifest.
Credentials
The skill declares no required environment variables or credentials, and the code does not appear to attempt to read secrets. That's proportionate. However it accesses multiple filesystem locations under ~/.openclaw and workspace directories (including other agents), which is broader-than-expected filesystem access for some users; it also references other skill paths/CLI commands (dreaming-optimizer) in recommendations without declaring them.
Persistence & Privilege
The skill is not marked always:true and uses normal autonomous invocation defaults, which is expected. The noteworthy privilege is the ability to remove files via scripts/auto_repair.py. While auto-repair only runs when explicitly requested (--auto-repair), an autonomous agent could invoke the skill with that flag; combined with the ability to scan other agents' memory and delete files, this raises operational risk if the skill is allowed to run autonomously without human confirmation.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install memory-health-check - After installation, invoke the skill by name or use
/memory-health-check - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial release of memory-health-checkโcomprehensive memory health diagnostics tool.
- Provides 6-dimensional health checks: integrity, freshness, bloat, orphans, deduplication, and coverage.
- Includes main script (`health_check.sh`) with modular detectors and reporters.
- Supports auto-repair for orphaned entries on user approval.
- Offers aggregate health scoring and clear report outputs.
- Compatible with OpenClaw v2026.4.9+ and sqlite3.
Metadata
Frequently Asked Questions
What is ๐ฉบ memory-health-check?
Performs a 6-dimension memory health check assessing integrity, freshness, bloat, orphans, duplicates, and coverage with optional auto-repair. It is an AI Agent Skill for Claude Code / OpenClaw, with 71 downloads so far.
How do I install ๐ฉบ memory-health-check?
Run "/install memory-health-check" in the OpenClaw or Claude Code chat to install it in one step โ no extra setup required.
Is ๐ฉบ memory-health-check free?
Yes, ๐ฉบ memory-health-check is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does ๐ฉบ memory-health-check support?
๐ฉบ memory-health-check is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created ๐ฉบ memory-health-check?
It is built and maintained by chongjie-ran (@chongjie-ran); the current version is v1.0.0.
More Skills