Context Hygiene

🧼 上下文瘦身专家 · Token 精算师

通过文件预算、决策坍缩与幽灵上下文清理,为 OpenClaw 智能体维持精简高效的推理上下文,避免 token 浪费与上下文膨胀。

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

使用说明

核心用法

Context Hygiene 是一套专为 OpenClaw 智能体设计的上下文卫生协议,核心理念是"保留结论,移除脚手架"。它要求每个任务遵循"探索→决策→坍缩"三阶段:研究调试后达成结论,立即删除探索过程,仅保留决策记录。协议提供严格的文件预算体系(MEMORY.md ≤50 行、日记忆 ≤30 行、总计 <300 行),并配套每日记忆写入规则、MEMORY.md 修剪规则、子代理隔离机制、幽灵上下文清理、会话生命周期管理等完整操作规范。

显著优点

1. token 效率极致化:通过截断命令输出、精简 API 请求、禁止存储已交付内容,显著降低每会话成本
2. 决策质量提升:幽灵上下文清理避免智能体基于过期信息推理,减少"过去状态偏见"

3. 可预测性:文件预算制让上下文规模可控,避免意外膨胀导致的性能骤降

4. 协作友好:明确的格式规范(bullet 列表、单行事实)便于人类审阅与版本控制

5. 生命周期管理:85% 窗口使用率触发新会话,防止边际效益递减

潜在缺点与局限

  • 纪律成本高:需要严格执行"探索即删除",团队成员若习惯传统日志模式会有阻力
  • 信息追溯受限:删除探索过程后,复杂决策的推理链条不可复查, debugging 困难
  • 预算僵化风险:固定行数限制可能不适合信息密度差异大的项目
  • 子代理开销:频繁 spawn 子代理可能引入协调成本,轻量探索反而 overhead 更高
  • 工具生态依赖:部分输出截断语法(jq、head)假设 Unix 环境,Windows 用户需适配

适合人群

  • 高频使用 OpenClaw 的开发者与团队
  • token 成本敏感的生产环境
  • 上下文窗口受限(如 Claude 3.5 Sonnet 200K)的场景
  • 多文件协作、记忆持久化需求强的自动化工作流

常规风险

1. 过度坍缩:激进删除导致关键背景丢失,后续任务重复探索
2. 幽灵残留:引用已删除文件或工具的路径未清理,造成静默错误

3. 时区配置遗漏:USER.md 未显式设置 timezone 导致定时任务错乱

4. 并发会话污染:多会话同时写入 MEMORY.md 可能产生冲突(需外部锁机制)

5. 预算误判:行数≠token 数,高密度 Markdown 表格可能快速消耗预算

最佳实践建议

  • 将自检清单(heartbeat rotation)设为每日自动提醒
  • 使用 ancc validate 验证配置合规性
  • 新团队先运行 2 周宽松预算,再收紧至标准值

Context Hygiene 内容

手动下载zip · 3.7 kB
skill-card.mdtext/markdown
请选择文件