首页 › 龙虾技能列表 › Usage Report — OpenClaw 会话成本和令牌使用报告

Usage Report — OpenClaw 会话成本和令牌使用报告

v1.0.1

从 OpenClaw 会话日志生成成本和令牌使用报告。用于查询 API 成本、令牌使用情况、账单、支出、成本明细或每日/会话使用摘要。

0· 65·0 当前·0 累计
by @directorvector (Brice Thrower)·MIT-0
下载技能包
License
MIT-0
最后更新
2026/4/11
安全扫描
VirusTotal
无害
查看报告
OpenClaw
安全
high confidence
该技能内部一致：仅读取本地 OpenClaw 会话 JSONL 文件，使用 jq 和 bc 聚合每次转换的成本/令牌字段，不请求凭据或进行网络活动。
评估建议
该脚本似乎做了它声称的：聚合本地 OpenClaw 会话使用和成本字段。安装或运行前，请自行审查脚本（它将读取可能包含私人对话文本的会话 JSONL 文件）。确保安装了 jq 和 bc，在 macOS 上安装 coreutils（gdate）或适配日期命令。由于注册表中的源为“未知”，建议使用测试/打开的会话文件副本在本地运行脚本（或逐行检查），而不是直接在敏感数据上运行。它不与外部端点联系，也不请求凭据。...
详细分析 ▾
✓ 用途与能力
Name/description match the implementation: the script reads OpenClaw session JSONL files and aggregates usage/cost fields. Requested binaries (jq, bc) are reasonable and proportional.
ℹ 指令范围
Instructions and the script operate on ~/.openclaw/agents/main/sessions by default (or OPENCLAW_SESSIONS_DIR if set) and only parse per-turn usage fields; this is expected. Note: these session files can contain sensitive conversation content—review or run the script locally before exporting results. Also the script uses GNU date -d semantics (may need gdate on macOS).
✓ 安装机制
No install spec — instruction-only with an included shell script. Nothing is downloaded or written to arbitrary locations during install.
✓ 凭证需求
No credentials or secrets requested. One optional env var (OPENCLAW_SESSIONS_DIR) is justified for overriding the sessions directory.
✓ 持久化与权限
always is false, the skill does not modify other skills or system configuration, and contains no persistent privileged behavior.
安全有层次，运行前请审查代码。

License

MIT-0

可自由使用、修改和再分发，无需署名。

运行时依赖

无特殊依赖

版本

latestv1.0.12026/4/9

添加了声明的依赖项（jq、bc）和可选的 OPENCLAW_SESSIONS_DIR 环境变量到元数据，以符合 VirusTotal/ClawHub 的要求。

● 无害

安装命令 点击复制

官方npx clawhub@latest install usage-report
镜像加速npx clawhub@latest install usage-report --registry https://cn.clawhub-mirror.com

技能文档

生成 OpenClaw 会话日志的成本和令牌使用报告。用于查询 API 成本、令牌使用情况、账单、支出、成本明细或每日/会话使用摘要。通过读取会话 JSONL 文件中的每次转换使用数据来工作。

作者：DirectorVector

主页：https://github.com/DirectorVector

name: usage-report description: 生成 OpenClaw 会话日志的成本和令牌使用报告。用于查询 API 成本、令牌使用情况、账单、支出、成本明细或每日/会话使用摘要。通过读取会话 JSONL 文件中的每次转换使用数据来工作。 author: DirectorVector homepage: https://github.com/DirectorVector metadata: { "openclaw": { "requires": { "bins": ["jq", "bc"] }, "env": [ { "name": "OPENCLAW_SESSIONS_DIR", "description": "可选。覆盖 OpenClaw 会话 JSONL 文件的路径。默认为 ~/.openclaw/agents/main/sessions/", "required": false } ] } }

# 快速使用 

# 全文报告（所有会话）
{baseDir}/scripts/usage-report.sh
# JSON 输出
{baseDir}/scripts/usage-report.sh json
# 筛选今天
{baseDir}/scripts/usage-report.sh text today
# 筛选指定日期
{baseDir}/scripts/usage-report.sh text 2026-04-07
# JSON 输出指定日期
{baseDir}/scripts/usage-report.sh json today

输出字段

  • Turns：助手响应次数（API 调用次数）
  • Cost：每次转换成本之和（输入 + 输出 + 缓存读取 + 缓存写入）
  • Output tokens：模型生成的令牌数量
  • Cache read/write：提示缓存令牌计数

注意事项

  • 默认从 ~/.openclaw/agents/main/sessions/*.jsonl 读取
  • 可通过 OPENCLAW_SESSIONS_DIR 环境变量覆盖
  • 成本由 OpenClaw 在请求时根据提供商定价计算
  • 跳过 .lock 和 .reset 备份文件
  • 向用户呈现时，总成本四舍五入到 2 小小数位
数据来源：ClawHub ↗ · 中文优化：龙虾技能库
OpenClaw 技能定制 / 插件定制 / 私有工作流定制

免费技能或插件可能存在安全风险，如需更匹配、更安全的方案，建议联系付费定制

了解定制服务