Skillppx logo

Token Counter

分析 OpenClaw 会话中的 token 消耗情况，支持按类别、客户端、工具等维度生成报告。

已扫描
适合谁
需要监控 AI 成本的开发者、使用 OpenClaw 进行自动化任务的团队
不适合谁
未部署 OpenClaw 环境的用户、无需分析 token 使用情况的普通用户
国内可用性
需网络配置。可能需要网络配置或第三方服务可访问。
安装难度
新手友好（★☆☆）。基于终端操作、依赖、API Key 和本地环境要求的初步判断。

安装与下载

openclaw skills install @mkhaytman87/token-counter
下载官方 ZIP

Skill 说明

命令、参数、文件名以原文为准

Token 计数器

概述

使用此技能从本地 OpenClaw 数据生成 token 使用报告。它解析会话转录（.jsonl）、会话元数据和 cron 定义，然后按类别、客户端、工具、模型以及主要 token 消费者进行统计报告。

快速开始

运行以下命令：

$OPENCLAW_SKILLS_DIR/token-counter/scripts/token-counter --period 7d

常用命令

1) 生成基础报告：

$OPENCLAW_SKILLS_DIR/token-counter/scripts/token-counter --period 7d

2) 聚焦特定分类维度：

$OPENCLAW_SKILLS_DIR/token-counter/scripts/token-counter \
  --period 1d \
  --breakdown tools,category,client

3) 分析单个会话：

$OPENCLAW_SKILLS_DIR/token-counter/scripts/token-counter \
  --session agent:main:cron:d3d76f7a-7090-41c3-bb19-e2324093f9b1

4) 导出 JSON 格式结果：

$OPENCLAW_SKILLS_DIR/token-counter/scripts/token-counter \
  --period 30d \
  --format json \
  --output $OPENCLAW_WORKSPACE/token-usage/token-usage-30d.json

5) 保存每日快照：

$OPENCLAW_SKILLS_DIR/token-counter/scripts/token-counter \
  --period 1d \
  --save

该命令将 JSON 文件写入：

$OPENCLAW_WORKSPACE/token-usage/daily/YYYY-MM-DD.json

默认配置与数据源

  • 会话索引：$OPENCLAW_DATA_DIR/agents/main/sessions/sessions.json
  • 会话转录文件：$OPENCLAW_DATA_DIR/agents/main/sessions/*.jsonl
  • Cron 定义文件：$OPENCLAW_DATA_DIR/cron/jobs.json

解析器读取助手的 usage 字段获取 token 数量，并通过工具调用记录进行归属分析。

归属说明

  • 工具 token 归属采用启发式规则：一个助手消息中的 token 数量会根据该消息中包含的工具调用进行分配。
  • 会话的 totalTokens 可能来自会话索引元数据或转录文件中的 usage 总和（取两者最大值）。
  • 客户端识别基于规则（personal、bonsai、mixed、unknown），通过路径、域名、邮箱等标记进行判断。

验证

运行以下命令进行验证：

python3 $OPENCLAW_SKILLS_DIR/skill-creator/scripts/quick_validate.py \
  $OPENCLAW_SKILLS_DIR/token-counter

参考资料

参见：

  • references/classification-rules.md 了解类别/客户端检测逻辑及关键词映射规则。
M
@mkhaytman87

已收录 2 个 Skill

相关推荐