Token 优化器

概述

使用此技能通过本地 CLI 工具优化 OpenClaw 的 token 使用。该工具支持分析、上下文压缩快照、健康检查、清理规划以及预检 token 预算。

快速开始

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

核心命令

1) 启用本地优化配置：

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

2) 优化分析：

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

3) 强制生成上下文压缩快照：

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

4) 会话健康检查：

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

5) 自动清理规划与执行：

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

预检优化

在执行高成本任务批次前，使用预检规划：

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

actions.json 应为一个包含计划操作的 JSON 数组，例如：

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

输出产物

• 压缩快照：$OPENCLAW_WORKSPACE/token-usage/compressed/
• 可选 JSON 输出：--format json --output /path/file.json
• 基线配置（由 --enable 生成）：$OPENCLAW_WORKSPACE/token-usage/token-optimizer.config.json

默认设置

默认行为配置在：

• config/defaults.json

可通过以下方式覆盖：

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

资源

• scripts/token_optimize.py: 主 CLI 脚本
• src/optimizer.py: 核心优化引擎
• src/models.py: 模型选择逻辑
• src/compression.py: 上下文压缩辅助功能
• src/cleanup.py: 会话卫生评估
• references/operating-notes.md: 实现细节与安全操作指南

验证

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