← Back to Skills Marketplace
OpenMem - Longterm Compressed Memory
by
danavfrost
· GitHub ↗
· v1.2.5
· MIT-0
191
Downloads
1
Stars
0
Active Installs
19
Versions
Install in OpenClaw
/install openmem
Description
SQLite long-term memory compression system for extended memory life. Adds tools for agents to control their memory functions.
Usage Guidance
This skill is internally coherent and implements the memory-compression features it describes, but it performs privacy-sensitive and destructive actions. Before installing: 1) Back up your OpenClaw session directory and any existing memory DB (the installer and uninstall script do not delete the DB). 2) Review and, if needed, override OPENMEM_SESSIONS_DIR and OPENMEM_DB to point to safe locations. 3) If you do not want automatic deletion of raw transcripts, do not enable auto-compress or run auto_compress.py with --no-wipe (or disable the cron). 4) Remember the cache file (openmem-cache.json) is plaintext and stored alongside the DB — treat it as sensitive. 5) The skill registers an MCP server and a cron job with your gateway; ensure you trust the skill before enabling hooks/cron. 6) Note minor inconsistencies in the metadata (the package contains runnable scripts despite saying “instruction-only” and SKILL.md references "Ollama" in places though the code invokes the openclaw CLI); if anything about provider usage or the model pipeline is unclear, inspect the local scripts (auto_compress.py, mcp_server.py, compress.py) before enabling automatic behavior.
Capability Analysis
Type: OpenClaw Skill
Name: openmem
Version: 1.2.5
OpenMem is a long-term memory management system that uses SQLite to store and search agent memories. The skill includes an automated compression feature (auto_compress.py) that reads session logs, extracts key information using the user's configured LLM, and replaces old session files with stubs to save space. While the session-wiping behavior is destructive, it is clearly documented as a core feature, includes a '--no-wipe' safety flag, and performs database verification before deletion. The code follows standard OpenClaw patterns for MCP servers and hooks, and no evidence of data exfiltration or unauthorized network activity was found.
Capability Assessment
Purpose & Capability
Name/description (SQLite long-term memory) match the included scripts and hooks: the package reads OpenClaw session JSONL files, writes a local SQLite DB and a plaintext cache, registers an MCP server exposing memory tools, and can register an hourly auto-compress cron. Optional environment variables are relevant to paths and limits. Minor inconsistency: registry metadata states "instruction-only / no install spec" while the package actually contains multiple executable scripts and a hook.
Instruction Scope
SKILL.md and the scripts explicitly read full session transcripts (~/.openclaw/agents/main/sessions/*.jsonl), run model extraction via the openclaw CLI, write selected memories to the DB, and (by default) overwrite/wipe session files >24h after confirming compression. These behaviors are documented in the skill (privacy-sensitive) and are within the stated purpose, but they are high-impact operations (reading full transcripts and destructive wipes) and should be considered before enabling auto-compression.
Install Mechanism
No external downloads or strange installers are present — the code is local Python/Node hook scripts that run via the OpenClaw runtime. However, the registry/metadata claiming
Credentials
The skill requests only python3 as a required binary and lists reasonable optional env vars (OPENMEM_DB, OPENMEM_SESSIONS_DIR, OPENMEM_BOOTSTRAP_LIMIT, OPENMEM_COMPRESS_INACTIVITY). It does not require unrelated credentials or secret env variables; model inference is invoked via the openclaw CLI so provider auth is handled by OpenClaw rather than the skill.
Persistence & Privilege
The setup registers an MCP server and an hourly cron job with the OpenClaw gateway, giving the skill ongoing ability to read session files and write the DB/cache. While this is coherent with its function, the combination of ongoing session access plus automatic wiping of original session files (by default) is a high-impact capability that users should explicitly consent to and backup for. The skill does not set always:true, but it does create persistent registrations in the gateway.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install openmem - After installation, invoke the skill by name or use
/openmem - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.2.5
- Addressed the VT complaints.
v1.2.4
OpenMem v1.2.4
- Changed compression model integration to use `openclaw capability model run`; OpenClaw now manages provider selection and authentication internally.
- Removed direct reads of `openclaw.json` and `apiKey` from the filesystem; no credentials are accessed by this skill.
- Updated documentation and metadata to reflect these changes and to clarify reduced credential access.
- Minor cleanup of unused environment variables and read/write declarations.
v1.2.3
**This release adds explicit declarations of filesystem and credential access.**
- New metadata fields describe all files read and written by OpenMem, including database, cache, state, and log files.
- "credentialAccess" now documents that API keys are read from `openclaw.json` for session compression.
- A new "Filesystem & Credential Access" section has been added to the documentation, detailing all inputs, outputs, and environment overrides.
- No code or behavior changes—documentation and metadata only.
v1.2.2
**OpenMem v1.2.2** — Updated privacy notice for session compression.
- Clarified behavior of automated compression: now states that `auto_compress.py` reads your OpenClaw agent’s configured model provider from `~/.openclaw/openclaw.json` for memory extraction, potentially sending transcripts to a cloud API.
- Updated privacy section to remove references to Ollama-specific URLs and environment variables.
- Generalized wording to reflect support for multiple model providers during auto-compression.
- No other functionality changes described.
v1.2.1
OpenMem v1.2.1 is a minor update with documentation changes only.
- Skill description and documentation have been condensed and clarified.
- Added support for array of Ollama available models. Compression requires at least one Ollama model to be loaded.
- All existing workflows, commands, and integration points are unchanged.
v1.2.0
**Emphasizes privacy and network behavior, clarifies auto-compression effects:**
- Expanded Privacy & Scope section highlighting that session transcripts are fully read during compression; only selected memories are stored.
- Explicit warning that automated compression irreversibly destroys session files older than 24h (with option to disable).
- Noted possible network calls during auto-compression if Ollama is configured to a remote URL, and how to control/disable them.
- Clarified that both local cache and database files are plaintext and share the same trust level.
- Minor rewording for transparency and clearer user expectations; no tool/API changes.
v1.0.12
OpenMem v1.2.0 introduces automatic session compression with advanced deduplication and manual controls.
- Added scripts/auto_compress.py for automatic hourly session compression with deduplication and logging.
- Auto-compression checks inactivity, ensures no frequent runs, deduplicates memories, and updates the DB before wiping session files.
- New CLI options: --force, --dry-run, --no-wipe for auto_compress.py.
- Updated documentation for new compression workflow and expanded environment variables for compression tuning.
- Importance-based deduplication now defaults to enabled, minimizing duplicate entries in long-term memory.
v1.0.11
OpenMem v1.1.0 — Adds OpenAuto integration and improved documentation
- OpenAuto integration: OpenAuto now uses OpenMem for long-term memory storage, searching, and session compression when both are installed.
- Clarified that OpenMem’s MCP server enables native tool calls and handles FTS-ranked search.
- Expanded usage notes for integration, bootstrap injection, and workflow between OpenMem and OpenAuto.
- Documentation now concisely summarizes categories, compression workflow, privacy, and relevant environment variables.
- No code changes; this update is documentation/metadata only.
v1.0.10
- Added automated skill removal.
v1.0.9
- Corrected the uninstaller parameters.
v1.0.8
OpenMem v1.0.8
- Setup process no longer registers a background cron job; compression is now on-demand only.
- Updated installation instructions to clarify on-demand compression and MCP server registration.
- General documentation cleanup for greater clarity around setup and workflow.
v1.0.7
- Removed background inactivity-based auto-compression; compression must now be triggered manually.
- Deleted the auto-compression cron job documentation and related scripts (`idle_check.py` and hook documentation).
- Updated documentation to reflect on-demand compression workflow.
- No changes to the core memory CRUD/search functionality.
- Installation and uninstall steps remain the same.
v1.0.6
OpenMem v1.0.6
- Clarified that during compression, the agent sees the full raw session content (via compress.py read), but only selected memories are written to the database.
- Noted that a plaintext cache file (openmem-cache.json) is written after every memory write, with the same local security as the DB.
- Updated privacy and scope details to explicitly state session access and file handling.
- Restated that OpenMem persists only selected items, not full transcripts.
- No functionality changes; documentation and privacy clarifications only.
v1.0.5
- Updated tags.
v1.0.4
- Added uninstall script (scripts/uninstall.py) to cleanly remove cron job, MCP server, and bootstrap hook.
- Uninstall now preserves your memory database and prints its path for manual export or removal.
- Updated documentation with uninstall instructions and clarified removal behavior.
v1.0.3
- Added wildcard search support for memories.
v1.0.2
- Expanded documentation to clarify that all data stays fully local and no network calls are ever made.
- Added a new "Privacy & Scope" section detailing session reading, persistent components, and instructions for disabling OpenMem.
- Fixed a security issue with env expansion when installing the skill.
v1.0.1
Corrected the schema to comply with OpenClaw security suggestions.
v1.0.0
Initial release of OpenMem: a long-term memory skill for OpenClaw agents.
- Persistent, local memory storage using SQLite FTS5 — no external services.
- CLI and tool calls for adding, searching, updating, deleting, and listing memories.
- Supports session compression: extract and summarize key facts, insights, or preferences from agent sessions.
- Automatic memory extraction via a configurable cron job based on user inactivity.
- Bootstrap hook preloads top memories into agent context at session start.
- Adjustable memory importance scoring, categories, and environment-based configuration.
- MIT licensed; free to use, modify, and redistribute.
Metadata
Frequently Asked Questions
What is OpenMem - Longterm Compressed Memory?
SQLite long-term memory compression system for extended memory life. Adds tools for agents to control their memory functions. It is an AI Agent Skill for Claude Code / OpenClaw, with 191 downloads so far.
How do I install OpenMem - Longterm Compressed Memory?
Run "/install openmem" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is OpenMem - Longterm Compressed Memory free?
Yes, OpenMem - Longterm Compressed Memory is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does OpenMem - Longterm Compressed Memory support?
OpenMem - Longterm Compressed Memory is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created OpenMem - Longterm Compressed Memory?
It is built and maintained by danavfrost (@danavfrost); the current version is v1.2.5.
More Skills