OpenMem - Longterm Compressed Memory

v1.2.5

SQLite long-term memory compression system for extended memory life. Adds tools for agents to control their memory functions.

1· 137·0 current·0 all-time
MIT-0
Download zip
LicenseMIT-0 · Free to use, modify, and redistribute. No attribution required.
Security Scan
VirusTotalVirusTotal
Benign
View report →
OpenClawOpenClaw
Benign
high confidence
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.
Assessment
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.

Like a lobster shell, security has layers — review code before you run it.

cleanvk979kg1eaw2hxrtxne34yn99wx84na1jexpansionvk979kg1eaw2hxrtxne34yn99wx84na1jlatestvk979kg1eaw2hxrtxne34yn99wx84na1jlocalvk979kg1eaw2hxrtxne34yn99wx84na1jlong-termvk979kg1eaw2hxrtxne34yn99wx84na1jmemoryvk979kg1eaw2hxrtxne34yn99wx84na1jopenclawvk979kg1eaw2hxrtxne34yn99wx84na1jpersistencevk979kg1eaw2hxrtxne34yn99wx84na1jsecurevk979kg1eaw2hxrtxne34yn99wx84na1juser-friendlyvk979kg1eaw2hxrtxne34yn99wx84na1j

License

MIT-0
Free to use, modify, and redistribute. No attribution required.

Runtime requirements

🧠 Clawdis
Binspython3

Comments