OpenClaw Token Optimizer

核心能力

Token Optimizer 是一套专为OpenClaw部署设计的成本优化工具集，通过四大机制实现显著的成本节约：

1. 上下文优化（Context Optimization）— 最大收益来源

默认OpenClaw每次会话加载全部上下文（SOUL.md、AGENTS.md、docs/*/.md等），往往超过50K tokens。Lazy loading 机制根据用户提示复杂度智能选择所需文件：简单问候仅需2个文件（~80%节省），常规任务选择性加载（~50%节省），仅复杂架构分析才启用完整上下文。

2. 智能模型路由（Smart Model Routing）

自动分类任务并路由至对应模型层级。关键创新：强制规则确保"hi"、"thanks"等通信类交互永远使用最便宜的Haiku，杜绝Opus浪费在闲聊上。背景任务（心跳检查、日志解析、定时任务）同样强制路由至Haiku。

3. 心跳优化（Heartbeat Optimization）

通过智能间隔追踪减少API轮询：记录各类检查（邮件、日历、天气等）的最后执行时间，强制执行最小间隔，尊重夜间静音时段（23:00-08:00跳过检查）。预期减少50%心跳API调用。

4. Token预算追踪（Token Budget Tracking）

实时监控日用量，在接近限额时自动降级模型或推迟非紧急任务，支持三级状态（ok/warning/exceeded）。

显著优点

• 安全可信：经Oracle（Matrix Zion）审计认证，所有4个可执行脚本完全本地运行，无网络请求、无子进程调用、无系统修改
• 收益量化：典型工作负载节省50-80%，上下文优化单独贡献40%以上节约；100客户托管场景月省$315
• 开箱即用：Python标准库实现，零依赖安装；提供优化模板可直接替换现有配置
• 渐进式采用：从个人使用（20-30%节省）到高量部署（70-90%节省）均有适配方案

潜在局限

• 部分功能待核心支持：Prompt缓存、完全懒加载、多供应商自动降级需等待OpenClaw核心更新
• 预算追踪需手动集成：当前需手动记录用量，实时解析session_status工具待实现
• 路由规则需调优：默认模式可能不完全匹配特定业务场景，需自定义ROUTING_RULES

适合人群

• 个人开发者：希望降低OpenClaw日常使用的API成本
• 托管服务商（如xCloud）：需为大量客户控制成本并实施预算上限
• 高频部署场景：多Agent并行、定时任务密集、心跳轮询频繁的规模化部署

常规风险

• 功能风险低：脚本纯本地、只读分析，不改变系统状态；参考文档描述的外部服务（多供应商策略）需用户主动配置API key才生效
• 模型降级风险：强制Haiku规则可能偶尔错失需更强能力的短提示，但可通过force_tier参数覆盖
• 配置同步风险：AGENTS.md优化版本需人工审查替换，非自动生效

核心功能

Token Optimizer 是一套专为 OpenClaw 设计的成本优化工具集，通过四大核心模块实现 Token 用量削减：

1. 上下文智能加载（最大节省项）

• 实现"惰性加载"策略，根据提示复杂度动态决定加载哪些上下文文件
• 简单问候仅加载 2 个核心文件（原 50+ 文件），节省约 80% 上下文 Token
• 标准任务选择性加载，节省约 50%
• 复杂任务才启用完整上下文

2. 智能模型路由

• 自动识别任务类型并推荐最经济的模型层级
• 硬性规则：所有问候语、感谢语、简短确认一律强制使用 Haiku，杜绝浪费
• 后台任务（心跳检查、日志解析）默认路由至最便宜的模型

3. 心跳间隔优化

• 追踪各类检查的最后执行时间，强制执行最小间隔
• 夜间静默时段（23:00-08:00）自动跳过所有检查
• 预计减少 50% 的心跳 API 调用

4. Token 预算监控

• 实时追踪每日用量，在接近限额时发出预警
• 支持根据预算状态自动降级模型选择

显著优点

• 效果可量化：典型场景下实现 50-80% 成本削减，xCloud 托管场景每月可为 100 客户节省 $315
• 安全极致：全部 4 个可执行脚本仅使用 Python 标准库，零网络请求、零子进程、零代码执行，数据仅限本地 JSON 文件
• 即装即用：提供优化版 AGENTS.md 生成、心跳模板等一键式工具
• 架构清晰：参考文档（多供应商策略）与执行脚本严格分离，外部 API 调用需手动配置

潜在局限

• 需人工审查：生成的 AGENTS.md.optimized 需用户手动替换生效
• 预算追踪依赖集成：token_tracker.py 需与 OpenClaw 的 session_status 工具配合才能自动追踪，当前版本需手动记录
• 部分功能待核心支持：提示缓存、完整惰性上下文加载需 OpenClaw 核心层配合
• 配置复杂度：多供应商策略涉及外部 API 密钥管理，需用户自行评估供应商可信度

适合人群

• 高频使用 OpenClaw 的个人开发者（预期节省 20-30%）
• xCloud 等平台上的托管服务提供商（预期节省 40-60%）
• 需要同时运行数十个 Agent 的企业级部署（预期节省 70-90%）

常规风险

• 误报风险：部分杀毒软件可能因"optimizer"关键词结合文件操作产生启发式误报
• 审计声明待验证：作者声称通过 Oracle (Matrix Zion) 审计，但用户应独立核实
• 模型降级风险：过度激进的成本优化可能影响输出质量，建议定期审查路由准确性