Clever Compact

🧠 原生记忆恢复插件 · 零 Token 开销

Clever Compact 是一款原生 OpenClaw 插件,自动解决会话断开后记忆丢失问题,通过状态注入实现跨会话记忆恢复,零每轮 Token 开销。

收藏
5.1k
安装
1.3k
版本
2.2.5
CLS 安全扫描中
预计需要 3 分钟...

使用说明

核心用法

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 的专业场景,该插件的收益远大于配置成本。

Clever Compact 内容

scripts文件夹
templates文件夹
手动下载zip · 14.8 kB
pre-compact-scan.mdtext/markdown
请选择文件