核心用法
Clever Compact 是一款针对 OpenClaw 平台的原生记忆持久化插件,专门解决三大记忆失效场景:/new 命令后的会话失忆、上下文压缩触发时的任务中断遗忘、以及隔夜会话的历史决策丢失。
安装配置:四步完成——通过 ClawHub 安装、在 openclaw.json 中启用插件、加入允许列表、重启网关。配置完成后,会话恢复功能自动生效,无需人工干预。
核心机制:
- 自动会话恢复:每次会话开始时(包括
/new和压缩后),插件检测 72 小时内生成的压缩状态文件,在首条消息中将内容注入为系统上下文,使代理立即恢复状态。 - 状态写入:由于 OpenClaw 尚未开放压缩前生命周期钩子,写入需显式触发——支持手动命令、HEARTBEAT 规则或定时任务三种方式,也可通过 API 编程调用。
与 memory-core 协同:两者功能互补,Clever Compact 负责跨会话状态注入,memory-core 负责会话内搜索工具与 dreaming。OpenClaw 2026.5.2+ 需关闭 memory-core 的 memoryFlush 以避免冲突。
显著优点
1. 零开销设计:仅在首条消息注入一次,无每轮 Token 消耗,显著优于轮询式记忆方案
2. 原生插件架构:直接集成 OpenClaw 插件系统,稳定性高于纯 skill 实现
3. 72 小时容错窗口:合理的状态保鲜期,平衡记忆新鲜度与存储效率
4. 多触发方式灵活适配:手动、心跳、定时、API 四种写入模式覆盖不同工作流
5. 活跃维护:v2.2.5 版本持续迭代,已修复 OC 2026.5.2 插件加载变更导致的兼容问题
潜在缺点与局限性
- 显式写入依赖:核心痛点——OpenClaw 未暴露压缩前钩子,用户必须主动触发或配置自动化规则,存在遗忘风险
- 文件系统依赖:所有状态持久化于本地
memory/目录,无云同步,多设备使用需自行解决 - 72 小时硬限制:超长间隔会话(如休假后)将触发完全冷启动
- 版本门槛:仅支持 OpenClaw 2026.4.10+,旧版本用户无法使用
- 与其他记忆插件冲突:需手动配置避免重复注入,对非技术用户有一定认知负担
适合人群
- 长期运行复杂项目的 OpenClaw 重度用户
- 依赖跨会话上下文连续性的 Agent 工作流设计者
- 对 Token 成本敏感、拒绝每轮记忆查询开销的效率优先者
- 愿意投入 10-15 分钟完成配置、建立自动化规则的动手型用户
常规风险
1. 配置错误导致记忆丢失:若未正确设置写入触发,压缩事件将造成不可逆状态丢失
2. 状态文件膨胀:高频写入可能产生大量历史文件,需定期清理
3. 敏感数据本地存储:状态文件以明文存放于工作区,共享环境需注意访问控制
4. 插件冲突:与 memory-core 等同类工具同时启用可能导致上下文重复注入,需严格遵循官方配置指南
5. 上游变更风险:依赖 OpenClaw 插件 API,未来版本若调整 before_prompt_build 等钩子可能影响兼容性
总体评估
Clever Compact 是 OpenClaw 生态中技术实现最成熟的记忆持久化方案之一,其原生插件架构和零 Token 开销设计具有显著工程优势。然而,"显式写入"这一设计妥协意味着它更适合愿意建立自动化规则的中高级用户,而非追求完全无感的开箱即用体验者。对于每日高频使用 OpenClaw 的专业场景,该插件的收益远大于配置成本。