前言¶

同一个 agent 跑一个月，账单可以是 800 美元，也可以是几十美元。差距通常不在模型能力上，而在调度方式上：简单任务也在用贵的模型、心跳请求走付费 API、上下文装了 50KB 但只用得上 8KB。这类成本是配置和习惯带来的，不是模型定价带来的。

下面介绍的 Token Optimizer 是一个面向 OpenClaw 的 Skill，用一套 CLI 命令把上面几类开销逐项压下来。

这是什么¶

Token Optimizer 是 smartpeopleconnected 发布在 ClawHub 上的 OpenClaw 优化 Skill，上游仓库为 https://clawhub.ai/smartpeopleconnected/token-optimizer 。当前版本 v1.0.18，许可 MIT（页面底部标注 MIT-0），标签 requires_api_key=false，分类 ai-agent。

它解决的问题是：OpenClaw 默认配置偏向能力而非成本，工具通过模型路由、心跳替换、会话精简、提示词缓存和预算上限五类手段降低月度 API 开销。官方页面给出的对比是月费从 70–90 美元降到 3–5 美元（按每日用量换算），年费从 800 美元以上降到 40–60 美元。这些是官方宣传数字，实际节省取决于你的用量结构。

说明：任务里给出的 SkillHub 地址（api.skillhub.cn）无法访问，正文事实以上游 ClawHub 页面为准。

核心功能¶

只列页面上能核对到的四项核心优化和工具能力：

1. 模型路由：默认走 Haiku，只有必要时才用 Sonnet/Opus，官方标注约节省 92%。
2. 多供应商心跳：把心跳请求路由到 Ollama、LM Studio、Groq，或直接关闭，官方标注约节省 100%。
3. 会话管理：按需加载 8KB 而不是 50KB 上下文，官方标注约节省 80%。
4. 提示词缓存：复用提示词，按 10% 成本计费，官方标注约节省 90%。

配套工具（v1.0.8 新增）：

• 回滚：列出并即时恢复配置备份。
• 健康检查：一条命令查看系统状态。
• Diff 预览：应用前先看具体改动。
• –no-color：适合 CI/流水线的输出。

安装与启用¶

官方给出两种安装命令，目标环境都是 OpenClaw：

# 方式一
openclaw skills install @smartpeopleconnected/token-optimizer

# 方式二
clawhub install token-optimizer

安装后不需要 API Key（标签 requires_api_key=false），但部分功能依赖本地模型服务（如 Ollama）或已有供应商额度。

典型用法¶

以下命令来自官方 Quick Start，均为本地 CLI 调用：

# 分析当前配置与用量
python cli.py analyze

# 预览改动，默认 dry-run，不写入任何配置
python cli.py optimize

# 应用全部优化
python cli.py optimize --apply

# 验证设置是否生效
python cli.py verify

# 快速健康检查
python cli.py health

# 配置心跳供应商（先预览）
python cli.py setup-heartbeat --provider ollama

# 配置心跳供应商（写入）
python cli.py setup-heartbeat --provider ollama --apply

# 列出备份
python cli.py rollback --list

# 恢复到指定备份
python cli.py rollback --to <backup-file>

设计上默认安全：所有命令默认 dry-run，只有显式加 –apply 才写配置。

修改的路径与生成的配置¶

所有改动写入 ~/.openclaw/ 下，且在修改前自动创建备份：

生成的配置示例：

{
  "agents": {
    "defaults": {
      "model": { "primary": "anthropic/claude-haiku-4-5" },
      "cache": { "enabled": true, "ttl": "5m" }
    }
  },
  "heartbeat": {
    "provider": "ollama",
    "model": "ollama/llama3.2:3b"
  },
  "budgets": {
    "daily": 5.00,
    "monthly": 200.00
  }
}

适用场景与注意¶

适合：自建 OpenClaw agent、对月度 API 账单敏感、愿意用 CLI 改配置的开发者。

注意：

• 前提是你确实在使用 OpenClaw，它会直接改 ~/.openclaw/ 下的配置文件；其他 agent 框架不适用。
• 节省数字来自官方页面，与你的任务类型、供应商价格正相关，先 analyze 看自己的用量结构再决定是否 –apply。
• 心跳路由到本地 Ollama 等服务需要你自己有可用模型环境。
• 改动前务必确认 rollback 备份存在，虽然工具自带备份机制。
• SkillHub 页面（clawhub_smartpeopleconnected/token-optimizer）与上游 ClawHub 页面信息一致；以 api.skillhub.cn 开头的地址本次无法访问，安装与验证请走 ClawHub 上游页面。

结尾¶

Token Optimizer 的价值在于把成本控制变成几条可预览、可回滚的命令，而不是手工翻配置文件。先 analyze，再 optimize 预览，确认 diff 后 –apply，最后 verify。官方地址：https://clawhub.ai/smartpeopleconnected/token-optimizer （Mirror：https://www.skillhub.cn/skills/clawhub_smartpeopleconnected/token-optimizer ）。