Token Optimizer

该 Skill 提供本地命令行工具，通过 --analyze、--compress、--health-check、--cleanup、--preflight 等操作分析 OpenClaw 会话的 token 用量，生成上下文压缩快照、会话清理规划与前置 token 预算评估，并支持模型选择建议、自定义配置与 JSON 输出。

mkhaytman87

热度 68.81

最近更新 2026-05-17 11:54:58

分类：效率依赖：代码执行 / 读写文件应用场景：自动化脚本 / 工作流 / 报告撰写 / 数据处理

安装技能

复制下面的话术发给你的 Agent，它会通过 secure-skills 检索并安装该技能。

执行命令安装此 skill： npx secure-skills-cli add mkhaytman-token-optimizer

Metadata

name: token-optimizer
description: Automatically analyze and reduce OpenClaw token waste through context compression, tool-call deduplication insights, model selection guidance, and session hygiene checks. Use when sessions are nearing context limits, costs are climbing, or you want proactive token optimization before expensive tasks.

Token Optimizer

Overview

Use this skill to optimize OpenClaw token usage with a local CLI that performs analysis, compression snapshots, health checks, cleanup planning, and preflight token budgeting.

Quick Start

$OPENCLAW_SKILLS_DIR/token-optimizer/scripts/token-optimize --analyze --period 7d

Core Commands

Enable local optimizer config:

$OPENCLAW_SKILLS_DIR/token-optimizer/scripts/token-optimize --enable

Optimization analysis:

$OPENCLAW_SKILLS_DIR/token-optimizer/scripts/token-optimize --analyze --period 7d

Force context compression snapshot:

$OPENCLAW_SKILLS_DIR/token-optimizer/scripts/token-optimize --compress --threshold 0.7 --session agent:main:main

Session health check:

$OPENCLAW_SKILLS_DIR/token-optimizer/scripts/token-optimize --health-check --active-minutes 120

Auto-cleanup planning and apply:

$OPENCLAW_SKILLS_DIR/token-optimizer/scripts/token-optimize --cleanup
$OPENCLAW_SKILLS_DIR/token-optimizer/scripts/token-optimize --cleanup --apply

Preflight Optimization

Use preflight planning before expensive task batches:

$OPENCLAW_SKILLS_DIR/token-optimizer/scripts/token-optimize \
  --preflight /path/to/actions.json \
  --session-limit 180000

actions.json should be a JSON array of planned operations, for example:

[
  {"type": "web_search", "query": "..."},
  {"type": "web_fetch", "url": "..."},
  {"type": "summarize", "target": "youtube"}
]

Output Artifacts

Compression snapshots: $OPENCLAW_WORKSPACE/token-usage/compressed/
Optional JSON output: --format json --output /path/file.json
Baseline config (from --enable): $OPENCLAW_WORKSPACE/token-usage/token-optimizer.config.json

Defaults

Default behavior is configured in:

config/defaults.json

Override with:

$OPENCLAW_SKILLS_DIR/token-optimizer/scripts/token-optimize --config /path/custom.json --analyze

Resources

scripts/token_optimize.py: main CLI
src/optimizer.py: core optimization engine
src/models.py: model selection logic
src/compression.py: context compression helpers
src/cleanup.py: session hygiene evaluation
references/operating-notes.md: implementation details and safe-operating guidance

Validation

python3 $OPENCLAW_SKILLS_DIR/.system/skill-creator/scripts/quick_validate.py \
  $OPENCLAW_SKILLS_DIR/token-optimizer