← Back to Skills Marketplace
Memory Health Probe
by
Nissan Dookeran
· GitHub ↗
· v1.0.1
· MIT-0
395
Downloads
0
Stars
1
Active Installs
2
Versions
Install in OpenClaw
/install memory-health-probe
Description
QMD memory system telemetry — measure index health, BM25 retrieval quality, coverage maps, and trend analysis. Use when running QMD memory backend and need d...
Usage Guidance
This skill appears to do exactly what it says: local telemetry for a QMD memory backend. Before installing or running it, do the following: (1) Review the script (scripts/memory_probe.py) yourself or run it in --dry-run to see exactly what it prints; (2) Confirm LANGFUSE_URL is localhost and not pointed at an external host; if you don't run Langfuse locally, treat the network calls as failing and inspect what would be sent; (3) Be aware it reads ~/.openclaw/logs/gateway.log and gateway.err.log — those logs can contain sensitive metadata, so run it in a trusted environment or sanitize logs if needed; (4) If you don't want qmd:// path or other metadata in telemetry, remove or sanitize those fields before sending; (5) Optionally change hardcoded Langfuse keys/URL to environment variables so the agent doesn't ship static credentials. Overall the skill is coherent, but audit data flows you consider sensitive before allowing it to run regularly.
Capability Analysis
Type: OpenClaw Skill
Name: memory-health-probe
Version: 1.0.1
The script `scripts/memory_probe.py` performs automated searches against the local QMD memory index using a 'canonical query set' that includes highly sensitive targets such as '1Password service account token' and 'Telegram personal account'. While the results are logged to a local Langfuse instance (localhost:3100) and local JSON files, the specific targeting of credentials and private account information for 'telemetry' purposes acts as a discovery mechanism for sensitive data. Furthermore, the `SKILL.md` file contains a misleading security note claiming base64 is used for local storage encoding, whereas it is actually used for HTTP Basic Authentication.
Capability Assessment
Purpose & Capability
Name/description (QMD memory telemetry) matches the actual actions: it runs a qmd binary to collect index and BM25 metrics, reads OpenClaw gateway logs, computes coverage and trends, and stores snapshots. Required binaries (python3 + qmd) are appropriate for this purpose. No unrelated third-party credentials or services are requested.
Instruction Scope
The runtime instructions and included script stay within telemetry scope: querying qmd, scanning gateway logs (~/.openclaw/logs/...), computing BM25 hit/score and coverage, and storing snapshots. The script posts telemetry to LANGFUSE_URL (default http://localhost:3100). It can include qmd:// URIs and other metadata in payloads; it does not read or transmit raw document contents. Users should note it reads files under the user's home directory (gateway logs) which can contain sensitive metadata or error stacks.
Install Mechanism
Instruction-only skill with a bundled Python script; there is no install spec and nothing is downloaded or written to system locations by an installer. Risk from install mechanism is low.
Credentials
The skill declares no required environment variables or secrets and the script uses hardcoded local Langfuse credentials/URL. It does read local log files (gateway logs) and QMD outputs which may contain sensitive metadata; while this is proportional to telemetry, users should be aware that metadata (qmd:// paths, query hits) is sent to the configured Langfuse endpoint. If LANGFUSE_URL were changed to an external host, telemetry could be exfiltrated — verify it remains local before use.
Persistence & Privilege
The skill is not always-enabled and does not request elevated or system-wide persistence. It writes snapshots into its local data directory only and does not modify other skills or system configs.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install memory-health-probe - After installation, invoke the skill by name or use
/memory-health-probe - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.1
Clarify security_notes: base64 is local telemetry encoding, not external transmission
v1.0.0
Initial release — QMD memory telemetry and diagnostics
Metadata
Frequently Asked Questions
What is Memory Health Probe?
QMD memory system telemetry — measure index health, BM25 retrieval quality, coverage maps, and trend analysis. Use when running QMD memory backend and need d... It is an AI Agent Skill for Claude Code / OpenClaw, with 395 downloads so far.
How do I install Memory Health Probe?
Run "/install memory-health-probe" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Memory Health Probe free?
Yes, Memory Health Probe is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Memory Health Probe support?
Memory Health Probe is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Memory Health Probe?
It is built and maintained by Nissan Dookeran (@nissan); the current version is v1.0.1.
More Skills