SuperAPI AI 工具集
合作ENAI 行业资讯收藏
Skill 广场token-reporter

token-reporter

办公与效率

查看项目

更新于 10-15 08:06

技能介绍

Token Reporter 用于每日自动统计本机 OpenClaw 实例的 Token 消耗和 Agent 工作产出，格式化后写入飞书多维表格。作者为 Daniel Li。

用途

该技能面向需要按日追踪 OpenClaw 实例 Token 用量与各 Agent 工作产出的场景，将统计结果上报到飞书多维表格，便于团队查看与记录。

主要能力

  1. 扫描 JSONL 日志：扫描 ~/.openclaw/agents//sessions/.jsonl 中当日增量数据。每条 assistant 消息携带 usage 对象，包含 input、output、cacheRead、cacheWrite、totalTokens 以及 cost 等字段。

  2. 按 Agent + Model 聚合：重点追踪 4 个模型，其他模型归入“其他”。

  • opus4.6：匹配 claude-opus-4-6 (xingsuancode, xingjiabiapi)
  • glm-5：匹配 zai/glm-5
  • minimax-M2.5：匹配 minimax/MiniMax-M2.5
  • gemini-3-pro：匹配 gemini-3-pro (xingjiabiapi)

  1. 格式化 Token 明细：输出形如“opus4.6: input 320K / output 18K / cache 82% / $4.2”的文本。cache% 计算公式为 cacheRead / (input + cacheRead + cacheWrite) × 100。

  2. 收集产出：汇总各 agent 当日工作摘要，格式示例为“code: KGKB工厂30/30完成, 5平台发布脚本 | content: 小红书×2, 选题推荐 | ops: cron改造, 服务器巡检”。产出收集方式包括：读取当日 memory 文件 ~/clawd/memory/$(date +%Y-%m-%d).md；解析 ## Agent名 段落或关键词匹配；如无 memory 文件，则从 JSONL 最后一条 user/assistant 消息摘要推断。

  3. 写入飞书多维表格：使用 lark-mcp 工具写入 Bitable。字段包括员工名称（文本，config 填写，config.json 写死 person）、Token明细（文本，脚本统计，4模型格式化文本）、产出（文本，脚本统计，各agent当日工作摘要）、个人总结（文本，人填，员工手动填写，留空）、评分（单选，高层选，优秀/良好/不及格，留空）、时间（日期，脚本自动，当天日期）。飞书 API 参考 skill: ~/clawd/skills/feishu-automation/SKILL.md，工具前缀 mcp__lark-mcp_*，新增记录使用 mcp__lark-mcp_createRecord，查询记录使用 mcp__lark-mcp_listRecords。

使用方式

脚本用法：

  • 统计当日 Token（只看数据，不上报）：python scripts/report.py --scan-only
  • 统计 + 上报飞书：python scripts/report.py --report
  • 指定日期：python scripts/report.py --date 2026-03-17 --scan-only
  • 使用指定配置：python scripts/report.py --config /path/to/config.json --report

Cron 配置建议：可配置每日 23:00（Asia/Shanghai）执行 agentTurn，依次运行 --scan-only、确认数据、运行 --report、确认飞书写入成功后通过 message(action=send, channel=telegram, target=-1003890797239) 简要汇报，失败则报告错误原因。

配置：安装时复制 config.example.json → config.json 并填写 person、instance、lark_app_id、bitable_app_token、bitable_table_id。

文件结构：token-reporter/ 包含 SKILL.md、config.example.json（配置模板，安装时复制为 config.json）、scripts/report.py（核心统计脚本）、references/jsonl-structure.md（JSONL 数据结构参考）。

实例对应关系：aa（本机）对应 CEO Agent 小a (main)、上报人 Daniel；Peter Mini 对应小兔 (xiaotu)、上报人 Peter；小m 对应小m bot、上报人小m。

适用场景

适用于需要按日统计 OpenClaw 实例 Token 消耗、汇总各 Agent 工作产出并上报飞书多维表格的团队或个人。触发词包括“token报告”“token report”“日报”“每日汇报”“飞书上报”。

限制与错误处理

  • JSONL 文件损坏：跳过该行，记录警告。
  • 无当日数据：报告“当日无数据”。
  • 飞书 API 失败：重试3次，失败后本地缓存结果。
  • config.json 不存在：提示复制 config.example.json。
  • Memory 文件不存在：产出标记为“无记录”。

其他信息（如收费、价格、平台支持范围等）暂未提供。