OpenClaw 的 Token 优化指南

系统性操作指南：在不损失任何功能的前提下，将每轮对话的 Token 消耗降低 70% 以上。

何时使用本技能

• session_status 显示 Context 占比 > 30%（即使发送简单消息）
• 缓存命中率（Cache hit rate）为 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

异常信号（Red flags）：

• 任一单个文件 > 10KB → 需拆分
• 所有工作区文件总大小 > 30KB → 冗余严重
• 缓存命中率为 0% → 缓存未启用
• 发送简单消息时 Context 占比 > 40% → 上下文裁剪策略过宽松

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

AGENTS.md（最大瓶颈）

将使用频率较低的内容迁移至独立文件：

目标：AGENTS.md ≤ 5KB

仅保留：会话规则、安全策略、格式规范、高频使用的子代理速查表。

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

> Subagent protocol → `AGENTS_SUBAGENT.md` (read on demand)
> Heartbeat protocol → `AGENTS_HEARTBEAT.md` (read during heartbeat)

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" }
        }
      }
    }
  }
}

参数取值说明

厂商支持情况

缓存常驻技巧（Keep-Warm Tip）

将 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"]
        }
      }
    }
  }
}

参数参考指南

工具拒绝列表（Tool Deny List）

将体积大、一次性使用的工具输出移入 deny 列表：

• web_fetch — 页面内容体积大，且极少复用
• web_search — 每次搜索结果均不同

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

• exec — 命令输出常被后续对话引用
• read — 文件内容可能跨多轮讨论
• browser — 快照数据可能被反复引用

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

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

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

步骤 6：验证与监控

完成全部配置后，重启网关并检查效果：

openclaw gateway restart

随后发送一条简单消息，并运行 session_status：

关键指标（KPI）目标值

故障排查

总结检查清单

• 评估：运行 wc -c 统计工作区文件大小 + 执行 session_status
• 拆分：AGENTS.md ≤ 5KB，MEMORY.md ≤ 3KB
• 删除：BOOTSTRAP.md（如存在）
• 缓存：为 Anthropic 模型配置 cacheRetention: "long"
• 裁剪：配置 contextPruning 并采用激进参数
• 路由：为心跳及简单任务指定低成本模型
• 验证：session_status 显示高缓存命中率 + 低 Context 占比
• 监控：每周审查 KPI 表现