Агент максимальной экономии: маршрутизация OpenClaw через прокси Headroom и снижение счёта API на 80 %

OpenClaw шлюзы на macOS сильны в долгих агентах: MCP fan-out, чтение workspace и задачи, заливающие мегабайты логов в каждый ход модели. Headroom (GitHub: chopratejas/headroom) —локальный слой сжатия перед LLM (прокси, библиотека, MCP), уменьшающий вывод инструментов, JSON и историю до 60–95% тарификации. Публичные бенчмарки: 65,694 → 5,118 меньше токенов; SRE-разбор с 92% токенов (

Если OpenClaw на Mac mini M4 с ночными аудитами через согласование launchd и шлюза , не хватает маршрутизации Anthropic через прокси Headroom—иначе grep и сканы репозитория съедают бюджет API. Env-прокси, соседство LaunchAgent, MCP и ночной конвейер высокой пропускной способности—минимальный питч NodeMac.

Почему OpenClaw + Headroom неизбежны

Агенты OpenClaw tool-heavy: ФС, MCP stdio, webhook, многошаговые задачи.

1. Тысячи файлов.
2. Полный JSON CI/linter.
3. Повтор tool payload в следующий ход.

Anthropic считает входные токены. Без сжатия 50k–80k за проход по репо.

Headroom дополняет матрицы, не заменяет матрица приоритета env шлюза и матрица allowlist транспорта MCP. Прозрачный HTTP-shim, ContentRouter, CCR локально.

Архитектура: три режима

┌─────────────────────────────────────────────────────────────┐
│  OpenClaw Gateway (launchd)                                 │
│    skills · MCP tools · scheduled nightly audit jobs        │
└───────────────────────────┬─────────────────────────────────┘
                            │ HTTPS (Anthropic-compatible)
                            ▼
┌─────────────────────────────────────────────────────────────┐
│  Headroom Proxy 127.0.0.1:8787  (launchd or headroom wrap)  │
│  CacheAligner → ContentRouter → SmartCrusher / Code / CCR   │
└───────────────────────────┬─────────────────────────────────┘
                            │ compressed /v1/messages
                            ▼
                    api.anthropic.com (or Bedrock/OpenRouter)

Матрица стоимости

При $3/M входа 40k→12k ≈ $0.084/запуск, ~$2.5/мес/репо ежедневно; 20 репо окупают Mac mini M4.

Сценарий A: ночной аудит

Цель: 02:00: скан workspace, статика, Slack.

Без Headroom: JSON линтеров каждый ход, >30 мин., лимиты.

С Headroom: Сжатие JSON; с согласование launchd и шлюза после :8787/health.

Пропускная способность: ~70% меньше входа → 2–3× репо за ночь.

Сценарий B: интерактивный шлюз

Цель: Днём чат через мосты, ночью тот же хост.

Риск: OOM с --llmlingua на 16 ГБ.

Смягчение: Без LLMLingua (~1 ГБ), лимиты сессий, /stats→Prometheus.

Рекомендуемый путь

• Прод launchd: ANTHROPIC_BASE_URL в plist — матрица приоритета env шлюза.
• Комплаенс: CCR вкл.
• Корп. egress: матрица TLS egress-прокси для TLS к Anthropic.
• <40% за неделю: /stats-history.

Runbook: 8 шагов на Mac mini M4

1. Установить Headroom

pip install "headroom-ai[proxy,mcp]"
headroom --version

2. Запустить прокси локально и проверить health

headroom proxy --host 127.0.0.1 --port 8787 \
  --log-file ~/.headroom/openclaw-proxy.jsonl
curl -s http://127.0.0.1:8787/health | jq .

После тестовых вызовов ожидайте "optimize": true и рост tokens_saved (документация прокси).

3. Базовый расход токенов (одна задача OpenClaw)

Запустите репрезентативный аудит без прокси (напрямую в Anthropic). Зафиксируйте входные токены в панели Anthropic или логах шлюза. Документация Anthropic.

4. Направить OpenClaw на Headroom через env LaunchAgent

Добавьте в словарь EnvironmentVariables plist шлюза OpenClaw (продакшен-путь—важнее .env):

<key>ANTHROPIC_BASE_URL</key>
<string>http://127.0.0.1:8787</string>
<key>ANTHROPIC_API_KEY</key>
<string>sk-ant-…</string>

Перезагрузка: launchctl kickstart -k gui/$(id -u)/ai.openclaw.gateway (подстройте label под вашу установку).

5. Опционально: OpenAI-совместимые модели через тот же прокси

export OPENAI_BASE_URL=http://127.0.0.1:8787/v1

Задокументируйте, какие ключи провайдеров в Keychain, а какие в plist—никогда не коммитьте секреты.

6. Установить Headroom MCP для статистики сжатия в полёте

headroom mcp install

Зарегистрируйте в конфиге MCP OpenClaw по матрице allowlist транспорта MCP—префикс инструментов headroom_ против коллизий.

7. Ночной аудит с готовностью шлюза и прокси

#!/bin/bash
set -euo pipefail
curl -sf http://127.0.0.1:8787/health >/dev/null
curl -sf http://127.0.0.1:18789/health >/dev/null  # OpenClaw gateway port—adjust
/usr/local/bin/openclaw job run --workspace ~/audits/acme --profile nightly

Ежедневно логируйте вывод curl http://127.0.0.1:8787/stats в SIEM.

8. Измерить экономию и настроить бюджетные алерты

headroom perf
curl -s http://127.0.0.1:8787/stats | jq '.stats.savings_percent'

Опционально: headroom proxy --budget 50.0 для дневного лимита в USD. Алерт, если savings_percent < 35% три ночи подряд—проверьте утечки заголовка x-headroom-bypass: true.

Устранение неполадок

OpenClaw всё ещё бьёт напрямую в api.anthropic.com

Симптом: Панель Anthropic показывает полный счёт токенов; /stats не растёт.

Исправление: launchctl print gui/$(id -u)/ai.openclaw.gateway | grep ANTHROPIC—подтвердите эффективное env. Удалите конфликтующий ANTHROPIC_BASE_URL из низкоприоритетного .env. Перезапустите шлюз после правки plist.

Сжатый аудит теряет построчный контекст багов

Симптом: Агент резюмирует, но указывает неверные номера строк.

Исправление: Включите CCR-извлечение в инструкциях агента («вызовите headroom_retrieve перед закрытием Sev-1»). Временно x-headroom-bypass: true на одном воспроизведении. Сузьте SmartCrusher, если JSON-схема теряет ключи.

Прокси стартует, OpenClaw получает HTTP 502

Симптом: Логи шлюза: отказ соединения к :8787.

Исправление: Headroom в отдельном LaunchAgent с KeepAlive=true. Сдвиг загрузки: Headroom на +15 с раньше шлюза OpenClaw через ThrottleInterval launchd.

Perplexity pruning или proxy CCR? См. сравнение Headroom vs LLMLingua —матрица решений, гибрид --llmlingua, 8-шаговый runbook.

Частые вопросы

Меняет skills/MCP?

В режиме прокси изменения кода не нужны. Маршрутизация через ANTHROPIC_BASE_URL. Skills и MCP-серверы те же; сжимаются только payload промптов на HTTP-границе.

Потери для security-аудита?

Headroom использует обратимый CCR—оригиналы локально; модель забирает дословные фрагменты при необходимости. Бенчмарки: ±0 на GSM8K и 97 % точности SQuAD v2 при ~19 % сжатии. Продолжайте golden-file тесты JSON-схем линтеров.

Отличие от egress?

Корпоративные egress-прокси контролируют исходящий путь и TLS-инспекцию. Headroom—localhost LLM-прослойка, сжимающая тела сообщений. Используйте оба: Headroom на loopback, egress-правила для upstream Anthropic. матрица TLS egress-прокси.

Claude Code на том же Mac?

Да. Headroom поддерживает headroom wrap claude и общую кросс-агентную память. Шлюз OpenClaw на закреплённом plist env; wrap-режим только для интерактивной разработки.

Экономия ночью?

Tool-heavy аудиты часто дают 50–85 % снижения входа по опубликованным agent workloads Headroom. Chat-лёгкие шлюзы могут видеть < 30 %—измеряйте неделю через /stats-history, прежде чем обещать финансам 80 %.

Related reading

• Прогноз GPT-5.6: Codex open source для эффективности агентов