核心能力
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优化版本需人工审查替换，非自动生效