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
前后对照
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install context-slimming - After installation, invoke the skill by name or use
/context-slimming - Provide required inputs per the skill's parameter spec and get structured output
What is 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... It is an AI Agent Skill for Claude Code / OpenClaw, with 124 downloads so far.
How do I install Context Slimming?
Run "/install context-slimming" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Context Slimming free?
Yes, Context Slimming is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Context Slimming support?
Context Slimming is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Context Slimming?
It is built and maintained by Gong Cheng (@scomper); the current version is v1.0.2.