tokflow

📊 本地LLM费用管家与降本专家

OpenClaw官方出品的本地Token消耗监控工具,纯本地运行零外网传输,帮助用户精准追踪LLM费用、优化提问方式、降低模型使用成本。

收藏
8.4k
安装
2.8k
版本
v0.5.0
CLS 安全性认证2026-06-04
点击查看完整报告 >

使用说明

核心用法

TokFlow 是一款专为 OpenClaw 用户设计的本地 Token 消耗监控与优化分析工具,通过调用本地 8001 端口的 TokFlow 服务 API,实现全量 LLM 使用数据的实时追踪。用户可通过 9 类查询指令获取多维数据:总览仪表盘展示今日/本月消耗与费用;模型列表与详情查询支持按成本排序和趋势分析;渠道统计与余额查询覆盖 DeepSeek、硅基流动等主流供应商;优化建议引擎提供模型替换、缓存策略、调用模式及提问方式四类降本方案;v0.5.0 新增的提问方式统计功能,可分析提问轮次、长度分布并预估节省空间。

显著优点

架构安全纯净:纯 Python 标准库实现,零外部依赖,仅通过 urllib 与本地服务通信,彻底杜绝供应链攻击风险。数据主权完整:所有 Token 消耗、费用明细、提问记录均在本地处理,无任何形式的数据外发,隐私保护达到 100%。功能闭环实用:从监控(实时余额)、诊断(费用趋势、异常检测)到优化(智能建议生成)形成完整降本闭环,提问方式分析更是业内少有的精细化运营工具。来源权威可信:OpenClaw 官方维护,GitHub 开源可审计,语义化版本管理规范。

潜在缺点与局限性

环境依赖刚性:必须预先部署并运行 TokFlow 后端服务(localhost:8001),对非技术用户存在门槛。功能边界受限:仅支持 OpenClaw 生态,无法对接其他 LLM 客户端或平台;优化建议基于历史数据推断,实际节省效果受业务场景波动影响。扩展性不足:API 地址硬编码,暂不支持自定义端口或远程服务;缺乏可视化界面,纯命令行交互对习惯 GUI 的用户不够友好。数据精度依赖上游:费用计算直接沿用 OpenClaw 原始值,若上游计费逻辑更新可能存在滞后。

适合的目标群体

OpenClaw 重度用户:日均调用量高、多模型并行、需精细管控预算的开发者与团队。成本敏感型组织:初创公司、AI 实验室、高校研究团队等需严格监控 LLM 支出的场景。运营优化人员:产品经理、Prompt 工程师希望通过提问方式分析提升调用效率、降低无效消耗。合规要求严格的行业:金融、医疗、政务等领域对数据不出本地有硬性规定的企业。

使用风险

服务可用性风险:若 TokFlow 后端未启动或端口冲突,所有查询将失败,需用户自行排查服务状态。数据时效性风险:基于本地 JSONL 会话文件同步,若 OpenClaw 日志轮转或清理策略调整,可能导致历史数据缺失。建议采纳风险:优化建议为算法生成,模型替换可能涉及性能权衡,需结合实际业务验证后再执行。版本兼容性风险:v0.5.0 新增提问方式统计功能,旧版 TokFlow 后端可能不支持,需保持前后端版本一致。

安全解读

TokFlow(v0.5.0)是一款专为OpenClaw生态设计的本地LLM Token消耗监控与优化平台,通过Python脚本调用localhost:8001本地API,实现零外发、零依赖的私有化成本管控方案。

核心用法

用户通过tokflow_query.py脚本执行9类查询:总览看板(dashboard)、模型统计(models)、渠道汇总(providers)、单模型详情(model-detail)、实时余额(balance)、优化建议(suggestions/生成)、消耗分析(analysis)、提问方式统计(prompt-stats)。所有数据源自OpenClaw本地JSONL会话文件,费用精度达6位小数。

显著优点

  • 绝对隐私安全:仅访问localhost:8001,无外发网络请求,数据不出本地
  • 零依赖攻击面:仅使用urllib/json/sys等Python标准库,无CVE漏洞风险
  • 功能完整:覆盖成本监控、余额预警、模型选型优化、提问效率分析全链路
  • v0.5.0新增:提问方式统计功能,可分析轮次、长度分布并量化可节省金额
  • T2可信来源:来自GitHub openclaw/skills官方组织仓库,维护者wangyaok1

潜在局限

  • 强依赖本地服务:必须预先部署TokFlow后端(8001端口),否则完全不可用
  • 数据源单一:仅支持OpenClaw会话文件,无法接入其他平台(如直连OpenAI/Claude API)
  • 无加密传输:本地HTTP通信,若8001端口被其他进程占用或劫持存在理论风险
  • 输入校验宽松:days参数无范围限制,异常输入可能导致查询失败

适合人群

  • 使用OpenClaw作为LLM聚合层的技术团队/个人开发者
  • 需要精细化成本分摊、部门级预算管控的企业用户
  • 对数据外发敏感、要求私有化部署的金融/医疗/政务场景
  • 希望优化Prompt工程、降低无效Token消耗的效率导向用户

常规风险

  • 服务可用性风险:本地服务未启动时Skill完全失效,需人工排查
  • 数据时效性:依赖OpenClaw会话文件同步,非实时秒级更新
  • 余额API稳定性:DeepSeek/硅基流动等渠道余额查询依赖各平台API,可能因对方限流/变更而失败
  • 建议仅供参考:优化建议基于历史数据统计,实际节省效果受业务场景影响

tokflow 内容

scripts文件夹
手动下载zip · 5.7 kB
tokflow_query.pytext/plain
请选择文件