Better Memory

One-shot smart installation and ongoing maintenance for a native OpenClaw memory stack with L1 daily logs (`memory/YYYY-MM-DD.md`), L2 sidecar summaries, and...

Security Scan

The skill's code and instructions align with its stated purpose: it is a local, file-based memory management toolkit that only reads/writes workspace files and a sidecar directory and does not request credentials or network access.

Purpose & Capability

Name/description (better memory, L1/L2/L3 workflows) match the included scripts. Required binaries (python3) are appropriate. The scripts only touch workspace paths (memory/, MEMORY.md, AGENTS.md, HEARTBEAT.md) and a sidecar directory (.openclaw-memory-os), which is consistent with the stated purpose.

Instruction Scope

SKILL.md and the scripts instruct the agent to run local Python commands that create/modify workspace files and sidecar artifacts. The runtime instructions and code only reference local filesystem paths and settings; they do not read unrelated system files, environment variables, or send data to external endpoints.

Install Mechanism

No install spec — this is instruction/code-only and requires python3 on PATH. All code is included in the package (no external downloads or package installs), so there is no hidden remote install step.

Credentials

No environment variables, credentials, or config paths are requested. The scripts save state and settings under .openclaw-memory-os and modify workspace files only, which is proportionate to the skill's stated functionality.

Persistence & Privilege

The skill writes persistent files in the workspace and a sidecar directory and inserts managed blocks into AGENTS.md, MEMORY.md, HEARTBEAT.md during bootstrap; it also provides an uninstall script to remove those managed blocks and (optionally) the sidecar directory. 'always' is false and model invocation is not disabled — the skill does not demand elevated platform privileges beyond typical skill behavior.

Assessment

This skill is coherent and appears to do what it claims, but it is file-modifying: it will create/modify .openclaw-memory-os, write managed blocks in AGENTS.md/MEMORY.md/HEARTBEAT.md, and append entries to memory/YYYY-MM-DD.md. Before installing or running smart_install.py: 1) Back up or commit your workspace (git) so you can review/revert changes. 2) Inspect the generated migration plan and cron-template before enabling any scheduled jobs. 3) Run smart_install and other scripts in a safe/test workspace first if you have important existing memory files. 4) The tool is local-only (no network/credentials), but it will persist changes to your repository — review apply-summary-* and plan JSON files before applying monthly cleanup actions.

Better Memory V2

Smart Install (Recommended)

Run once to inject memory capability additively and generate migration + schedule artifacts:

python3 skills/better-memory/scripts/smart_install.py --workspace .

Supported install customization:

• --daily-time HH:MM (default 22:00)
• --weekly-day MON..SUN (default SUN)
• --weekly-time HH:MM (default 20:00)
• --monthly-day 1..31 (default 1)
• --monthly-time HH:MM (default 10:00)
• --entry-threshold N (default 8)

Memory Layers

• L1 (native): memory/YYYY-MM-DD.md
• L2 (sidecar): .openclaw-memory-os/l2/{experience,value,standard}.md
• L3 (native): managed block in MEMORY.md

Typed taxonomy:

• experience: think, say, do
• value: good, bad
• standard: right, wrong

Commands

• Capture L1 typed memory: python3 skills/better-memory/scripts/capture_memory.py --workspace . --kind <experience|value|standard> --axis <axis> --topic "<topic>" --statement "<statement>"
• Daily review (L1 -> L2): python3 skills/better-memory/scripts/run_daily_review.py --workspace .
• Weekly rollup (L2 -> L3): python3 skills/better-memory/scripts/run_weekly_rollup.py --workspace .
• Monthly advisory review (no auto cleanup): python3 skills/better-memory/scripts/run_monthly_review.py --workspace .
• Apply approved monthly cleanup actions: python3 skills/better-memory/scripts/apply_monthly_cleanup.py --workspace . --rerollup
  • This command also writes an apply summary in .openclaw-memory-os/reviews/apply-summary-*.md.
• Emit cron template: python3 skills/better-memory/scripts/emit_cron_template.py --workspace .
• Legacy migration plan prepare/apply:
  • python3 skills/better-memory/scripts/promote_legacy_memory.py --workspace . --prepare
  • python3 skills/better-memory/scripts/promote_legacy_memory.py --workspace . --apply

Compatibility command:

• python3 skills/better-memory/scripts/refine_memory.py --workspace .
  • Runs daily review then weekly rollup in one command.

Installation Policy

• Preserve existing AGENTS.md, MEMORY.md, and daily logs.
• Write only managed blocks in AGENTS.md, MEMORY.md, and optional HEARTBEAT.md.
• Keep sidecar artifacts outside native memory/ so memory_search behavior stays clean.
• Generate migration review and editable migration plan; do not auto-import legacy lines unless enabled.

Monthly Cleanup Policy

• Monthly script only produces a report and suggested actions.
• Monthly script also produces a disabled-by-default cleanup plan JSON.
• Do not auto-delete or auto-rewrite memory on monthly review.
• Resolve conflicts and bloat with user confirmation, enable selected plan actions, then apply.

References

Read references/memory-schema.md for schema and lifecycle details.