榨干每一枚 Token：OpenClaw 走 Headroom 本地 Proxy 的高吞吐巡检流水线
若你已用 OpenClaw 做夜间代码审计、MCP 工具环或长链路 Agent，账单大头通常是工具返回的 Token，而非几句用户指令。Headroom 在本地把日志/JSON/RAG 块压缩后再发给模型（库、8787 代理 或 OpenClaw ContextEngine 插件），官方 README 给出 agent 场景 60–95% 降幅，CCR 可逆检索原文。
披露：VpsGona 提供可选云 Mac。二者均为独立开源项目。
相关：OpenClaw 安装向导、OTEL 可观测、launchd 定时任务。大陆环境另注意出口带宽、npm 镜像——压缩省 Token，拉依赖仍可能慢。
架构：Headroom 插在 OpenClaw 哪一环
OpenClaw 网关 → 工具输出 → Headroom http://127.0.0.1:8787 → Anthropic（密钥不变）
可引用结论： Headroom 不取代 OpenClaw，只压缩 OpenClaw 已读入的上下文。详见 Proxy 文档。
| 模式 | 场景 | OpenClaw 接入点 |
|---|---|---|
headroom proxy --port 8787 | 零改代码 | 在 ~/.openclaw/.env 设 ANTHROPIC_BASE_URL |
| ContextEngine 插件 | OpenClaw 原生 | Headroom openclaw provider |
| MCP 压缩工具 | MCP 密集任务 | headroom mcp install |
headroom wrap | 临时开发 | 不适合 24/7 网关 |
接入矩阵
| 模式 | 接入 | 节省区间 | 运维 |
|---|---|---|---|
| launchd 夜间巡检 | 代理 + plist 环境变量 | 工具输出多时可 70–92% | 代理需 KeepAlive |
| 白天网关对话 | 代理或插件 | 约 40–70% | 短对话收益低 |
| 仅 MCP 小工具 | MCP 压缩 | 约 30–60% | 禁监听端口时 |
| 已用 Ollama 本地 | 跳过 Headroom | N/A | 见 Ollama 文 |
| 要对账 Token | 代理 + OTEL | 实测 | perf + 追踪 |
前置条件
- 网关
openclaw gateway status正常 - 宿主机 Python 3.10+
~/.openclaw/.env已配置密钥- 夜间任务：已有 launchd 模板
8 步实战：代理 + 巡检流水线
pip install "headroom-ai[proxy]"headroom proxy --port 8787headroom perf记录基线~/.openclaw/.env增加ANTHROPIC_BASE_URL=http://127.0.0.1:8787，openclaw gateway restart- 冒烟：
openclaw agent --message "仅总结 /tmp/openclaw/openclaw.log 最后 50 行" - 可选：
pip install "headroom-ai[all]"+openclaw doctor验证插件 - launchd：plist 写入环境变量；Headroom 用独立 KeepAlive 先于 OpenClaw 任务启动
- 对账：
headroom stats+ OTEL vs 控制台账单
情景 A — 高吞吐夜间代码审计
凌晨任务拉 git diff、测试日志、MCP linter 输出，单轮输入可达 5–8 万 Token；Headroom 公开基准中「代码库探索」行约 78,502 → 41,254。
务必同时限制审计范围（指定 MCP/文件）并开启压缩。
情景 B — 白天对话 + 夜间 MCP
代理承载全部提供商流量；另可 headroom mcp install 压缩 MCP 回包。用 OTEL 避免重复压缩链。
排错
连接被拒绝 :8787
改 env 后先 lsof -i :8787 确认代理已起，再重启网关；launchd 场景先起 Headroom。
perf 有节省但账单不变
检查 .env 与 config.yaml 是否都指向代理。
明确建议
- 开工具后账单暴涨： 上代理 → 重启网关 → launchd 保活 → 重跑一夜审计对比。
- 只有短对话： 先减工具调用，再谈压缩。
常见问题
Headroom 会把代码发到第三方 API 吗？
默认本地代理路径不会；详见 限制说明。
压缩太狠会不会搞坏 OpenClaw？
先用真实仓库审计冒烟，再开 launchd；需要全文时用 CCR retrieve。
端口用多少？
文档默认 8787。
和 Claude Code MCP 有何关系？
同一项目：OpenClaw 常改 base URL，MCP 客户端可 headroom mcp install。
每条请求都能省 80% 吗？
不能——公开基准约 47–92%，日志型巡检偏高、短对话偏低。用 perf + OTEL 实测。