← Back to Skills Marketplace
182
Downloads
0
Stars
0
Active Installs
16
Versions
Install in OpenClaw
/install memory-engine-3layer
Description
Memory guardian for OpenClaw — three-layer anti-amnesia with capacity management. v6.0: MEMORY.md soft cap (5000 chars) + USER.md cap (1500 chars) prevent pr...
Usage Guidance
This skill appears to implement the advertised three-layer memory guardian and its local scripts are consistent with that purpose, but it is intrusive and should be installed cautiously. Before installing: 1) Audit the code (especially memory-backup.sh, memory-cron.sh, and memory-auto-extract.js) to confirm you understand what will be read/written and when. 2) Disable or edit the backup/auto-push behavior if you do not want automatic commits/pushes (memory-backup.sh calls 'git push origin main'). 3) Run scripts in dry-run modes where available (many scripts support --dry-run or --stats) and test in an isolated/non-production workspace copy. 4) Inspect and back up your openclaw.json and crontab before running migration or cron installation; migration will modify platform config and the SKILL suggests restarting the gateway. 5) Remove or sanitize any secrets from session transcripts/ workspace that you do not want captured or committed. 6) Prefer explicit opt-in for cron installation (don't blindly pipe into crontab) and review the watcher behavior (.memory/watcher.pid). 7) If provenance matters, request the upstream repository and a signed release or checksum — the package/homepage are unknown in the registry metadata. If you are not comfortable granting this level of filesystem/config access or automatic backups, do not install or disable the cron/backup pieces.
Capability Analysis
Type: OpenClaw Skill
Name: memory-engine-3layer
Version: 6.0.0
The skill bundle implements a 'Memory Guardian' system with high-risk capabilities that exceed typical memory management. Key indicators include the automated exfiltration of the entire workspace—including sensitive files like 'openclaw.json' (which often contains API keys) and system crontabs—to a remote Git repository via 'scripts/memory-backup.sh'. Additionally, 'scripts/memory-cron.sh' installs persistent crontab entries and 'scripts/memory-migrate.js' modifies the global OpenClaw configuration. While these features are documented for disaster recovery purposes, the broad collection of sensitive configuration data and system-level modifications represent a significant security risk.
Capability Tags
Capability Assessment
Purpose & Capability
Name/description match what the files do: scripts read session transcripts, maintain MEMORY.md and per-day logs, run indexing (FTS5), perform compaction/GC, run a watcher daemon, and offer migrate/backup utilities. The requested actions (read/write memory files, index, cron, watcher) are proportionate to a memory guardian.
Instruction Scope
Runtime instructions and scripts access a broad set of local files and system state (HOME workspace, ~/.openclaw openclaw.json, session JSONL files, /etc/timezone), create/modify MEMORY.md and memory/* logs, modify crontab and start a watcher daemon, and auto-extract content from session transcripts. The cron + memory-backup.sh flow can commit and push the entire workspace to the configured git remote. These behaviors are consistent with the stated purpose but are intrusive and could surface sensitive data (session contents, tool outputs) into committed history or snapshots; the SKILL.md does not explicitly call out the push behavior as requiring review or explicit opt-in.
Install Mechanism
No install spec is provided (files are included), so installation is manual: user-run scripts and a crontab entry. The scripts require Node.js and optionally a global 'better-sqlite3' package (SKILL.md documents installing it). There are no downloads from untrusted URLs; the code runs locally, lowering supply-chain risk, but global npm package usage and reliance on 'npm root -g' are moderate operational considerations.
Credentials
The skill declares no required environment variables, but the scripts read many environment values and local config files (OPENCLAW_WORKSPACE, OPENCLAW_TZ, TZ, openclaw.json, session files). Access to session transcripts and workspace files is necessary for a memory system, so this is broadly proportionate — however the backup script will git commit and attempt to push to the repo's 'origin main' (using whatever git credentials exist on the host). That means data can leave the machine via an existing git remote without an explicit credential declared by the skill; users should verify remotes and git credentials before enabling backups.
Persistence & Privilege
The skill's recommended setup modifies system state: it writes a crontab entry, starts a long-running watcher daemon (writes .memory/watcher.pid and logs), and (via memory-migrate.js) modifies OpenClaw configuration (openclaw.json) and asks the user to restart the gateway. These are legitimate for a system-level memory guardian but are high-privilege and persistent actions that change platform configuration and ensure the skill runs periodically without further user interaction. The skill does not set 'always: true' but still gains persistent execution via cron and background processes.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install memory-engine-3layer - After installation, invoke the skill by name or use
/memory-engine-3layer - Provide required inputs per the skill's parameter spec and get structured output
Version History
v6.0.0
v6.0: Capacity management (MEMORY.md 5000 char cap, USER.md 1500 char cap), auto-snapshot before compaction/GC, integrity monitoring with auto-restore, --consolidate command, --user write mode, boot capacity%, inspired by Hermes Agent + OpenClaw Dreaming
v5.0.0
v5.0: Memory Guardian — works alongside native memorySearch. NEW: memory-migrate.js (one-command upgrade/rollback), memory-watcher.sh (session reset detection <30s), active session extraction. ENHANCED: boot auto-detects native mode, search dual-mode (native+FTS5), cron 1h, resume auto-rescue. ZERO BREAKING CHANGES from v3/v4. better-sqlite3 now optional.
v3.0.0
All 6 feedback items: memory-resume.js, auto-extract.js, search --last, maintain --gc, write dedup, session size warning, flush prompt fix
v2.9.0
Token optimization: smart truncation + keyword context search
v2.8.0
Backup + restore scripts for disaster recovery
v2.7.0
Unified timezone from openclaw.json, fix cross-day date mismatch
v2.6.0
Auto-recover corrupted DB + fix date-only search + boot retry
v2.5.0
Fix flush prompt + memory-boot.js + postIndexSync + cron stale detection
v2.4.0
Fix score merging + orphan cleanup + temporal decay 30d->90d
v2.3.0
Unified search: FTS5 + LIKE fallback fixes substring matching
v2.2.1
Fix heartbeat schema + timezone-aware dates + compact safety
v2.2.0
Concurrent-safe writes (file locking), cron auto-compact (monthly), cron log rotation, complete README rewrite
v2.1.0
Date filtering (auto-detect 4月2日/April 2), English phrase matching (2x boost), memory-compact.js (compress old logs 60-70%)
v2.0.2
Finer chunks (300 chars) + TF-density CJK scoring for better Chinese search precision
v2.0.1
Fix: auto-reindex after write (instant search); smart gap counting (only since system install)
v2.0.0
Three-layer anti-amnesia: cron + memory-flush + agent rules. SQLite FTS5 BM25 + CJK bigram search, temporal decay. 0-token search, ~300 token results. 6 scripts: write/search/index/maintain/cron.
Metadata
Frequently Asked Questions
What is Memory Engine?
Memory guardian for OpenClaw — three-layer anti-amnesia with capacity management. v6.0: MEMORY.md soft cap (5000 chars) + USER.md cap (1500 chars) prevent pr... It is an AI Agent Skill for Claude Code / OpenClaw, with 182 downloads so far.
How do I install Memory Engine?
Run "/install memory-engine-3layer" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Memory Engine free?
Yes, Memory Engine is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Memory Engine support?
Memory Engine is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Memory Engine?
It is built and maintained by ZackO2o (@zacko2o); the current version is v6.0.0.
More Skills