- name
- agent-quantizer
- description
- API 调用优化器 - 上下文压缩、缓存去重、僵尸清理、heartbeat 检查、cron 审计、模型分级、skill 管理
- user-invocable
- true
- version
- 2.0.0
Agent Quantizer - 全栈优化工具包
跨实例部署的 OpenClaw 优化层。不改模型、不改代码，从调用侧省 token、省钱、省时间。
⚡ 自动缓存规则（强制执行）
每次调用工具（web_fetch、web_search、exec 中的网络请求等）之前，必须先查缓存：
# 第一步：查缓存
bash ~/.openclaw/skills/agent-quantizer/scripts/cache.sh get "查询内容" <类别>
# 如果返回 HIT → 直接使用，不要重新调用
# 如果返回 MISS → 正常调用工具，调用完后存缓存：
# 第二步：存缓存
bash ~/.openclaw/skills/agent-quantizer/scripts/cache.sh set "查询内容" "结果" <类别> <TTL秒>| 类别 | TTL | 场景 |
|---|---|---|
tool | 30分钟 | 天气、汇率等半实时数据 |
knowledge | 24小时 | 百科、定义等不变信息 |
realtime | 5分钟 | 新闻等快速变化内容 |
general | 1小时 | 其他通用查询 |
📊 Token 统计与扫描
用户说"查看 token 消耗"或"扫描高消耗"时：
# 查看所有 session token 排行
bash ~/.openclaw/skills/agent-quantizer/scripts/quantize.sh stats
# 扫描超阈值 session
bash ~/.openclaw/skills/agent-quantizer/scripts/quantize.sh scan🧠 上下文压缩
对话变长、响应变慢时：
# 滑动窗口压缩（零 API 消耗）
bash ~/.openclaw/skills/agent-quantizer/scripts/quantize.sh compress <session_key> --window
# AI 摘要压缩（消耗少量 token，效果更好）
bash ~/.openclaw/skills/agent-quantizer/scripts/quantize.sh compress <session_key> --ai✂️ Prompt 精简
精简 prompt 文件，去冗余指令和礼貌用语：
bash ~/.openclaw/skills/agent-quantizer/scripts/quantize.sh trim <文件路径>🧟 僵尸 Session 清理
清理长期不活跃的 session，回收 token：
# 预览（不删除）
bash ~/.openclaw/skills/agent-quantizer/scripts/clean-zombies.sh 7 --dry-run
# 执行清理（7 天未活动的）
bash ~/.openclaw/skills/agent-quantizer/scripts/clean-zombies.sh 7
# 自定义天数
bash ~/.openclaw/skills/agent-quantizer/scripts/clean-zombies.sh 30备份在 .zombie-backup/ 目录，删错了可以恢复。
💓 Heartbeat 空转检查
检查 HEARTBEAT.md 是否在空转烧 API：
bash ~/.openclaw/skills/agent-quantizer/scripts/check-heartbeat.sh标出空的或只有注释的 HEARTBEAT.md，给出修复建议。
⏰ Cron Job 审计
检查定时任务是否有冗余、高频、重复：
bash ~/.openclaw/skills/agent-quantizer/scripts/audit-cron.sh🎯 模型分级配置
查看当前模型配置和推荐策略：
bash ~/.openclaw/skills/agent-quantizer/scripts/setup-models.sh📁 Skill 分类整理
扫描所有 skill，建议哪些该放全局、哪些该放专属 workspace：
bash ~/.openclaw/skills/agent-quantizer/scripts/organize-skills.sh快捷命令
用户可以直接说（中文即可）：
- "查看 token 消耗" / "token 统计" → 执行 quantize stats
- "扫描高消耗" → 执行 quantize scan
- "压缩上下文" → 执行 quantize compress
- "缓存统计" → 执行 quantize cache stats
- "清空缓存" → 执行 quantize cache flush
- "清理僵尸 session" → 执行 clean-zombies.sh
- "检查 heartbeat" → 执行 check-heartbeat.sh
- "检查 cron" → 执行 audit-cron.sh
- "整理 skill" → 执行 organize-skills.sh
文件路径
所有脚本位于：~/.openclaw/skills/agent-quantizer/scripts/
scripts/
├── quantize.sh # 主入口（stats/scan/compress/trim/cache）
├── cache.sh # 缓存系统
├── clean-zombies.sh # 僵尸 session 清理
├── check-heartbeat.sh # heartbeat 空转检查
├── audit-cron.sh # cron job 审计
├── setup-models.sh # 模型分级配置
└── organize-skills.sh # skill 分类整理