Context Slimming
/install context-slimming
Context Slimming
压缩 OpenClaw 工作空间注入上下文,降低每轮对话基础 token 消耗。
核心思路:顶层只留必需,细节按需加载,消除跨文件重复。
原理
OpenClaw 将所有顶层 *.md 文件自动注入到每轮对话的系统提示中。
初始典型注入量约 25,000–32,000 tokens,其中 70%+ 可在不损失能力的前提下移除。
目标
| 阶段 | 典型注入 | 说明 |
|---|---|---|
| 瘦身前 | 25k–32k | 含详细规则/范例/重复内容 |
| 结构拆分后 | 5k–8k | 详细规则 → skill 引用 |
| 文言化(可选) | 4k–6k | 中文描述古典化 |
执行流程
Step 1: 全量扫描
# 列出所有顶层注入文件及大小 (bytes)
wc -c /path/to/workspace/*.md
# 列出总注入量
cat /path/to/workspace/*.md | wc -c
计算 token 估算:UTF-8 bytes / 4 ≈ tokens(英文);中文 / 3 ≈ tokens。
Step 2: 诊断
逐文件检查以下内容:
- BOOTSTRAP.md — 是否可删除?(首次运行完成后即应删除)
- IDENTITY.md — 是否可合并到 SOUL.md?(避免与 SOUL.md 重复)
- 跨文件重复 — 同一概念是否出现在多个文件中?(安全红线、记忆管理、主动性等)
- 详细操作指南 — 是否可移到 skill 引用?(安全审计流程、工作法详解等)
- 代码样例/脚本 — 是否可移到
scripts/目录?(审计脚本、处理脚本等) - 说明性文字 — 比喻、解释、范例是否必要?
- 模板残留 — 是否有未修改的模板文字?(如 "Customize this...")
Step 3: 结构拆分(最大贡献)
顶层注入文件原则:每文件 ≤ 1,500 bytes。只保留:
- 必须每轮知道的信息(身份、红线、启动流程)
- 指向其他资源的引用("按需读 X")
移出内容:
workspace/
├── AGENTS.md # 只留:启动流程 + 安全红线表 + 技能索引
├── SOUL.md # 只留:身份 + 原则 + 边界
├── USER.md # 只留:用户画像摘要 + 沟通策略
├── MEMORY.md # 只留:关键决策摘要 + 错误模式索引
├── TOOLS.md # 只留:凭证位置 + 关键配置
├── HEARTBEAT.md # 只留:心跳检查核心清单
├── rules/ # 详细操作规则(按需读)
│ ├── skill-audit.md
│ ├── memory.md
│ └── workflow.md
├── reference/ # 参考资料(按需读)
└── scripts/ # 可执行脚本(不注入)
AGENTS.md 中的技能引用格式:
## 技能指引(按需读)
| 场景 | Skill | 触发 |
|------|-------|------|
| 安装审查 | skill-vetter | 装 skill 前 |
| 记忆管理 | memory-heat-system | 写/搜记忆 |
Step 4: 去重复
建立"事实的唯一来源"清单。例如:
| 概念 | 唯一归属 | 他处处理 |
|---|---|---|
| 安全红线 | AGENTS.md | SOUL.md 只留原则级描述 |
| 记忆管理 | 见对应 skill | 其他文件只留一句话引用 |
| 主动性规则 | proactivity skill | 其他文件只留一句话引用 |
Step 5: 删除模板/过期文件
- BOOTSTRAP.md(首次完成后删除)
- 重复的 IdenTITY.md(合并到 SOUL.md)
- 过期的 memory 文件
- 模板残留文字
Step 6: 文言化(可选)
中文描述部分可文言化,压缩比约 3:1。 不可压缩的:命令、路径、工具名、表格代码。
示例:
- "不废话、不猜测" → "言必有据,不言无徵"
- "写下来,记忆会失效" → "笔之于书,胜于于心"
- "行不通?第 11 种方法" → "此路不通,另辟蹊径"
详见 references/wenyan-patterns.md
Step 7: 验证
# 瘦身后验证
wc -c /path/to/workspace/*.md
cat /path/to/workspace/*.md | wc -c
# 确认无语法问题(重启 agent 验证行为正常)
Step 8: 提交变更
cd /path/to/workspace
git add -A
git commit -m "workspace: context slimming — structure + dedup + optional classical"
实战数据
一次完整瘦身实践的压缩效果:
| 文件 | 瘦身前 | 结构拆分后 | + 文言化 |
|---|---|---|---|
| AGENTS.md | 7,865 | 1,632 | — |
| SOUL.md | 3,074 | 746 | 746 |
| USER.md | 5,176 | 1,158 | 689 |
| MEMORY.md | 5,480 | 1,421 | 1,079 |
| HEARTBEAT.md | 3,247 | 626 | 416 |
| TOOLS.md | 3,107 | 354 | 297 |
| IDENTITY.md | 635 | 删除 | — |
| BOOTSTRAP.md | 1,471 | 删除 | — |
| 合计 | 30,055 | 5,937 | — |
总压缩率:-80% 到 -86%(含删除冗余文件)
检查清单
见 references/slimming-checklist.md
前后对照
- 确保已安装 OpenClaw(本地或 Docker 部署)
- 在对话框中输入安装命令:
/install context-slimming - 安装完成后,直接呼叫该 Skill 的名称或使用
/context-slimming触发 - 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
Context Slimming 是什么?
Diagnose and optimize an OpenClaw agent workspace's injected context files (AGENTS.md, SOUL.md, USER.md, MEMORY.md, TOOLS.md, HEARTBEAT.md, etc.) to reduce p... 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 124 次。
如何安装 Context Slimming?
在 OpenClaw 或 Claude Code 对话框中运行命令「/install context-slimming」即可一键安装,无需额外配置。
Context Slimming 是免费的吗?
是的,Context Slimming 完全免费,采用 MIT-0 许可证,可自由下载、安装和使用。
Context Slimming 支持哪些平台?
Context Slimming 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(cross-platform)。
谁开发了 Context Slimming?
由 Gong Cheng(@scomper)开发并维护,当前版本 v1.0.2。