SuperAPI AI 工具集

claw-tsaver

claw-tsaver 是一个面向 OpenClaw 用户的 MCP 代理工具,通过懒加载扩展机制将工具调用的 token 消耗削减 90% 以上。MCP 工具调用(如 fetch、puppeteer)经常在单次响应中返回数千 token 的 HTML 或 JSON,但模型通常只使用其中约 5%,其余 95% 会悄悄占用上下文窗口并增加成本。claw-tsaver 位于 OpenClaw 与下游 MCP 服务器之间,拦截超过可配置 token 阈值的过大响应,将完整内容存入本地 SQLite 数据库,并向模型返回一个紧凑预览加按需扩展句柄;模型需要更多内容时,可调用 expand_content 工具按需获取。项目以 MIT 许可开源,欢迎提交 Issue 和 PR。

访问官网

工具介绍

claw-tsaver 是一个为 OpenClaw 用户设计的 MCP 代理工具,核心目标是通过懒加载扩展机制显著降低工具调用产生的 token 消耗。

用途 MCP 工具调用(如 fetch、puppeteer)经常在单次响应中返回数千个 token 的 HTML 或 JSON,而模型通常只使用其中约 5% 的内容,剩余 95% 会隐性消耗上下文窗口并增加使用成本。claw-tsaver 作为 OpenClaw 与下游 MCP 服务器之间的代理层,专门解决这一问题。

主要能力

  • 拦截过大的响应:当响应超过可配置的 token 阈值时进行拦截。
  • 将完整内容存储到本地 SQLite 数据库。
  • 向模型返回紧凑预览和按需扩展句柄。
  • 模型需要更多内容时,可调用 expand_content 工具按需获取。
  • 官方称可将工具调用载荷削减 90% 以上。
  • 提供可选的本地 Web UI,用于实时查看 token 节省统计。

使用方式

  1. 安装 uv(一次性设置)。无需安装 claw-tsaver,uvx 会按需获取并运行。
  2. 配置下游 MCP 服务器:编辑 ~/.claw-tsaver/config.json(首次运行 claw-tsaver-mcp 会自动创建模板)。
  3. 注册到 OpenClaw:在 ~/.openclaw/openclaw.json 的顶层添加相应配置块,然后重启 OpenClaw gateway:openclaw gateway restart。
  4. 可选:启动本地 Web UI 查看实时 token 节省统计,在浏览器中打开 http://localhost:7878。

模块构成

  • Module A:懒加载扩展代理(本版本发布)。
  • Module D:本地仪表盘(本版本发布)。
  • Module B:工具路由(每轮自动仅加载相关 MCP,尚未发布)。
  • Module C:对话历史压缩(原子事实卡片,尚未发布)。

实测数据 官方称在 OpenClaw + Claude Sonnet 4.6 + mcp-server-fetch 上于 2026-04-25 测试,原始数据见 benchmarks/mvp-day1-fetch.jsonl。

适用场景 适用于使用 OpenClaw 并接入了会返回大量 HTML 或 JSON 的 MCP 服务器(如 fetch、puppeteer)的用户,希望减少上下文窗口占用、降低 token 成本。

限制

  • 具体可配置的 token 阈值范围暂未提供。
  • Module B 和 Module C 的功能尚未发布。
  • 除上述实测环境外,其他环境下的效果暂未提供。
  • 项目以 MIT 许可开源,详见 LICENSE 文件。