上下文清理（仅审计）

此技能识别导致提示上下文臃肿的内容，并将其转化为安全、可逆的计划。

合约

• 默认仅审计。
• 无自动删除。
• 无无人值守的配置编辑。
• 无静默的定时任务/会话清理。
• 如果您要求进行更改，该技能应提出：
  1. 具体更改内容，
  2. 预期影响，
  3. 回滚计划，
  4. 验证步骤。

安全模型

• 不使用执行工具。
• 不使用读取工具。
• 如果您需要进行文件级分析，请手动运行捆绑脚本并粘贴JSON。

快速开始

• /上下文清理→ 审计 + 可执行计划（无变更）

可选的手动报告生成：

python3 scripts/context_cleanup_audit.py --out context-cleanup-audit.json

Windows 变体：

py -3 scripts/context_cleanup_audit.py --out context-cleanup-audit.json

测量什么（权威的，而非感觉）

如果可用，优先选择新会话/上下文 json凭据而非主观主张，如“感觉更精简”。

高信号字段：

• 符合条件的技能
• 技能.提示字符数
• 项目上下文字符数
• 系统提示.字符数
• 提示令牌数

如果无法获得确切的凭据，则回退到排名靠前的违规项 + 变更范围，但要降低置信度标签。

常见违规类别

1. 工具结果转储

   • 过大执行输出
   • 大型阅读输出
   • 长网络获取有效载荷

2. 自动化转录噪音

   • 每次运行都报告“OK”的定时任务
   • 非仅警报类的心跳消息

3. 引导程序重复注入导致的膨胀

   • 过度增长AGENTS.md/MEMORY.md/SOUL.md/USER.md
   • 直接嵌入的长篇运行手册SKILL.md

4. 环境专家界面

   • 过多始终可见的专家技能，这些技能本应作为按需工作器/子代理存在

5. 摘要累积

   • 重复的摘要保留了历史细节，而非仅包含重启关键信息

推荐的剪裁阶梯（风险从低到高）

阶段一 —— 静默规范

• 让无操作自动化真正静默（成功时无回复或什么都不输出）。
• 尽可能让警报在带外处理。

阶段二 —— 启动精简

• 保持始终注入的文件简短。
• 将长篇指引移至参考资料/、记忆/或外部笔记中。

阶段三 —— 环境界面缩减

• 从常驻提示界面中移除低频专业技能。
• 对于专业流程，优先调用工作器/子代理。

阶段四 —— 高风险变更

• 工具界面或更深层的运行时/配置收窄。
• 仅在具备更强回滚机制和明确批准的情况下提出。

工作流程（审计 → 规划）

步骤0 —— 确定范围

你需要：

• 工作空间目录
• 状态目录 (<OPENCLAW_STATE_DIR>)

常见默认位置：

• macOS/Linux：~/.openclaw
• Windows：%USERPROFILE%\.openclaw

步骤 1 — 运行审计脚本

python3 scripts/context_cleanup_audit.py --workspace . --state-dir <OPENCLAW_STATE_DIR> --out context-cleanup-audit.json

解读速查表：

• 大型工具输出 → 日志膨胀
• 大量定时/系统日志行 → 自动化膨胀
• 大型引导文档 → 重复注入膨胀

步骤 2 — 制定修复计划

包含：

• 主要问题项
• 优先实施风险最低的修复
• 预期影响
• 回滚说明
• 验证计划

步骤 3 — 验证

变更后：

• 确认自动化在成功时保持静默
• 检查上下文增长趋于平缓
• 如果可能，比较新会话/context json之前/之后

重要注意事项

许多OpenClaw运行时在每个会话中都会对技能/引导程序进行快照。 因此技能/配置的瘦身通常不完全适用于当前会话。 使用新会话进行权威验证。

参考文献

• references/out-of-band-delivery.md
• references/cron-noise-checklist.md