← 返回 Skills 市场
182
总下载
0
收藏
0
当前安装
16
版本数
在 OpenClaw 中安装
/install memory-engine-3layer
功能描述
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...
安全使用建议
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.
功能分析
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.
能力标签
能力评估
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.
如何使用
- 确保已安装 OpenClaw(本地或 Docker 部署)
- 在对话框中输入安装命令:
/install memory-engine-3layer - 安装完成后,直接呼叫该 Skill 的名称或使用
/memory-engine-3layer触发 - 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
版本历史
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.
元数据
常见问题
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... 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 182 次。
如何安装 Memory Engine?
在 OpenClaw 或 Claude Code 对话框中运行命令「/install memory-engine-3layer」即可一键安装,无需额外配置。
Memory Engine 是免费的吗?
是的,Memory Engine 完全免费,采用 MIT-0 许可证,可自由下载、安装和使用。
Memory Engine 支持哪些平台?
Memory Engine 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(cross-platform)。
谁开发了 Memory Engine?
由 ZackO2o(@zacko2o)开发并维护,当前版本 v6.0.0。
推荐 Skills