Clever Compact

🧠 会话记忆永不丢失,压缩无忧恢复

Clever Compact 通过预压缩扫描和结构化状态文件解决 OpenClaw 三大记忆故障:/new 失忆、压缩丢失和记忆漂移,实现会话间无缝恢复。

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

使用说明

核心用法

Clever Compact 是一款面向 OpenClaw 高级用户的记忆持久化技能,通过「预压缩扫描 + 结构化状态文件」机制解决 AI 助手在长期会话中的记忆丢失问题。

安装流程:将 SKILL.md、pre-compact-scan.md 脚本和 compact-state.json 模板放入指定目录,并在 AGENTS.md 中配置两条关键指令——会话恢复时自动读取最新状态文件,以及上下文达到 75% 阈值时触发预压缩扫描。

工作流程:当触发条件满足(手动指令或上下文阈值),代理执行结构化提取,捕获活跃工作流、关键决策、待办任务、凭证指针、关系上下文和用户标记;输出写入时间戳标记的 Markdown 文件。压缩或 /new 会话后,代理优先读取该文件,以单行摘要确认恢复状态,无需用户重复背景。

性能优化:提供 reserveTokens 调参指南,将默认值 50,000 降至 15,000,可将压缩频率降低 3–4 倍,显著减少长达 10 分钟的压缩等待时间。

显著优点

1. 解决真实痛点:精准定位 /new 失忆、压缩丢失、记忆漂移三大高频故障,语言贴合资深用户实际体验
2. 零成本完整功能:1.3.0 版本全面免费,无功能阉割

3. 非侵入式设计:无需修改 OpenClaw 核心,纯配置化实现

4. 可审计的状态文件:Markdown + 嵌入 JSON 格式,人工可读、版本可控

5. 主动风险缓解:提供压缩频率调优方案,将被动等待转化为主动管理

潜在缺点与局限性

  • 依赖用户自律:状态文件需手动配置触发,无自动后台守护
  • 格式而非协议:状态文件为文档级方案,非官方 API 支持,存在被未来版本变更破坏的风险
  • 压缩不可禁用:仅为缓解策略,无法从根本上消除 OpenClaw 的强制压缩机制
  • 存储管理负担:长期运行产生时间序列文件,需定期清理避免目录膨胀

适合人群

  • 每日运行多轮次、跨日会话的 OpenClaw 重度用户
  • 从事客户端演示、实时部署等 时间敏感场景 的开发者
  • 需要维护复杂多线程工作流、依赖历史决策上下文的 项目管理者和工程师
  • 对「重复解释背景」感到疲惫的 效率导向型用户

常规风险

  • 配置漂移风险:AGENTS.md 指令被覆盖或遗忘将导致恢复机制失效
  • 状态文件过时:若用户跳过手动扫描、依赖自动阈值,可能在关键决策前触发压缩导致信息截断
  • 隐私暴露:状态文件包含关系上下文和任务描述,需确保 memory/ 目录访问控制
  • 误恢复风险:多项目并行时,若文件命名冲突或读取错误,可能恢复至错误上下文

来源与可信度评估

由 Axiom Stream Group 开发并自用,属于社区实践型工具。无独立安全审计报告(提供的认证报告为系统占位),但设计透明、代码可审查,适合具备技术判断力的用户采用。

Clever Compact 内容

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