核心用法
Smart Memory 是一套面向 OpenClaw 代理系统的结构化记忆管理方案，通过 5 层架构分离不同生命周期和作用域的知识：
1. MEMORY.md — 极简核心层（<40 行），仅存用户画像、项目索引、关键规则和代理路由表
2. active-context.md — 活跃上下文层，用 [OPEN]/[DONE] 状态块追踪进行中事项，解决传统 Daily Log 的 48 小时遗忘问题
3. *memory/projects//CONTEXT.md** — 项目手册层，按需注入到子代理任务中
4. memory/agents/<typ>.md — 领域知识层，存储跨项目的代理类型专属经验（多代理场景）
5. Daily Logs — 原始上下文层，保留近期对话痕迹
安装流程包含 8 个强制步骤：目录初始化、MEMORY.md 精简、active-context 创建、项目手册迁移、代理知识配置、启动序列更新、自动化清理设置及验收检查。
显著优点
- 精准解决三大痛点：上下文窗口膨胀、重要规则被淹没遗忘、跨天事项追踪断裂
- 写入即安全：强制要求"动作内写入"（inline persistence），消除会话崩溃导致的数据丢失
- 智能会话修剪：独创 Hash-Handshake 机制，在不影响用户体验的前提下自动清理超长 Channel 会话
- 多代理原生支持：通过 on-demand 注入避免 Orchestrator 上下文污染，Sub-Agent 任务摘要实现跨代理状态同步
潜在局限
- 学习曲线陡峭：涉及 8 个文件、4 个目录、多种状态转换规则，初期配置需要 30-60 分钟专注投入
- 依赖纪律执行：架构效益高度依赖"立即写入"规则的遵守，团队习惯不佳时可能失效
- Heartbeat 复杂度：自动清理、备份验证、会话修剪等自动化逻辑对心跳代理的可靠性要求较高
- 语言锁定风险：文档以德语为主，国际化团队可能产生理解摩擦
适合人群
- 使用 OpenClaw 进行长期项目（>2 周）的开发者或团队
- 遭遇"代理明明看过规则却不遵守"或"三天前聊过的需求需要重讲"问题的用户
- 运行多代理架构、需要 Orchestrator 保持轻量的复杂系统
- 愿意接受结构化约束以换取长期可维护性的工程导向用户
常规风险
- 配置错误导致记忆丢失：若 active-context.md 路径或格式错误，关键上下文可能无法注入会话
- Hash-Handshake 竞态条件：极端情况下 90 秒超时窗口可能与用户活跃使用冲突，触发 Force-Trim
- 跨代理状态不一致：Sub-Agent 未及时发送 SUMMARY 时，Orchestrator 的备份验证可能产生脏数据
- 自动化依赖失效：Heartbeat 停止运行时，记忆层将逐渐膨胀直至性能劣化