Token Stats

token-stats — 选择一个 Agent 查看其消耗情况

核心原则

1. 每次运行均弹出交互式菜单 — 想查看哪个 Agent 的数据就选哪个，不预设默认值
2. 数据完全来自本地 — 不联网，仅读取你本地存储的 Agent 数据文件
3. 零外部依赖 — 仅使用 Python 标准库，安装后即可直接运行

前置条件

• Python 3.11 或更高版本
• 至少已运行过以下任一 Agent 并产生使用记录：Hermes / Claude Code / CodeX / OpenClaw
• 安装方式：clawhub install agent-usage-stats，随后执行 python3 ~/skills/agent-usage-stats/token-stats.py setup

用法速查

# 启动交互式菜单（默认行为）
token-stats

# 跳过菜单，直接查看指定 Agent 的统计
token-stats -a hermes
token-stats -a claude-code
token-stats -a codex

# 实时监控模式（持续刷新）
token-stats --watch
token-stats -a hermes --watch

# 列出当前系统中已安装支持的 Agent 后端
token-stats --list-backends

# 查看当前版本号
token-stats --version

Hermes 集成

在 Hermes 的 SKILL.md 文件中可按如下方式配置：

run: token-stats -a hermes

如此配置后，每次任务执行完毕将自动输出 Hermes 的 token 消耗统计，且不触发交互式菜单。

数据源说明

命令行