Token 优化实战 2.0：5 项配置 + 进阶字段实测，长会话省 60%（OpenClaw 2026.7.1-2）

写在前面

我是 @效率星球，上个月发过一篇《Token 优化实战：5 项配置 + 3 个技能，长会话上下文省 60%》，收到不少反馈。这篇是改进版 2.0：我在 OpenClaw 2026.7.1-2 上把原方案逐字段复核了一遍，修正了 3 处配置语义，补上 4 个进阶字段，并实测了记忆系统与可观测性。所有配置均通过 openclaw config validate 校验，可直接复制落地。

📌 评测声明：本文基于 OpenClaw 2026.7.1-2 实测（测试时间 2026-08，测试任务见第六节），模型价格以聚星逸控制台实时报价为准。

---

一、为什么 2026 年必须做 Token 优化

三个趋势叠加，让「省 token」从可选项变成必修课：

• 长上下文模型普及：128K、200K 甚至 1M 窗口成标配，但窗口越大，每轮重复发送的「静态上下文」越烧钱。
• Prompt Cache 成熟：主流厂商（DeepSeek / Claude / GPT / Qwen）都支持缓存命中，缓存读成本只有输入的 10-50%——但前提是缓存要「热」。
• Agent 多轮爆炸：工具调用 + 多轮迭代，单任务 token 消耗轻松破百万。

💡 一句话：不做优化，你 60% 的 token 花费在重复发送同一坨上下文上。

---

二、5 项核心配置（修正版）

在 ~/.openclaw/openclaw.json 的 agents.defaults 中落地，首次启动即生效：

优化项	字段	值	效果
上下文注入去重	contextInjection	continuation-skip	工作区文件连续轮次不重复注入，省 ~90% 静态上下文
上下文裁剪	contextPruning	{mode:"cache-ttl", ttl:"1h"}	按缓存 TTL 裁剪过期片段
自动压缩	compaction	{mode:"safeguard", reserveTokens:30000}	接近窗口自动摘要历史
缓存保活	heartbeat	{every:"55m"}	55 分钟心跳保 prompt cache 热度
工具输出限制	contextLimits	{toolResultMaxChars:12000}	限制单次工具返回，防撑爆

完整可复制配置（与现有字段合并即可）：

{
  "agents": {
    "defaults": {
      "params": { "cacheRetention": "short" },
      "contextInjection": "continuation-skip",
      "contextPruning": { "mode": "cache-ttl", "ttl": "1h" },
      "compaction": {
        "model": "juxingyi/DeepSeek-V4-Flash",
        "mode": "safeguard",
        "reserveTokens": 30000,
        "reserveTokensFloor": 20000
      },
      "heartbeat": { "every": "55m" },
      "contextLimits": { "toolResultMaxChars": 12000 }
    }
  }
}

落地三连：openclaw config validate → openclaw gateway restart → openclaw health。

⚠️ 相对 1.0 的三处关键修正

1. reserveTokensFloor 语义修正：1.0 版写成 40000（比 reserveTokens 30000 还大）。官方 schema 中 floor 是 reserveTokens 的最低下限（防止 token 估算波动时过度压缩），比上限还大不合理。正确做法：reserveTokens: 30000, reserveTokensFloor: 20000（或按会话复杂度上调 reserveTokens）。
2. compaction.model 必须显式指定：1.0 没写，压缩摘要会走主模型（GPT-5.4/Pro 贵）。显式指向便宜模型（如 juxingyi/DeepSeek-V4-Flash），压缩成本立降一个数量级。
3. params.cacheRetention: "short" 不是装饰字段：运行时（dist 源码）确认它是有效参数，控制 prompt cache 保留策略；与 heartbeat 55m 配合才能把缓存命中率打上去。

---

三、进阶字段（1.0 没提的 4 个）

字段	说明	建议值
compaction.keepRecentTokens	压缩后保留的最近 token 预算	按窗口 5-10%
compaction.recentTurnsPreserve	最近几轮 user/assistant 原样保留（默认 3）	4-6（工具密集场景）
compaction.maxHistoryShare	压缩后历史占比上限（0.1-0.9）	0.6-0.7
compaction.truncateAfterCompaction + maxActiveTranscriptBytes	压缩后轮转会话 JSONL，防长会话无界膨胀	true + "20mb"

truncateAfterCompaction 是长会话的隐藏大头：不轮转的话，会话 JSONL 会无限增长，/sessions 加载和记忆回填都变慢。

---

四、记忆系统实测（1.0 空白项）

1.0 说「记忆系统需要 embedding 服务，未测试」——实测结论：OpenClaw 内置 memory-core 不依赖外部 embedding，开箱即用：

• 梦境（Dreaming）：plugins.entries.memory-core.config.dreaming = {enabled:true, timezone:"Asia/Shanghai", frequency:"0 3 * * *"}，每日凌晨 light→REM→deep 三阶段整合，把短期信号提升进 MEMORY.md，全程可审计（DREAMS.md + 梦境日记）。
• Memory Wiki：memory-wiki 插件 bridge 模式，把记忆/日记/梦境报告编译成带来源的 wiki 知识库（~/.openclaw/wiki/main），支持 wiki_search/wiki_get 溯源。
• 配比建议：记忆层与配置层（A/B/C）互补，长会话先做配置优化，再开梦境整合，别让「忘了」成为常态。

---

五、可观测性与技能（实测可安装性）

可观测性三件套：

openclaw config validate   # 1. 配置校验
openclaw skills list | grep -E 'token|context|guard'
/usage tokens             # 2. 每轮缓存命中

技能可安装性实测（重要）：1.0 推荐的 3 个技能（huo15-token-optimizer、context-compression、token-guard-model-switch）在 ClawHub 上已搜不到（2026-08 实测），可能是历史版本或已改名，读者会装不上。替代方案实测可用：

openclaw skills install huo15-searxng --global      # SearXNG 自托管搜索，省搜索 API 费
openclaw skills install superpowers-openclaw --global  # 开发工作流方法论

观测面板：想量化 token/成本，可装 clawmetry-plugin（ClawHub 社区，实时 dashboard：token 用量/成本/工具调用/会话）。

---

六、测试方法与数据（本次实测口径）

• 测试环境：OpenClaw 2026.7.1-2 / 聚星逸聚合网关；主模型 DeepSeek-V4-Flash，缓存厂商为 DeepSeek 侧策略
• 测试任务：同一多轮 Agent 任务（含 5 次工具调用 + 3 次代码文件读取），分别跑「默认配置」与「5 项配置 + 进阶字段」两组
• 对照组：仅切换配置，任务指令、模型、轮次完全一致；每组重复 3 次取中位数
• 统计口径：token 数取 API 返回的 usage（prompt + completion），缓存命中率取 /usage tokens 面板

指标	默认配置	优化配置	变化
单轮重复注入（静态上下文）	~38K tok	~4K tok	-89%
10 轮累计消耗	~486K tok	~198K tok	-59%
缓存命中率	22%	71%	+49pp
单任务成本（DeepSeek-V4-Flash）	¥1.65	¥0.63	-62%

📊 数据为个人实测，受模型版本 / 缓存策略 / 任务类型影响，仅供参考；建议用第五节方法自行量化。

---

七、局限性与适用边界

• 缓存策略差异：DeepSeek / Claude / GPT / Qwen 的缓存保留窗口不同（5 分钟 ~ 1 小时），heartbeat.every 请按主模型厂商调整。
• 版本漂移：OpenClaw 小版本升级可能调整 schema 字段，升级后务必重跑 openclaw config validate。
• 任务相关性：短会话 / 单轮任务收益有限，本方案对长会话、多轮 Agent、频繁工具调用场景收益最大。
• 多供应商聚合：聚星逸一个 Key 路由 50+ 模型，cheapest-first 选路 + 缓存读折价（输入价 ×0.5），配合 heartbeat 保活后实际计费大量走「缓存读」列——压力高时降级到便宜模型，单轮成本立省 70%+。

最终建议

顺序不变：先开缓存保活（heartbeat），再做压缩与裁剪，最后上模型降级与记忆整合。相比 1.0，本版修正了配置语义、补了 4 个进阶字段、实测了记忆系统，长对话账单同样能砍一半以上（实测 -62%）。

🔋 省下的每一千 token，都是真金白银。

原文参考：https://fireworks-simulator.huo15.com/r/cmrrhr0i000pg10su7n7p3y6f
数据与字段基于 OpenClaw 2026.7.1-2 实测，配置字段均通过 openclaw config validate 校验；模型价格为聚星逸控制台 2026-08 报价，实时价格以控制台为准。