Context Slimming#

压缩 OpenClaw 工作空间注入上下文，降低每轮对话基础 token 消耗。

核心思路： 顶层只留必需，细节按需加载，消除跨文件重复。

---

原理#

OpenClaw 将所有顶层 *.md 文件自动注入到每轮对话的系统提示中。 初始典型注入量约 25,000–32,000 tokens，其中 70%+ 可在不损失能力的前提下移除。

目标#

阶段典型注入说明瘦身前25k–32k含详细规则/范例/重复内容结构拆分后5k–8k详细规则 → skill 引用文言化（可选）4k–6k中文描述古典化

执行流程#

Step 1: 全量扫描#

bash

# 列出所有顶层注入文件及大小 (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"）

移出内容：

text

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 中的技能引用格式：

markdown

## 技能指引（按需读）

| 场景 | Skill | 触发 |
|------|-------|------|
| 安装审查 | skill-vetter | 装 skill 前 |
| 记忆管理 | memory-heat-system | 写/搜记忆 |

Step 4: 去重复#

建立"事实的唯一来源"清单。例如：

概念唯一归属他处处理安全红线AGENTS.mdSOUL.md 只留原则级描述记忆管理见对应 skill其他文件只留一句话引用主动性规则proactivity skill其他文件只留一句话引用

Step 5: 删除模板/过期文件#

• BOOTSTRAP.md（首次完成后删除）
• 重复的 IdenTITY.md（合并到 SOUL.md）
• 过期的 memory 文件
• 模板残留文字

Step 6: 文言化（可选）#

中文描述部分可文言化，压缩比约 3:1。 不可压缩的：命令、路径、工具名、表格代码。

示例：

• "不废话、不猜测" → "言必有据，不言无徵"
• "写下来，记忆会失效" → "笔之于书，胜于于心"
• "行不通？第 11 种方法" → "此路不通，另辟蹊径"

详见 references/wenyan-patterns.md

Step 7: 验证#

bash

# 瘦身后验证
wc -c /path/to/workspace/*.md
cat /path/to/workspace/*.md | wc -c

# 确认无语法问题（重启 agent 验证行为正常）

Step 8: 提交变更#

bash

cd /path/to/workspace
git add -A
git commit -m "workspace: context slimming — structure + dedup + optional classical"

---

实战数据#

一次完整瘦身实践的压缩效果：

文件瘦身前结构拆分后+ 文言化AGENTS.md7,8651,632—SOUL.md3,074746746USER.md5,1761,158689MEMORY.md5,4801,4211,079HEARTBEAT.md3,247626416TOOLS.md3,107354297IDENTITY.md635删除—BOOTSTRAP.md1,471删除—合计30,0555,937—

总压缩率：-80% 到 -86%（含删除冗余文件）

---

检查清单#

见 references/slimming-checklist.md

前后对照#

见 references/before-after.md