← Back to Skills Marketplace
stanistolberg

Openclaw Memory Max

by stanistolberg · GitHub ↗ · v3.0.4 · MIT-0
cross-platform ✓ Security Clean
479
Downloads
0
Stars
0
Active Installs
6
Versions
Install in OpenClaw
/install openclaw-memory-max
Description
SOTA Memory Suite — auto-recall, cross-encoder reranking, multi-hop deep search, causal knowledge graph, episodic memory, and nightly sleep-cycle consolidation.
Usage Guidance
This skill appears to do what it claims, but it gains access to conversation content and can modify the agent's system prompt when specific options are enabled. Before installing: 1) Confirm you trust the upstream source (review package.json and openclaw.plugin.json for dependencies and any network code). 2) Keep enableAutoCapture and enableRulePinning disabled unless you need them; if you enable rule pinning, ensure only trusted processes/users can write ~/.openclaw/memory/MEMORY.md. 3) Inspect the sidecar files (auto_captured.jsonl, episodes.jsonl, utility_scores.json, causal_graph.json) and set file permissions so only your user can read/write them. 4) If you are concerned about privacy or untrusted code, consider running the plugin in an isolated environment or container, or review the full source to ensure there are no unexpected network calls or remote model fetching. If you want, I can scan package.json and the remaining source files for network calls and dependency risk indicators.
Capability Analysis
Type: OpenClaw Skill Name: openclaw-memory-max Version: 3.0.4 The bundle is a sophisticated memory enhancement suite for OpenClaw that implements local cross-encoder reranking, causal knowledge graphs, and automated context injection via lifecycle hooks. It uses standard libraries like @huggingface/transformers and sql.js to perform all operations locally. While it includes an opt-in 'Rule Pinning' feature that allows content from MEMORY.md to be injected as critical constraints into the system prompt (a potential local prompt-injection vector), this is clearly documented as a security risk and disabled by default. No evidence of data exfiltration, unauthorized remote execution, or malicious intent was found across the code or instructions.
Capability Assessment
Purpose & Capability
Name/description match the implementation: the package reads OpenClaw's memory DB (read-only via sql.js), provides cross-encoder reranking, multi-hop search, a causal graph, episodic logging, and a sleep-cycle consolidator. It writes sidecar files under ~/.openclaw/memory and registers lifecycle hooks — all expected for a memory plugin.
Instruction Scope
SKILL.md instructs the plugin to auto-inject <relevant-memories> into the agent context and (optionally) pin YAML rules into the system prompt. It also optionally auto-captures high-value user messages to disk. These behaviors are consistent with the stated purpose but broaden the plugin's access to conversation content and the agent's system prompt when enabled; the doc clearly marks auto-capture and rule-pinning as opt-in.
Install Mechanism
No external download/install URLs in the provided manifest text; code is pure JS/TS with bundled dist and src files and appears to rely on npm dependencies (package.json present). No extract-from-URL installs or arbitrary remote executables were detected in the supplied files. This is a lower-risk install footprint compared with arbitrary binary downloads.
Credentials
The skill requests no credentials or env-vars but reads HOME or OPENCLAW_HOME to access ~/.openclaw/memory and OpenClaw's main.sqlite (read-only). That is proportionate for a memory plugin. However, enabling auto-capture causes the plugin to write user messages to auto_captured.jsonl and episodes.jsonl — a privacy-sensitive behavior that is disabled by default.
Persistence & Privilege
always:false and the skill registers lifecycle hooks (before_agent_start, agent_end, before_compaction, session hooks) — expected for a plugin that proactively injects memories. It can add content to the system prompt (context.addSystemContent) and — if rule-pinning is enabled — pin YAML rules into the system prompt; because rule-pinning is opt-in and documented, this is acceptable but powerful and should be enabled only when you control the MEMORY.md file and trust the plugin.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install openclaw-memory-max
  3. After installation, invoke the skill by name or use /openclaw-memory-max
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v3.0.4
- Improved internal code structure and organization across hooks, weighter, and index modules. - Updated type definitions and distribution build files for better reliability. - Refreshed documentation for clarity in usage and configuration. - No user-facing features or configuration changes.
v3.0.3
- Removed installation script and test schema files (install.sh, test-schema.js) for a lighter package. - Updated configuration and metadata files (README.md, openclaw.plugin.json, package.json) to reflect recent changes. - No changes to user-facing features or documentation content. - Maintenance release focused on cleanup and dependency updates.
v3.0.2
- Changed the default for `enableAutoCapture` to `false` (was `true`) in plugin configuration, requiring explicit opt-in for persistent message logging. - Updated documentation to match the new default for `enableAutoCapture`, clarifying its opt-in nature. - No functional changes to other features or APIs.
v3.0.1
- Added opt-in configuration for YAML rule pinning (disabled by default; controlled via enableRulePinning in plugin config). - Expanded documentation to include configuration options for auto-recall, auto-capture, and rule pinning, all managed via the plugin manifest. - Updated YAML rule pinning section to note that the feature must be explicitly enabled and included a security warning about MEMORY.md access. - No changes to core features or tool APIs; all memory management features remain as before.
v3.0.0
Version 3.0.0 — Major enhancement to memory consolidation and maintenance - Replaced fixed 03:00 "Nightly Sleep Cycle" with an in-process scheduler running consolidation and maintenance every ~24 hours. - Sleep cycle now prunes the causal graph, decays stale utility scores, truncates old logs, and writes consolidation context for the next session. - Updated documentation to reflect new, automated maintenance instead of actionable nightly agent step. - No changes to core memory retrieval, graph, or search tools. - Refined README and SKILL.md to clarify maintenance process and tool usage.
v0.1.0
- Initial release of the Memory Max SOTA memory system for OpenClaw. - Automatic context injection of relevant memories before every turn. - Nightly consolidation, compaction rescue, and episodic memory logging. - Suite of advanced tools: precision multi-hop searching, utility reinforcement/penalty, and causal knowledge graph tracking. - YAML rule pinning for user-defined constraints in the system prompt.
Metadata
Slug openclaw-memory-max
Version 3.0.4
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 6
Frequently Asked Questions

What is Openclaw Memory Max?

SOTA Memory Suite — auto-recall, cross-encoder reranking, multi-hop deep search, causal knowledge graph, episodic memory, and nightly sleep-cycle consolidation. It is an AI Agent Skill for Claude Code / OpenClaw, with 479 downloads so far.

How do I install Openclaw Memory Max?

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

Is Openclaw Memory Max free?

Yes, Openclaw Memory Max is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does Openclaw Memory Max support?

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

Who created Openclaw Memory Max?

It is built and maintained by stanistolberg (@stanistolberg); the current version is v3.0.4.

💬 Comments