mcpField
T
token-optimizer

token-optimizer

github.com/smartpeopleconnectedAgent 工作流771 次安装36 周前更新
代码仓库

关于 token-optimizer

token-optimizer 是用于降低 OpenClaw Token 使用量的命令行技能，通过模型路由、心跳服务商选择、会话上下文管理和缓存进行优化。它还提供配置预览、备份回滚、健康检查和节省报告。

主要功能

  1. 01按任务路由不同模型
  2. 02选择多种心跳服务商或禁用心跳
  3. 03缩减会话上下文
  4. 04通过缓存复用提示词
  5. 05预览更改并还原配置备份
  6. 06运行健康检查和节省报告

适用场景

  1. 01按任务调整 OpenClaw 模型选择
  2. 02将心跳路由至 Ollama、LM Studio 或 Groq
  3. 03应用前预览配置修改
  4. 04还原先前的 OpenClaw 配置

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/smartpeopleconnected/openclaw-token-optimizer --skill token-optimizer

安装后在 Claude Code 中输入/token-optimizer确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

.clawhubignore
_meta.json
setup.py
.gitignore
README.md
LICENSE
CHANGELOG.md
cli.py
requirements.txt
skill.json
.github/
FUNDING.yml
src/
__init__.py
colors.py
analyzer.py
optimizer.py
verify.py
templates/
openclaw-config-optimized.json
OPTIMIZATION-RULES.md
USER.md
SOUL.md
test/
simulation_test.py

详细介绍

OpenClaw 的 Token 优化器

将 AI 成本从每月 1,500 美元以上降至 50 美元以下。

问题

OpenClaw 默认优先考虑能力，而非成本。你在 Haiku 能完美处理的任务上浪费昂贵的 Sonnet/Opus token，为本可在本地免费运行的 API 心跳付费，还加载了 50 KB 的上下文，而 8 KB 就已足够。

解决方案

四项核心优化，以及强大的工具：

模型路由（节省 92%）

默认使用 Haiku，仅在需要时使用 Sonnet/Opus

多提供商心跳（节省 100%）

将心跳路由到 Ollama、LM Studio、Groq，或完全禁用。不受限于单一提供商。

会话管理（节省 80%）

加载 8 KB，而不是 50 KB 的上下文

缓存（节省 90%）

以 10% 的成本重复使用提示词

v1.0.8 新增内容
  • 回滚 - 立即列出并恢复配置备份
  • 健康检查 - 使用一条命令快速查看系统状态
  • 差异预览 - 应用更改前准确查看具体变动
  • --no-color - 输出适合 CI/流水线使用

成本对比

周期之前之后
每日$2-3$0.10
每月$70-90$3-5
每年$800+$40-60

包含内容

  • 支持差异预览的一键优化器
  • 多提供商心跳（Ollama、LM Studio、Groq）
  • 配置回滚和健康检查命令
  • 可直接使用的配置模板
  • SOUL.md 和 USER.md 模板
  • Agent 提示词优化规则
  • 验证和节省报告

此工具会修改的内容

所有更改均写入 ~/.openclaw/。任何修改前都会创建备份。

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

默认安全 - 所有命令均以试运行（预览）模式运行。传入 --apply 即可写入更改。

快速开始

# Install
clawhub install token-optimizer

# Analyze current setup
python cli.py analyze

# Preview changes (dry-run by default)
python cli.py optimize

# Apply all optimizations
python cli.py optimize --apply

# Verify setup
python cli.py verify

# Quick health check
python cli.py health

# Configure heartbeat provider (preview)
python cli.py setup-heartbeat --provider ollama

# Configure heartbeat provider (apply)
python cli.py setup-heartbeat --provider ollama --apply

# List and restore backups
python cli.py rollback --list
python cli.py rollback --to <backup-file>

生成的配置

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

链接

作者

Smart People Connected

许可证

MIT 许可证 - 可免费使用、修改和分发。

只需 5 分钟即可完成设置。成本降低 97%。别再浪费 token，开始构建吧。

评论

支持 Markdown