← Back to Skills Marketplace
jakebot-ops

Persistent Memory

by Jakebot-ops · GitHub ↗ · v3.0.0
cross-platform ⚠ suspicious
1210
Downloads
0
Stars
7
Active Installs
3
Versions
Install in OpenClaw
/install persistent-memory
Description
Three-layer persistent memory system (Markdown + ChromaDB vectors + NetworkX knowledge graph) for long-term agent recall across sessions. One-command setup w...
Usage Guidance
What to do before running this skill: - Inspect the files scripts/configure_openclaw.py and the inline configure code in unified_setup.sh to confirm the exact changes (which extraPaths will be added). - Run configure_openclaw.py with --dry-run first (or run the standalone script instead of unified_setup.sh) to see proposed edits and ensure you have a good backup of ~/.openclaw/openclaw.json. - If you must use unified_setup.sh, run it in a non-production workspace and avoid running as a privileged user; review and commit a backup of your OpenClaw config beforehand. - Be aware the setup will pip-install packages and the sentence-transformers model will download weights from the network; if you have air-gapped or constrained environments, perform installs manually. - Consider removing or excluding sensitive files (IDENTITY.md, USER.md, etc.) from the configured extraPaths if you do not want them indexed by the agent. - If you prefer manual control, run the setup steps one-by-one (create venv, copy scripts, run indexer, then run configure_openclaw.py with --backup) rather than the one-command unified installer.
Capability Analysis
Type: OpenClaw Skill Name: persistent-memory Version: 3.0.0 The skill is classified as suspicious due to its capability to modify the core OpenClaw application configuration (`~/.openclaw/openclaw.json`) and execute `openclaw` CLI commands (e.g., `openclaw gateway restart`) via `scripts/unified_setup.sh` and `scripts/configure_openclaw.py`. While the stated purpose is benign (to improve agent compliance by making OpenClaw index critical workspace files like SOUL.md and AGENTS.md), these actions involve significant system modification and shell execution. This presents a high-privilege capability that, if exploited or misused, could lead to vulnerabilities, even though there is no clear evidence of intentional malicious behavior (e.g., data exfiltration, backdoors, or malicious prompt injection) within the provided code.
Capability Assessment
✓ Purpose & Capability
The code and SKILL.md match the described purpose: parsing workspace markdown, building ChromaDB vectors and a NetworkX graph, and integrating those memories into OpenClaw. The indexer, search, graph, and auto_retrieve scripts implement the three-layer memory, and the configuration script targets OpenClaw memorySearch as promised.
⚠ Instruction Scope
The runtime instructions tell the user to run a one-command installer (unified_setup.sh) that not only creates a local venv and installs dependencies but also locates and modifies OpenClaw configuration files and attempts to restart OpenClaw. The inline Python used by unified_setup.sh updates ~/.openclaw/openclaw.json or ./openclaw.json directly (without invoking the configure_openclaw.py backup path), which is a system-level change beyond simply adding local memory files. This is in-scope for integrating with OpenClaw but is high-impact and performed without an explicit interactive confirmation or guaranteed backup in the unified path.
ℹ Install Mechanism
No registry install spec was provided; setup is performed by the provided shell scripts which create a Python venv and run pip to install pinned packages (sentence-transformers, chromadb, networkx). This is a moderate-risk, expected mechanism for a Python-based tool. Note: running the code will download model weights (sentence-transformers) from external servers at runtime.
ℹ Credentials
The skill requests no environment variables or external credentials. It does, however, add many workspace files (SOUL.md, AGENTS.md, IDENTITY.md, USER.md, reference/) to OpenClaw's memorySearch extraPaths — this will expose workspace-local directives and potentially sensitive local files to the memory index. That behavior is coherent with the stated goal but should be reviewed because it broadens what the agent will automatically read/index.
⚠ Persistence & Privilege
The skill modifies OpenClaw's configuration (a system-wide agent setting) and attempts to restart OpenClaw via the 'openclaw' CLI. The installer path bundled in unified_setup.sh makes these modifications non-interactively (no backup code path is invoked in that inline configure routine). While the action aligns with the skill's function, changing another tool's global config is high-privilege and should be done with explicit user consent and backups.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install persistent-memory
  3. After installation, invoke the skill by name or use /persistent-memory
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v3.0.0
🚀 ONE-COMMAND SETUP: Eliminates installation friction with unified_setup.sh that automatically handles 3-layer memory system creation, Python dependencies, OpenClaw memorySearch integration, and initial indexing. No more manual configuration steps.
v2.0.0
🚨 CRITICAL UPDATE: Fixes directive compliance vulnerability. Adds OpenClaw memorySearch configuration to prevent agents ignoring workspace directives (SOUL.md, AGENTS.md, etc.). All v1.x users must upgrade immediately. Includes configure_openclaw.py script for automatic integration.
v1.0.0
Initial release: three-layer persistent memory (Markdown + ChromaDB vectors + NetworkX knowledge graph). One-command setup, semantic search, sync watchdog.
Metadata
Slug persistent-memory
Version 3.0.0
License —
All-time Installs 7
Active Installs 7
Total Versions 3
Frequently Asked Questions

What is Persistent Memory?

Three-layer persistent memory system (Markdown + ChromaDB vectors + NetworkX knowledge graph) for long-term agent recall across sessions. One-command setup w... It is an AI Agent Skill for Claude Code / OpenClaw, with 1210 downloads so far.

How do I install Persistent Memory?

Run "/install persistent-memory" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Persistent Memory free?

Yes, Persistent Memory is completely free (open-source). You can download, install and use it at no cost.

Which platforms does Persistent Memory support?

Persistent Memory is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Persistent Memory?

It is built and maintained by Jakebot-ops (@jakebot-ops); the current version is v3.0.0.

More Skills
self-improving agent
Captures learnings, errors, and corrections to enable continuous improvement. Use when: (1) A command or operation fails unexpectedly, (2) User corrects Clau...
⬇ 463283 · by pskoett
Skill Vetter
Security-first skill vetting for AI agents. Use before installing any skill from ClawdHub, GitHub, or other sources. Checks for red flags, permission scope, and suspicious patterns.
⬇ 259410 · by spclaudehome
Polymarket
Query Polymarket prediction markets. Check odds, find trending markets, search events, track price movements.
⬇ 232503 · by joelchance
Self-Improving + Proactive Agent
Self-reflection + Self-criticism + Self-learning + Self-organizing memory. Agent evaluates its own work, catches mistakes, and improves permanently. Use when...
⬇ 200423 · by ivangdavila
Github
Interact with GitHub using the `gh` CLI. Use `gh issue`, `gh pr`, `gh run`, and `gh api` for issues, PRs, CI runs, and advanced queries.
⬇ 191113 · by steipete
ontology
Typed knowledge graph for structured agent memory and composable skills. Use when creating/querying entities (Person, Project, Task, Event, Document), linkin...
⬇ 190156 · by oswalpalash

💬 Comments