← 返回 Skills 市场
danavfrost

OpenMem - Longterm Compressed Memory

作者 danavfrost · GitHub ↗ · v1.2.5 · MIT-0
cross-platform ✓ 安全检测通过
191
总下载
1
收藏
0
当前安装
19
版本数
在 OpenClaw 中安装
/install openmem
功能描述
SQLite long-term memory compression system for extended memory life. Adds tools for agents to control their memory functions.
安全使用建议
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.
功能分析
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.
能力评估
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.
如何使用
  1. 确保已安装 OpenClaw(本地或 Docker 部署)
  2. 在对话框中输入安装命令:/install openmem
  3. 安装完成后,直接呼叫该 Skill 的名称或使用 /openmem 触发
  4. 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
版本历史
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.
元数据
Slug openmem
版本 1.2.5
许可证 MIT-0
累计安装 0
当前安装数 0
历史版本数 19
常见问题

OpenMem - Longterm Compressed Memory 是什么?

SQLite long-term memory compression system for extended memory life. Adds tools for agents to control their memory functions. 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 191 次。

如何安装 OpenMem - Longterm Compressed Memory?

在 OpenClaw 或 Claude Code 对话框中运行命令「/install openmem」即可一键安装,无需额外配置。

OpenMem - Longterm Compressed Memory 是免费的吗?

是的,OpenMem - Longterm Compressed Memory 完全免费,采用 MIT-0 许可证,可自由下载、安装和使用。

OpenMem - Longterm Compressed Memory 支持哪些平台?

OpenMem - Longterm Compressed Memory 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(cross-platform)。

谁开发了 OpenMem - Longterm Compressed Memory?

由 danavfrost(@danavfrost)开发并维护,当前版本 v1.2.5。

💬 留言讨论