概述
AI agent 上下文压缩代理。自动压缩 tool output 等上下文内容，节省 60–95% tokens。
安装
pipx install "headroom-ai" pipx inject "headroom-ai" "headroom-ai[proxy]"
[toc]
启动
headroom proxy --port 8787开机自启：通过 ~/.config/systemd/user/headroom-proxy.service 管理。
状态查看
headroom doctor统计数据
curl http://localhost:8787/stats | python3 -m json.tool | less集成到 OpenClaw
已通过 ContextEngine 插件集成。见 OpenClaw 目录下的完整文档。
压缩效果
| 策略 | 典型场景 | 节省率 |
|---|---|---|
| SmartCrusher | JSON 列表 | 80–90% |
| Kompress v2 | 长文本 | 50–70% |
| Log | 日志行 | 80–90% |
- 小负载（<500 tokens）跳过压缩
- 代码和 grep 结果不压缩（保证正确性）