核心用法
Clever Compact 是一款面向 OpenClaw 高级用户的原生 Context Engine 插件,通过两个确定性钩子解决 AI 助手的记忆连续性难题:
1. `compact()` 钩子:在每次上下文压缩前自动写入结构化状态文件,捕获活跃工作流、关键决策、待办任务和关系上下文
2. `assemble()` 钩子:在每次会话启动(包括 /new 和压缩恢复后)自动读取最近 72 小时内的状态文件,注入系统上下文
安装后零配置运行,无需修改 AGENTS.md,无需依赖心跳定时器。
显著优点
- 确定性保障:OS 级钩子确保 100% 执行,消除竞态条件和定时依赖
- 三大故障根治:
/new amnesia:新会话自动恢复上下文compaction loss:压缩前自动保存,恢复后无缝衔接memory drift:结构化状态文件持久化关键决策- 零侵入安装:v2 作为原生插件,无需 AGENTS.md 手术
- 压缩频率可调:通过
reserveTokens参数可将压缩触发点从 ~150k 推迟到 ~185k tokens,减少 3-4 倍压缩频率 - 状态文件人类可读:Markdown 格式,支持手动审计和编辑
- 免费且活跃维护:Axiom Stream Group 自用产品,持续迭代
潜在局限
- 版本门槛严格:要求 OpenClaw ≥ 2026.3.7,旧版本无法使用 v2
- 72 小时窗口期:超期状态文件自动忽略,长期休眠会话需手动触发保存
- 单平台绑定:专为 OpenClaw 生态设计,迁移至其他框架需重构
- 状态文件堆积:高频使用场景下
memory/目录可能积累大量历史文件,需定期清理
适合人群
- 重度 OpenClaw 用户,每日多会话、长周期复杂任务
- 需要上下文连续性的专业场景(客户演示、实时部署、关键决策追踪)
- 对压缩导致的"中场失忆"感到困扰的 power user
- 团队协作场景,需要维护共享决策记忆和任务状态
常规风险
- 插件权限:作为原生插件需列入
plugins.allow名单,建议审计代码后授予 - 状态文件敏感性:可能包含 API 密钥指针、任务细节和关系上下文,需确保
memory/目录访问控制 - 压缩等待时间:插件不消除压缩本身的 10 分钟冻结期,仅确保恢复连续性
- 迁移成本:v1 用户需手动清理 AGENTS.md 和心跳条目,存在配置中断风险