核心用法
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 开发并自用,属于社区实践型工具。无独立安全审计报告(提供的认证报告为系统占位),但设计透明、代码可审查,适合具备技术判断力的用户采用。