如果你在 OpenClaw 社区待过超过一周,肯定见过这类帖子:
"每个月 API 调用花了 3600 美元。"
"一觉醒来,因为心跳循环跑了一整夜,账单多了 200 刀。"
"我完全不知道我的 Agent 到底花了多少钱。"
OpenClaw 算是 2026 年最兴奋的开源项目之一了——GitHub stars 超过 21 万,是个真正能“做事”的个人 AI agent。但问题在于,一旦你给 AI agent unrestricted 访问付费 API 的权限,简直就是玩火。
看多了这些openclaw不受控制的事情,我发现没人构建过一个合适的解决方案。市面上是有几个监控工具(ClawMetry 给你只读统计,Tokscale 是纯 CLI 的),「当然它们也支持监控,但是我看了下没法实时止损,就暂不介绍了。」
所以今天向大家推荐一款openclaw管理工具。
TokPinch 是做什么的
TokPinch 是一个透明代理, 介于 OpenClaw 和你的 LLM 提供商(Anthropic, OpenAI)之间。每个 API 请求都会经过它。
设置非常简单,OpenClaw 配置里改一行就行:
ounter(lineANTHROPIC_BASE_URL=http://localhost:4100/v1
就这样。你的 agent 根本不知道 TokPinch 的存在。但现在你有了:
- 「实时成本追踪」 —— 每个请求都记录模型、tokens、成本和 session
- 「预算强制执行」 —— 设置日/月限额,超了直接 blocking 请求
- 「循环检测」 —— 捕获 runaway agents(疯狂请求、重复内容、成本螺旋、心跳风暴)并自动暂停
- 「智能模型路由」 —— 自动把便宜任务(心跳、短消息)从 Opus 降级到 Haiku,省 10-50%
- 「Telegram/邮件警报」 —— 出事下一秒就通知你
- 「一个不拉胯的 Dashboard」 —— 暗色模式、实时 WebSocket 更新、成本图表、预算 gauge
架构设计
想要 TokPinch 快、能自托管,而且不依赖外部服务。
ounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineOpenClaw → TokPinch (localhost:4100) → Anthropic/OpenAI ↓ SQLite (仅元数据) ↓ React Dashboard + WebSocket ↓ Telegram/邮件警报
技术栈如下:
- 「TypeScript」 —— 端到端
- 「Fastify」 —— 最快的 Node.js HTTP 框架,做代理完美
- 「SQLite」 (better-sqlite3) —— 零配置,WAL 模式支持并发读,基于文件所以随处部署
- 「React 18 + Vite + Tailwind」 —— 用于 Dashboard
- 「Docker」 —— 多阶段构建,非 root 运行,只读文件系统
「我们都知道现在这种代理架构都是快速响应组件组成的,而数据持久化的核心是 SQLite。」
关键的设计决策:「TokPinch 绝不存储 API key 或消息内容。」 Key 只在 he…