token-optimizer

Token Optimizer for OpenClaw 是一款用于降低 OpenClaw AI 使用成本的优化工具，作者为 Smart People Connected，采用 MIT 许可证。

用途

该工具针对 OpenClaw 默认配置优先考虑能力而非成本的问题，旨在减少在可由 Haiku 胜任的任务上消耗昂贵的 Sonnet/Opus token、为可通过本地免费运行的心跳支付 API 费用，以及加载过多上下文（如 50KB 而实际 8KB 足够）等浪费。官方宣称可将 AI 成本从每月 1500 美元以上降至 50 美元以下。

主要能力

工具包含四项核心优化：

模型路由（宣称节省 92%）：默认使用 Haiku，仅在需要时使用 Sonnet/Opus。
多提供商心跳（宣称节省 100%）：将心跳路由到 Ollama、LM Studio、Groq，或完全禁用，不锁定单一提供商。
会话管理（宣称节省 80%）：加载 8KB 而非 50KB 上下文。
缓存（宣称节省 90%）：以 10% 成本复用提示词。

v1.0.8 新增功能包括：回滚（列出并即时恢复配置备份）、健康检查（一条命令查看系统状态）、差异预览（应用前查看具体变更）、--no-color（适配 CI/流水线输出）。

工具还提供：带差异预览的一键优化器、多提供商心跳（Ollama、LM Studio、Groq）、配置回滚与健康检查命令、即用配置模板、SOUL.md 与 USER.md 模板、智能体提示词优化规则、验证与节省报告。

官方给出的成本对比：每日从 2-3 美元降至 0.10 美元；每月从 70-90 美元降至 3-5 美元；每年从 800 美元以上降至 40-60 美元。

使用方式

安装命令：

clawhub install token-optimizer

常用命令：

# 分析当前设置
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/ 目录下，任何修改前都会创建备份：

~/.openclaw/openclaw.json：主 OpenClaw 配置（模型路由、心跳、预算）
~/.openclaw/backups/：带时间戳的配置备份（自动创建）
~/.openclaw/workspace/：模板文件（SOUL.md、USER.md、IDENTITY.md）
~/.openclaw/prompts/：智能体提示词优化规则
~/.openclaw/token-optimizer-stats.json：用于节省报告的用量统计

生成的配置示例

{
  "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 并希望降低 AI 调用成本的用户，尤其是需要控制模型选择、心跳费用、上下文大小和提示词缓存开销的场景。

限制

官方称设置约需 5 分钟。工具仅修改 ~/.openclaw/ 下的文件，默认 dry-run，需显式 --apply 才生效。其他限制（如兼容性、平台要求等）暂未提供。

链接

GitHub：https://github.com/smartpeopleconnected/openclaw-token-optimizer
Issues：https://github.com/smartpeopleconnected/openclaw-token-optimizer/issues

作者：Smart People Connected（GitHub: @smartpeopleconnected，邮箱：smartpeopleconnected@gmail.com）。许可证：MIT License，可自由使用、修改和分发。