Better Memory V2
Smart Install (Recommended)
Run once to inject memory capability additively and generate migration + schedule artifacts:
INLINECODE0
Supported install customization:
- -
--daily-time HH:MM (default 22:00) - INLINECODE3 (default
SUN) - INLINECODE5 (default
20:00) - INLINECODE7 (default
1) - INLINECODE9 (default
10:00) - INLINECODE11 (default
8)
Memory Layers
- - L1 (native): INLINECODE13
- L2 (sidecar): INLINECODE14
- L3 (native): managed block in INLINECODE15
Typed taxonomy:
- -
experience: think, say, INLINECODE19 - INLINECODE20 :
good, INLINECODE22 - INLINECODE23 :
right, INLINECODE25
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.
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
- INLINECODE34
Compatibility command:
- 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.
更好记忆 V2
智能安装（推荐）
运行一次即可增量注入记忆能力，并生成迁移及调度工件：
python3 skills/better-memory/scripts/smart_install.py --workspace .
支持的安装自定义选项：
- - --daily-time HH:MM（默认 22:00）
- --weekly-day MON..SUN（默认 SUN）
- --weekly-time HH:MM（默认 20:00）
- --monthly-day 1..31（默认 1）
- --monthly-time HH:MM（默认 10:00）
- --entry-threshold N（默认 8）
记忆层级
- - L1（原生）：memory/YYYY-MM-DD.md
- L2（伴生文件）：.openclaw-memory-os/l2/{experience,value,standard}.md
- L3（原生）：MEMORY.md 中的托管块
类型分类：
- - experience：think、say、do
- value：good、bad
- standard：right、wrong
命令
python3 skills/better-memory/scripts/capture_memory.py --workspace . --kind
--axis --topic --statement
python3 skills/better-memory/scripts/rundailyreview.py --workspace .
python3 skills/better-memory/scripts/runweeklyrollup.py --workspace .
python3 skills/better-memory/scripts/runmonthlyreview.py --workspace .
python3 skills/better-memory/scripts/applymonthlycleanup.py --workspace . --rerollup
- 此命令还会在 .openclaw-memory-os/reviews/apply-summary-*.md 中写入应用摘要。
python3 skills/better-memory/scripts/emitcrontemplate.py --workspace .
- python3 skills/better-memory/scripts/promotelegacymemory.py --workspace . --prepare
- python3 skills/better-memory/scripts/promotelegacymemory.py --workspace . --apply
兼容命令：
- - python3 skills/better-memory/scripts/refine_memory.py --workspace .
- 通过一条命令依次执行每日回顾和每周汇总。
安装策略
- - 保留现有的 AGENTS.md、MEMORY.md 和每日日志。
- 仅在 AGENTS.md、MEMORY.md 和可选的 HEARTBEAT.md 中写入托管块。
- 将伴生工件保留在原生 memory/ 目录之外，以保持 memory_search 行为的整洁。
- 生成迁移审查和可编辑的迁移计划；除非启用，否则不会自动导入旧版记录。
每月清理策略
- - 每月脚本仅生成报告和建议操作。
- 每月脚本还会生成一个默认禁用的清理计划 JSON。
- 每月回顾时不自动删除或重写记忆。
- 在用户确认后解决冲突和冗余，启用选定的计划操作，然后应用。
参考资料
阅读 references/memory-schema.md 了解架构和生命周期详情。
