前言¶
在 OpenClaw 或同类 Agent 里连续开多个会话时，模型调用会分散在不同对话里。单靠账单或单次请求的日志，很难回答「今天一共用了多少 token」「哪个模型占大头」「输入、输出和 cache 各是多少」这类问题。下面介绍 SkillHub 上的社区 Skill token用量实时监控（@user_acdf755c/token-monitor），它面向 OpenClaw 的 token 使用数据做汇总与分析，适合在对话里直接问用量、趋势和模型分布。
这是什么¶
token用量实时监控 是一条基于通用 SKILL.md 格式的数据分析类 Skill：监控并分析 OpenClaw 跨会话的 token 使用情况，展示所用模型、输入/输出/cache 等计数，以及按日与按小时的分布趋势。
| 项 | 内容 |
|---|---|
| SkillHub 坐标 | @user_acdf755c/token-monitor |
| 版本 | 1.0.0 |
| 来源 | community（社区） |
| 分类 | data-analysis |
| 发布者 | user_acdf755c（SkillHub 页面标注作者 Mike） |
| 标签 | requires_api_key=false（无需额外 API Key） |
| 官方入口 | API 页、SkillHub 详情 |
SkillHub 抓取数据（2026-10-22 前后）：评分 100000，下载约 929 次。页面展示的「安装」计数可能与个人环境不一致，以 SkillHub 实时页面为准。
核心功能¶
以下能力均来自官方简介，未在资料中出现的细项不写。
- 跨会话汇总：在多个 session 维度上统计 OpenClaw token 使用，而不是单次对话片段。
- 模型维度：列出实际使用过的模型，便于对照「模型 usage / API usage」类问题。
- Token 拆分：区分 input、output、cache 等计数，便于判断 prompt 长度、生成量与缓存命中情况。
- 时间趋势：提供 按日（daily trends） 与 按小时（hourly breakdowns） 的 breakdown，用于观察用量高峰与日常波动。
- 对话触发：当用户关心 token 用量、API 消耗、成本跟踪、模型统计或趋势时，Agent 可按 Skill 说明自动选用本 Skill。
官方列出的触发关键词包括：token usage、用量、token统计、消耗、cost、花费、model usage、API usage。
安装与启用¶
安装流程以 SkillHub 安装文档 为准：先确认本机有 skillhub CLI，再把 Skill 装到当前 Agent 实际读取的 skills 目录（装错目录会导致 Agent 识别不到）。
1、检查 SkillHub CLI¶
command -v skillhub && skillhub --version
若未安装，可按官方文档执行完整安装（CLI + 默认 Skill）或仅 CLI：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only
2、安装本 Skill¶
将坐标 @user_acdf755c/token-monitor 安装到当前环境的 skills 目录。--dir 必须指向该 Agent 的 skills 路径，例如：
skillhub install user_acdf755c/token-monitor --dir ~/.cursor/skills/
skillhub install user_acdf755c/token-monitor --dir ~/.claude/skills/
skillhub install user_acdf755c/token-monitor --dir ~/.codex/skills/
OpenClaw 及 NanoBot、PicoClaw 等变体通常使用各自的 skills 目录；Cursor、Claude Code、Codex 等客户端路径以 安装文档第四节 列举为准。安装后若 Agent 未加载新 Skill，按所用客户端说明重启或刷新 skills。
也可将下面提示词交给已接入 SkillHub 的 AI，由其按安装文档完成安装：
请根据 https://skillhub.cn/install/skillhub.md，安装 `@user_acdf755c/token-monitor`。
资料中未给出本 Skill 专属的额外配置文件或环境变量；requires_api_key=false 表示不依赖单独配置的 API Key（具体仍取决于 OpenClaw 自身如何记录 token）。
典型用法¶
本 Skill 的设计是：用户在自然语言里提问，Agent 读取 SKILL.md 后调用既有 OpenClaw 用量数据并整理结果。官方未提供独立 CLI 子命令示例，下面问法与简介中的 Use when / Triggers 一致，便于复现意图（实际输出格式以安装后的 Skill 正文为准）：
- 「帮我看一下最近 OpenClaw 的 token 用量，按 input/output/cache 分开。」
- 「今天和昨天的 token 消耗趋势怎么样？有没有 按小时 的高峰？」
- 「model usage 统计一下，哪些模型用得最多？」
- 「想做 cost / 花费 粗算，先给我 API usage 和 token 统计。」
先做安装并确认 Agent 已加载 Skill，再在对话中使用上述中文或英文触发词即可。
适用场景与注意¶
适合谁
- 使用 OpenClaw（及共享同一套 token 记账方式的部署），需要在对话里快速查用量、模型分布与日/小时趋势的开发者或运维。
- 关心 API consumption、token trends，但不想每次手工翻日志或拼 SQL 的场景。
限制与注意
- 分析对象是 OpenClaw token usage；若运行环境不是 OpenClaw 或未开启/未落库用量数据，Skill 无法凭空生成统计。
- 社区来源（
community），升级与行为变更以 SkillHub 上v1.0.0及后续版本说明为准。 - 「cost / 花费」在简介中与用量统计一并提及，是否包含具体金额换算取决于 Skill 实现与你是否配置了费率；资料中未承诺固定计费公式。
- 评分与下载量为 SkillHub 页面指标，会随时间变化，写作或决策时以官网为准。
结尾¶
token用量实时监控 把 OpenClaw 跨会话的模型与 token（含 cache）计数、日趋势和小时分布收敛成一条可对话触发的 Skill，适合在 SkillHub 用 @user_acdf755c/token-monitor 安装到当前 Agent 的 skills 目录后使用。详情与安装提示见 https://www.skillhub.cn/skills/user_acdf755c/token-monitor 与 https://api.skillhub.cn/user_acdf755c/token-monitor。
