claw-tsaver

MCP-прокси для экономии токенов для пользователей OpenClaw. Сокращает полезную нагрузку вызовов инструментов на 90%+ за счет «ленивого» (отложенного) развертывания.

Зачем

Вызовы инструментов MCP часто возвращают тысячи токенов HTML или JSON в одном ответе, но модель обычно использует лишь 5% из них. Оставшиеся 95% незаметно расходуют контекстное окно и увеличивают затраты. claw-tsaver располагается между OpenClaw и вашими нижестоящими MCP-серверами, перехватывает слишком большие ответы и предоставляет модели компактный предварительный просмотр + дескриптор для доступа по требованию.

Related MCP server: TokenSaver MCP

Как

sequenceDiagram
    participant U as OpenClaw (Claude)
    participant C as claw-tsaver proxy
    participant F as fetch / puppeteer / etc.
    U->>C: call_tool("fetch", url)
    C->>F: forward call
    F-->>C: 11,507 tokens of HTML
    Note over C: tiktoken count > threshold
    C->>C: store full content in SQLite
    C-->>U: {preview_head, preview_tail, expand_handle}<br/>(only 104 tokens)
    Note over U: model decides if it needs full text
    U->>C: expand_content(handle)
    C-->>U: full 11,507 tokens

Реальные измерения

Протестировано на OpenClaw + Claude Sonnet 4.6 + mcp-server-fetch, 25.04.2026. Исходные данные: benchmarks/mvp-day1-fetch.jsonl.

Быстрый старт

1. Предварительные требования

Установите uv (однократная настройка):

curl -LsSf https://astral.sh/uv/install.sh | sh

Установка claw-tsaver не требуется — uvx загрузит и запустит его по запросу.

2. Настройка нижестоящих MCP-серверов

Отредактируйте ~/.claw-tsaver/config.json (первый запуск claw-tsaver-mcp автоматически создаст шаблон):

{
  "downstream_servers": [
    {"name": "fetch", "command": "uvx", "args": ["mcp-server-fetch"]}
  ],
  "compression_threshold_tokens": 500
}

3. Регистрация в OpenClaw

Добавьте этот блок на верхний уровень ~/.openclaw/openclaw.json:

"mcp": {
  "servers": {
    "claw-tsaver": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/Yang1Bai/claw-tsaver",
               "claw-tsaver-mcp"]
    }
  }
}

Затем перезапустите шлюз OpenClaw: openclaw gateway restart

Панель управления

Опционально: локальный веб-интерфейс для просмотра статистики экономии токенов в реальном времени.

uvx --from git+https://github.com/Yang1Bai/claw-tsaver claw-tsaver-dashboard

Откройте http://localhost:7878 в вашем браузере.

Дорожная карта

• [x] Модуль A: прокси с ленивым развертыванием (этот релиз)

• [x] Модуль D: локальная панель управления (этот релиз)

• [ ] Модуль B: маршрутизация инструментов (автоматическая загрузка только релевантных MCP для каждого шага)

• [ ] Модуль C: сжатие истории диалогов (атомарные карточки фактов)

Лицензия

MIT — см. файл LICENSE.

Участие в разработке

Приветствуются сообщения об ошибках и PR.