← Back to Skills Marketplace
326
Downloads
1
Stars
3
Active Installs
1
Versions
Install in OpenClaw
/install mindclaw
Description
Structured long-term memory for AI agents with fact curation, conflict detection, importance scoring, timeline reconstruction, and OpenClaw integration.
Usage Guidance
Before installing or enabling MindClaw, consider the following: 1) Verify provenance: confirm the pip package and GitHub repository are the official project (metadata in files references multiple repo names — resolve that mismatch). 2) Backup OpenClaw/agent files (MEMORY.md, ~/.openclaw/tools.json, Claude Desktop config) because MindClaw's setup/mcp install will modify those files. 3) Audit the mcp install/setup code paths (mcp_server.py and CLI install handlers) to see precisely what files they modify and whether they call external endpoints. 4) If you accept automatic registration, run setup interactively rather than allowing an agent to call setup_mindclaw without human approval. 5) Be cautious about feeding conversation logs to auto-capture: the capture rules detect credential-like strings (they attempt to redact values but still store context) — do not pass secrets into capture or disable auto-capture for sensitive streams. 6) Prefer testing in a sandbox / VM or with a non-production OpenClaw workspace and a disposable agent namespace until you are satisfied with behavior.
Capability Analysis
Type: OpenClaw Skill
Name: mindclaw
Version: 0.3.1
The MindClaw skill bundle appears benign. It provides persistent memory and knowledge graph capabilities for AI agents, integrating with OpenClaw and Claude Desktop via the Model Context Protocol (MCP). The code demonstrates security awareness, notably by redacting potential credentials during auto-capture (`src/mindclaw/capture.py`). File system modifications (e.g., writing to `~/.mindclaw/config.json`, `~/.openclaw/tools.json`, `MEMORY.md`) are explicitly for tool configuration and data synchronization, which are core, stated functions of an agent memory skill. Network activity is limited to local Ollama instances for semantic embeddings (`http://localhost:11434`). There is no evidence of data exfiltration, arbitrary code execution, or malicious prompt injection attempts in the documentation or code.
Capability Assessment
Purpose & Capability
The name/description (structured long-term memory for agents, OpenClaw integration) match the code and CLI features (SQLite store, BM25 search, Ollama semantic support, sync to OpenClaw MEMORY.md). However there are small metadata inconsistencies (registry lists no homepage/source while SKILL.md and other files reference different GitHub repos: Blue8x/MindClaw vs Blue8x/Clawtion), which reduces confidence in provenance.
Instruction Scope
Runtime instructions and code explicitly read/write user files: ~/.mindclaw/config.json, a DB under ~/.mindclaw, and OpenClaw workspace files (~/.openclaw/workspace/MEMORY.md). The tool also auto-registers itself with other runtimes (Claude Desktop and OpenClaw) by modifying their config files. The capture rules will scan conversation text for credential-like patterns and attempt to redact them, but the capability to detect/store redacted credential context is present — this increases the risk of sensitive data being processed and persisted unintentionally.
Install Mechanism
No install spec bundled in the registry; SKILL.md instructs using pip install mindclaw[mcp], which is a normal delivery mechanism. The bundle includes full source/pyproject making local inspection possible. No network downloads from obscure URLs are required by the instructions. The mismatch in repository names/URLs (Clawtion vs MindClaw) is a provenance anomaly to check before pip installing from an external registry.
Credentials
The skill does not require secrets or external credentials to function, and declares no required env vars, but supports MINDCLAW_DB / MINDCLAW_AGENT / MINDCLAW_OPENCLAW_WORKSPACE overrides and may auto-detect a local Ollama instance. The capture engine looks for credential-like text in conversation streams (and redacts values) — that behavior is plausible for a memory tool but is sensitive and should be considered when granting agents access to conversation logs. The tool also edits other apps' config files (Claude Desktop, OpenClaw) to register itself — those actions need explicit user consent.
Persistence & Privilege
The skill persists long-term data (~/.mindclaw/config.json, SQLite DB) which is expected. However it also offers automated registration that updates other tools' configuration (Claude Desktop and OpenClaw tools registries). Modifying other tools' configs is out-of-scope for a simple memory store and increases privilege/persistence surface; verify exactly what files are changed and that you consent to those changes.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install mindclaw - After installation, invoke the skill by name or use
/mindclaw - Provide required inputs per the skill's parameter spec and get structured output
Version History
v0.3.1
v0.3.1 — Setup wizard + persistent config. One command install: `mindclaw setup` configures workspace, agent name, and registers with OpenClaw/Claude Desktop. New `setup_mindclaw` MCP tool for agent-driven onboarding. Settings persist in ~/.mindclaw/config.json (priority: CLI flag > env var > config > default).
Metadata
Frequently Asked Questions
What is MindClaw?
Structured long-term memory for AI agents with fact curation, conflict detection, importance scoring, timeline reconstruction, and OpenClaw integration. It is an AI Agent Skill for Claude Code / OpenClaw, with 326 downloads so far.
How do I install MindClaw?
Run "/install mindclaw" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is MindClaw free?
Yes, MindClaw is completely free (open-source). You can download, install and use it at no cost.
Which platforms does MindClaw support?
MindClaw is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created MindClaw?
It is built and maintained by Wouldyou (@blue8x); the current version is v0.3.1.
More Skills