claw-tsaver

Un proxy MCP de ahorro de tokens para usuarios de OpenClaw. Reduce las cargas útiles de llamadas a herramientas en más de un 90% mediante expansión diferida.

Por qué

Las llamadas a herramientas MCP a menudo devuelven miles de tokens de HTML o JSON en una sola respuesta, pero el modelo normalmente utiliza solo el 5% de ellos. El 95% restante consume silenciosamente la ventana de contexto y aumenta el costo. claw-tsaver se sitúa entre OpenClaw y tus servidores MCP descendentes, intercepta las respuestas de gran tamaño y entrega al modelo una vista previa compacta + un manejador bajo demanda.

Related MCP server: TokenSaver MCP

Cómo

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

Medición real

Probado en OpenClaw + Claude Sonnet 4.6 + mcp-server-fetch, 25-04-2026.
Datos brutos: benchmarks/mvp-day1-fetch.jsonl.

Inicio rápido

1. Requisitos previos

Instala uv (configuración única):

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

No se necesita instalación de claw-tsaver: uvx lo buscará y ejecutará bajo demanda.

2. Configurar servidores MCP descendentes

Edita ~/.claw-tsaver/config.json (la primera ejecución de claw-tsaver-mcp creará automáticamente una plantilla):

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

3. Registrar con OpenClaw

Añade este bloque en el nivel superior de ~/.openclaw/openclaw.json:

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

Luego reinicia la puerta de enlace de OpenClaw: openclaw gateway restart

Panel de control

Opcional: una interfaz web local para estadísticas de ahorro de tokens en tiempo real.

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

Abre http://localhost:7878 en tu navegador.

Hoja de ruta

• [x] Módulo A: proxy de expansión diferida (esta versión)

• [x] Módulo D: panel de control local (esta versión)

• [ ] Módulo B: enrutamiento de herramientas (carga automática solo de MCPs relevantes por turno)

• [ ] Módulo C: compresión del historial de conversación (tarjetas de hechos atómicos)

Licencia

MIT — ver archivo LICENSE.

Contribución

Las incidencias y PRs son bienvenidas.