AI / 자동화
2026년 6월 4일
OpenClaw를 Headroom 프록시로 라우팅해 API 비용 절감
VpsGona 팀
2026년 6월 4일
~14분
Headroom로 OpenClaw 도구 출력을 압축(프록시 8787, 서울 노드). onboard, OTEL, launchd.
고지: 선택적 Mac 렌탈.
구조
OpenClaw → Headroom http://127.0.0.1:8787 → API
| Mode | When | OpenClaw hook |
|---|---|---|
headroom proxy --port 8787 | Zero code change | Set ANTHROPIC_BASE_URL in ~/.openclaw/.env |
| ContextEngine plugin | Native OpenClaw path | Headroom providers/openclaw slice |
MCP headroom_compress | MCP-heavy flows | headroom mcp install |
headroom wrap | One-shot dev | Less ideal for 24/7 gateway |
매트릭스
| Pattern | Hook | Savings band | Ops |
|---|---|---|---|
| Nightly launchd audit | Proxy + plist env | 70–92% on tool-heavy turns | Keep proxy alive with LaunchAgent |
| Interactive gateway chat | Proxy or plugin | 40–70% | Low gain on tiny prompts |
| MCP-only micro tools | MCP compress tool | 30–60% | When proxy blocked |
| Already on Ollama local | Skip Headroom | N/A | See Ollama OpenClaw guide |
| Need token accounting | Proxy + OTEL | Measure, don’t guess | headroom perf + spans |
전제
- 게이트웨이 정상 · Python 3.10+
8단계
pip install "headroom-ai[proxy]"headroom proxy --port 8787headroom perfANTHROPIC_BASE_URL=http://127.0.0.1:8787- smoke agent
- 선택 플러그인
- launchd
- OTEL
야간 감사
로그·diff 많을 때 60–92% 가능.
MCP
프록시 + MCP, OTEL로 측정.
문제해결
연결 거부: 프록시 먼저. 청구 동일: base URL 확인.
권장
도구 많으면 프록시 필수.
FAQ
Does Headroom send my code to a third-party API?
No for the default local proxy—compression runs on your host; see limitations.
Will OpenClaw break if compression is too aggressive?
Headroom publishes benchmark accuracy tables; use CCR retrieve when the model needs full files. Smoke-test one real audit before automating.
What port should I standardize on?
8787 is the documented default for headroom proxy --port 8787.
How does this relate to Claude Code MCP Headroom?
Same project: headroom mcp install for MCP clients; OpenClaw users usually set provider base URL to the proxy.
Can I save ~80% on every request?
No—published ranges are 47–92% by workload. Log-heavy OpenClaw audits trend high; short chat trends low. Use headroom perf and OTEL.