← 返回 Skills 市场
🩺 memory-health-check
作者
chongjie-ran
· GitHub ↗
· v1.0.0
· MIT-0
71
总下载
0
收藏
0
当前安装
1
版本数
在 OpenClaw 中安装
/install memory-health-check
功能描述
Performs a 6-dimension memory health check assessing integrity, freshness, bloat, orphans, duplicates, and coverage with optional auto-repair.
安全使用建议
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.
功能分析
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.
能力标签
能力评估
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.
如何使用
- 确保已安装 OpenClaw(本地或 Docker 部署)
- 在对话框中输入安装命令:
/install memory-health-check - 安装完成后,直接呼叫该 Skill 的名称或使用
/memory-health-check触发 - 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
版本历史
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.
元数据
常见问题
🩺 memory-health-check 是什么?
Performs a 6-dimension memory health check assessing integrity, freshness, bloat, orphans, duplicates, and coverage with optional auto-repair. 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 71 次。
如何安装 🩺 memory-health-check?
在 OpenClaw 或 Claude Code 对话框中运行命令「/install memory-health-check」即可一键安装,无需额外配置。
🩺 memory-health-check 是免费的吗?
是的,🩺 memory-health-check 完全免费,采用 MIT-0 许可证,可自由下载、安装和使用。
🩺 memory-health-check 支持哪些平台?
🩺 memory-health-check 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(cross-platform)。
谁开发了 🩺 memory-health-check?
由 chongjie-ran(@chongjie-ran)开发并维护,当前版本 v1.0.0。
推荐 Skills