OC Context Optimizer

SKILL.md - Context Optimizer

> OpenClaw运行时优化系统 — 系级级安装，所有Agent统一受益

类型

Runtime Optimizer（运行时优化）

🎯 受众：OpenClaw系统管理员

📦 安装方式：系统级安装（不是Agent级）

🔄 生效方式：OpenClaw运行时自动调用，Agent无需感知

工作原理

Agent A ←┐
Agent B ←┼── OpenClaw运行时（统一优化） ← context-optimizer
Agent C ←┘

所有Agent间接受益，但不需要单独配置。

功能

1. 微压缩 (microcompact)

检测重复消息（相似度>85%）

合并连续的工具调用结果

压缩长文本（保留首尾关键信息）

效果：节省60%+重复token

谁在用：运行时自动

Agent感知：❌ 不感知

2. 自动压缩 (autocompact)

监控token使用量

超过阈值时自动触发压缩

生成对话摘要+保留关键文件

效果：长对话节省50%+token

谁在用：运行时自动

Agent感知：❌ 不感知

3. 流式并行执行 (streaming_executor)

流式检测工具调用

并行执行多个工具

错误隔离+自动重试

效果：工具执行加速3x

谁在用：运行时自动

Agent感知：❌ 不感知

4. Token预算管理 (token_budget)

Token使用追踪（累计/本次/剩余）

三级阈值预警（75%警告/85%压缩/90%危险）

预算耗尽自动续期（最多5次）

效果：防止上下文溢出，智能预算管理

谁在用：心跳监控

Agent感知：🟡 告警时感知

5. 工具延迟加载 (tool_defer)

初始prompt仅加载~10个核心工具

40+工具按需搜索加载

多维度搜索评分

效果：节省75%+工具描述token

谁在用：运行时自动

Agent感知：❌ 不感知

用法

直接调用（Python）

# 微压缩测试
python3 scripts/microcompact.py --test
自动压缩测试
python3 scripts/auto_compactor.py --test
流式执行器测试
python3 scripts/streaming_executor.py --test
Token预算测试
python3 scripts/token_budget.py --test
工具延迟加载测试
python3 scripts/tool_defer.py --test
处理消息文件
python3 scripts/microcompact.py messages.json
python3 scripts/auto_compactor.py messages.json
python3 scripts/streaming_executor.py tools.json
python3 scripts/token_budget.py status
python3 scripts/tool_defer.py --search "飞书"

集成到Agent工作流

from scripts.microcompact import MicroCompactor
from scripts.auto_compactor import AutoCompactor
from scripts.streaming_executor import StreamingToolExecutor
微压缩
compactor = MicroCompactor()
result = compactor.compact(messages)
print(f"节省 {result.savings_percent:.1f}% token")
自动压缩
auto = AutoCompactor(context_window=200_000)
if auto.should_compact(current_tokens):
    result = auto.compact(messages)
    messages = result.messages
流式执行
executor = StreamingToolExecutor(max_concurrent=5)
for tool in tool_calls:
    await executor.add_tool(tool)
results = await executor.wait_all()

配置参数

| 参数 | 默认值 | 说明 | |------|--------|------| | similarity_threshold | 0.85 | 消息相似度阈值 | | min_message_length | 100 | 最小合并长度 | | context_window | 200_000 | 上下文窗口大小 | | safety_margin | 0.8 | 压缩触发比例 | | max_concurrent | 5 | 最大并行工具数 | | timeout_seconds | 30.0 | 工具执行超时 |

依赖

Python 3.8+

标准库（json, asyncio, difflib）

无外部依赖

许可

MIT License