context-clean-up

核心用法

context-clean-up 是 OpenClaw 生态的运维型技能，采用「审计→规划→应用」三段式工作流：

1. 审计阶段：通过 context_cleanup_audit.py 脚本扫描会话转录本，识别三大膨胀源——工具返回结果（exec/read/web_fetch 的冗长输出）、高频自动化噪音（Cron 心跳/定时任务的无意义日志）、以及重复注入的引导文档（MEMORY.md 等规则文件）。

2. 规划阶段：生成低风险的优化方案，核心杠杆包括：

• Lever A：将无操作的 cron 任务输出强制改为 NO_REPLY
• Lever B：用户通知类任务采用「外部渠道投递 + NO_REPLY」模式，避免转录本污染
• Lever C：将低频使用的规则迁移至 memory/*.md，仅保留重启关键规则在 MEMORY.md
• Lever D：运行 session_gc.py 清理超过保留期的失效会话键和孤儿日志文件

3. 应用阶段（需用户显式确认）：执行带 .bak.<date> 备份的安全编辑，将高频噪音 cron 静默化，并采用「移动归档」而非硬删除的策略处理历史日志。

显著优点

• 成本直接可控：减少无效上下文可直接降低 LLM API 调用费用
• 防御 context overflow：系统性解决长周期代理最常见的失效模式
• 零侵入架构：NO_REPLY 模式与现有 cron/heartbeat 兼容，无需重构业务逻辑
• 可逆操作：所有变更带时间戳备份，支持快速回滚

潜在局限

• 人工确认门槛：实际清理操作需用户明确授权，无法全自动执行
• 边界识别依赖启发式：区分「必要日志」与「噪音」依赖规则匹配，可能误判某些边缘场景
• 对「报告类」任务处理保守：为避免漏掉用户真正关心的通知，默认保留非空输出

适合人群

• 运行超过 7 天的长期 OpenClaw 代理用户
• 高频依赖 cron/heartbeat 自动化但遭遇 Context Overflow 的团队
• 对 Token 成本敏感、需优化边际支出的生产环境

常规风险

• 误静默用户关心的通知：若 cron 任务同时承担「状态汇报」功能，强制 NO_REPLY 可能导致信息黑洞，建议配合外部渠道（Telegram/Slack）投递
• 归档文件堆积：移动孤儿 .jsonl 至备份目录后，长期不清理仍可能占用磁盘，需配合外部存储生命周期策略
• bootstrap 文档压缩过度：若将过多规则移出 MEMORY.md，可能导致代理重启后行为漂移，建议保留「重启临界规则」清单

安全等级说明

技能本身仅执行审计、备份、移动文件等只读或低危写操作，无网络外联、无代码执行漏洞；核心风险在于「误操作导致用户数据不可见」，已通过强制备份和 dry-run 机制缓释。

核心功能

context-clean-up 是 OpenClaw 官方推出的上下文治理 Skill，专门解决长会话代理常见的「上下文膨胀」问题——即自动化任务（cron/心跳/报告）反复向同一会话写入冗长输出，最终触发模型上下文窗口溢出或产生高额 Token 费用。

该 Skill 采用「审计 → 计划 → 应用」三段式工作流：
1. 审计阶段：运行 context_cleanup_audit.py 扫描会话转录，识别三类膨胀源——工具结果（exec/read/web_fetch 的大段输出）、自动化噪音（重复的 System: Cron: 行）、启动文档冗余（过大的 MEMORY.md 等引导文件）。
2. 计划阶段：基于审计结果生成可操作建议，提供四大杠杆：将无操作 cron 输出改为 NO_REPLY、将报告改为「带外投递（如 Telegram）+ NO_REPLY」、精简启动文档、清理闲置会话存储。
3. 应用阶段：仅在用户显式执行 /context-clean-up apply 时执行低风险修改，所有操作均带 .bak.<date> 备份，支持回滚。

显著优点：

• 官方背书：OpenClaw Organization 维护，MIT 协议开源，T2 可信来源
• 纯本地执行：零外部网络请求，仅操作 ~/.openclaw/sessions/ 本地文件
• 风险可控：默认 dry-run，apply 模式强制备份，session GC 采用「移动孤儿文件」而非硬删除
• 成本敏感：直接针对 Token 消耗优化，适合长期运行的生产代理

潜在局限：

• 功能专一：仅解决 OpenClaw 生态内的上下文问题，无法处理其他框架
• 需用户确认：bootstrap 文档压缩等敏感操作需显式授权，自动化程度受限
• Python 3.13 依赖：使用 uv run --python 3.13，环境需预配置

适合人群：

• 运行 7×24 小时 cron/心跳任务的长会话 OpenClaw 代理
• 频繁遭遇「Context overflow」错误的开发者
• 希望优化 Token 成本的企业用户

常规风险：

• 误删活跃会话数据（已缓解：保留 7 天 retention、强制备份）
• cron 静默化后用户遗漏关键告警（已缓解：提供「带外投递」替代方案）
• 路径遍历攻击（已缓解：使用 Path.expanduser().resolve() 校验）