Clever Compact

🧠 终结 AI 失忆症,会话永连续

原生 OpenClaw 插件,通过确定性钩子解决 /new 失忆、压缩丢失和记忆漂移三大故障模式,确保会话连续性。

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

使用说明

核心用法

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 和心跳条目,存在配置中断风险

Clever Compact 内容

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