正文内容
token-stats — 选择一个 Agent 查看其消耗情况
核心原则
- 每次运行均弹出交互式菜单 — 想查看哪个 Agent 的数据就选哪个，不预设默认值
- 数据完全来自本地 — 不联网，仅读取你本地存储的 Agent 数据文件
- 零外部依赖 — 仅使用 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 消耗统计，且不触发交互式菜单。
数据源说明
| Agent | 数据读取路径与位置 |
|---|---|
| Hermes |
~/.hermes/state.db → sessions 表 |
| Claude Code | ~/.claude/projects/**/*.jsonl |
| CodeX |
~/.codex/state_*.sqlite → threads 表 |
| OpenClaw | ~/.openclaw/agents/main/sessions/ |