mcpField
T
token-optimizer

token-optimizer

github.com/asif2bdAgent 工作流7397 次安装6 周前更新
代码仓库

关于 token-optimizer

token-optimizer 是面向 OpenClaw Agent 工作区的令牌优化技能，可按任务推荐上下文、分配模型、规划心跳并追踪本地预算。脚本不会发起网络请求。

主要功能

  1. 01按任务推荐上下文
  2. 02Sonnet 与 Opus 任务路由
  3. 03心跳与缓存时序规划
  4. 04本地令牌预算追踪
  5. 05显式且可备份的文件写入

适用场景

  1. 01仅加载提示词所需文件
  2. 02为常规和复杂任务选择模型
  3. 03按静默时段规划心跳检查
  4. 04高成本操作前检查本地预算

安装

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

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

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

包含的文件

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

LICENSE
PR-DESCRIPTION.md
CHANGELOG.md
.clawhubignore
.gitignore
.clawhubsafe
README.md
SECURITY.md
assets/
HEARTBEAT.template.md
config-patches.json
config.example.json
cronjob-model-guide.md
docs/
RESEARCH-NOTES.md
references/
PROVIDERS.md
scripts/
context_optimizer.py
optimize.sh
model_router.py
token_tracker.py
heartbeat_optimizer.py

详细介绍

OpenClaw Token Optimizer v3.2.0

版本 许可证

由 Asif2BD 为当前版本的 OpenClaw 2026.6.x Agent 打造 · GitHub · 安全说明

**安全提示：**仅在本地运行的优化工具包。Python 脚本不会发起网络请求，也不会执行动态代码。写入文件的命令均为显式操作、有文档说明且可安全备份。

安装

openclaw skills install @asif2bd/openclaw-token-optimizer

v3.2 新特性

现代化的 ClawHub 卡片

技能卡片现在以更清晰的产品承诺、当前的 OpenClaw 兼容性、安全状况和实用命令为重点，取代了旧版 v3.0 的长篇介绍。

当前 OpenClaw 模型路由

常规 Anthropic 工作使用 anthropic/claude-sonnet-4-5；只有明确属于复杂推理的任务才会路由到 anthropic/claude-opus-4-5。

审计安全的写入操作
  • context_optimizer.py generate-agents 默认输出到 stdout。
  • 写入优化后的 AGENTS.md 需要使用 --output 或 --workspace-output。
  • ./scripts/optimize.sh heartbeat 默认仅预览。
  • ./scripts/optimize.sh heartbeat install 仅在备份现有文件后才写入 HEARTBEAT.md。

优化内容

上下文加载

停止在每个会话中加载所有工作区文件。仅推荐当前提示词所需的上下文。

python3 scripts/context_optimizer.py recommend "hi"

典型结果：问候时仅需 SOUL.md + IDENTITY.md。

模型路由

常规工作使用 Sonnet，将 Opus 留给深度推理。

python3 scripts/model_router.py "thanks!"
python3 scripts/model_router.py "design a multi-agent architecture"
心跳调度

仅运行到期的检查，遵守静默时段，并使心跳时间与提示词缓存 TTL 保持一致。

python3 scripts/heartbeat_optimizer.py plan
python3 scripts/heartbeat_optimizer.py cache-ttl
Token 预算

跟踪本地每日预算状态，并在支出失控前发出警告。

python3 scripts/token_tracker.py check

快速开始

1. 找出请求所需的最少上下文
python3 scripts/context_optimizer.py recommend "write a deployment checklist"
2. 预览优化后的 AGENTS.md
python3 scripts/context_optimizer.py generate-agents

仅在明确要求时保存审阅副本：

python3 scripts/context_optimizer.py generate-agents --output ~/.openclaw/workspace/AGENTS.md.optimized
3. 预览心跳安装
./scripts/optimize.sh heartbeat

启用备份保护后安装：

./scripts/optimize.sh heartbeat install
4. 路由任务
python3 scripts/model_router.py "debug this error"

节省概况

领域常见浪费优化器方案
启动上下文每轮都加载文档、记忆、工具和旧日志仅按需延迟加载提示词所需内容
常规模型使用用 Opus 处理快速回复或简单检查常规工作使用 Sonnet，复杂推理使用 Opus
心跳每次心跳都运行所有检查到期检查规划器 + 静默时段
缓存 TTL空闲会话触发高成本的缓存重写针对 1 小时缓存 TTL 提供 55 分钟心跳建议
预算控制事后才发现支出高成本工作开始前进行本地预算检查

预计节省：在上下文密集型 OpenClaw 工作区中可节省 50-80%，其中上下文优化通常效果最大。

文件

脚本
  • scripts/context_optimizer.py — 提示词分类和上下文包推荐
  • scripts/model_router.py — 感知 Sonnet/Opus 的任务路由
  • scripts/heartbeat_optimizer.py — 到期检查规划、静默时段、缓存 TTL 间隔建议
  • scripts/token_tracker.py — 本地预算跟踪
  • scripts/optimize.sh — 捆绑脚本的便捷封装
资源
  • assets/HEARTBEAT.template.md — 支持安全备份的心跳模板
  • assets/cronjob-model-guide.md — 定时任务的模型使用指南
  • assets/config-patches.json — 原生配置和可选配置示例
参考资料
  • references/PROVIDERS.md — 可选的外部提供商策略说明
  • SECURITY.md — 完整的安全与数据处理说明

安全状况

  • 可执行脚本不会发起网络调用
  • 不使用 eval、动态导入、Shell 命令执行或下载器行为
  • 仅在 OpenClaw 工作区记忆目录中保存本地 JSON 状态
  • 写入工作区需要明确的命令
  • 替换现有 HEARTBEAT.md 前会先备份
  • .clawhubsafe 使用 SHA256 哈希覆盖每个已发布文件

在本地验证：

sha256sum -c .clawhubsafe

OpenClaw 原生诊断

将 OpenClaw 内置的上下文和用量命令与此技能配合使用：

/context list
/context detail
/usage tokens
/usage cost

使用内置功能查看 Token 的去向，然后使用 Token Optimizer 减少重复浪费。

最适用场景

  • 指令文件较大的多 Agent OpenClaw 工作区
  • 运行心跳或定期检查的 Agent
  • 希望将 Opus 留给高难度任务，而非日常工作的团队
  • xCloud、MissionDeck 或其他托管式 OpenClaw 部署；在这些部署中，每节省一个提示词 Token，都会随着用户数量增加而累积效益

更多来自 Asif2BD 的内容

openclaw skills install @asif2bd/jarvis-mission-control
openclaw skills search asif2bd

评论

支持 Markdown