Token 优化指南（OpenClaw）

系统性方法，可将每轮对话的 token 消耗降低 70% 以上，且不损失任何功能。

何时使用此技能

• session_status 显示简单消息时上下文占用 > 30%
• 缓存命中率 = 0% 或持续偏低
• AGENTS.md 文件大小 > 5KB 或 MEMORY.md > 3KB
• 希望降低 Anthropic 模型的 API 成本

先决条件

• OpenClaw 2026.3.x 或更高版本
• 可编辑 openclaw.json 文件
• 至少配置了一个 Anthropic 模型

步骤 1：审计当前状态

运行 session_status 并记录以下信息：

Cache: X% hit · Y cached, Z new
Context: Xk/200k (X%)

然后检查文件大小：

wc -c ~/.openclaw/workspace/*.md

红色警告：

• 任一文件 > 10KB → 需要拆分
• 工作区总文件大小 > 30KB → 内容冗余
• 缓存命中率 0% → 缓存未启用
• 简单消息上下文占用 > 40% → 清理策略过松

步骤 2：拆分大文件（第一层优化）

AGENTS.md（主要问题来源）

将不常使用的内容移至独立文件：

目标：AGENTS.md ≤ 5KB

仅保留：会话规则、安全策略、格式规范、快速参考子代理表格。

在文件顶部添加引用说明：

> 子代理协议 → `AGENTS_SUBAGENT.md`（按需读取）
> 心跳协议 → `AGENTS_HEARTBEAT.md`（心跳时读取）

MEMORY.md

将详细的 SOP 和操作流程移至 memory/ 子目录中的独立文件。仅保留高频引用内容。

目标：MEMORY.md ≤ 3KB

BOOTSTRAP.md

初始设置完成后删除该文件。它每轮都会加载，但无实际价值。

mv ~/.openclaw/workspace/BOOTSTRAP.md ~/.openclaw/workspace/BOOTSTRAP.md.bak

验证

# 统计每轮必加载文件的总大小
cat ~/.openclaw/workspace/{AGENTS,SOUL,TOOLS,IDENTITY,USER,HEARTBEAT,MEMORY}.md | wc -c
# 目标：总大小 < 15KB

步骤 3：启用提示词缓存（第二层优化）

在 openclaw.json 中为每个 Anthropic 模型添加 cacheRetention 配置：

{
  "agents": {
    "defaults": {
      "models": {
        "anthropic/claude-opus-4-6": {
          "params": { "cacheRetention": "long" }
        },
        "anthropic/claude-sonnet-4-6": {
          "params": { "cacheRetention": "long" }
        },
        "openrouter/anthropic/claude-3.5-sonnet": {
          "params": { "cacheRetention": "short" }
        }
      }
    }
  }
}

参数值说明

各服务商支持情况

保持缓存活跃小技巧

将 cacheRetention: "long" 与约 55 分钟一次的心跳任务结合，确保缓存长期处于激活状态：

"heartbeat": {
  "every": "55m",
  "model": "your/cheap-model"
}

步骤 4：调整上下文清理策略（第三层优化）

{
  "agents": {
    "defaults": {
      "contextPruning": {
        "mode": "cache-ttl",
        "ttl": "3m",
        "keepLastAssistants": 2,
        "softTrimRatio": 0.25,
        "hardClearRatio": 0.45,
        "tools": {
          "allow": ["exec", "read", "browser"],
          "deny": ["web_search", "web_fetch"]
        }
      }
    }
  }
}

参数说明

工具拒绝列表

将大型、一次性输出的工具加入 deny 列表：

• web_fetch — 页面内容体积大，复用率低
• web_search — 搜索结果每次不同，无法缓存

将频繁复用的工具保留在 allow 列表中：

• exec — 命令输出常在后续对话中被引用
• read — 文件内容可能跨轮次讨论
• browser — 截图数据可能被引用

步骤 5：优化模型路由策略

对低价值任务使用低成本或免费模型：

"heartbeat": {
  "every": "4h",
  "model": "your/free-flash-model"
}

步骤 6：验证与监控

完成所有修改后，重启网关并执行测试：

openclaw gateway restart

发送一条简单消息，再次运行 session_status：

目标指标

故障排查

总结清单

• [ ] 审计：对工作区文件执行 wc -c 并检查 session_status
• [ ] 拆分：确保 AGENTS.md ≤ 5KB，MEMORY.md ≤ 3KB
• [ ] 删除：如果存在，删除 BOOTSTRAP.md
• [ ] 缓存：在 Anthropic 模型上设置 cacheRetention: "long"
• [ ] 剪枝：使用激进设置启用 contextPruning
• [ ] 路由：对心跳或简单任务使用低成本模型
• [ ] 验证：确认 session_status 显示缓存命中且上下文占用率低
• [ ] 监控：每周审查 KPI 指标