Usage Report

读取 OpenClaw 会话目录下的 JSONL 日志，按全部会话、当天或指定日期汇总助手回复轮次、输入/输出与缓存 token 数以及总费用，支持文本和 JSON 两种输出格式，日志目录可通过环境变量覆盖。

directorvector

热度 46.05

最近更新 2026-05-11 17:41:28

分类：数据依赖：代码执行 / 读写文件应用场景：报告撰写 / 数据处理 / 自动化脚本

安装技能

复制下面的话术发给你的 Agent，它会通过 secure-skills 检索并安装该技能。

执行命令安装此 skill： npx secure-skills-cli add usage-report

Metadata

name: usage-report
description: Generate cost and token usage reports from OpenClaw session logs. Use when asked about API costs, token usage, billing, spending, how much something cost, or daily/session usage summaries. Works by reading per-turn usage data from session JSONL files.
author: DirectorVector
homepage: https://github.com/DirectorVector
metadata: {"openclaw":{"requires":{"bins":["jq","bc"]},"env":[{"name":"OPENCLAW_SESSIONS_DIR","description":"Optional. Override path to OpenClaw session JSONL files. Defaults to ~/.openclaw/agents/main/sessions/","required":false}]}}

Usage Report

Generate cost and token usage reports from OpenClaw session JSONL logs.

Quick usage

# Full text report (all sessions)
{baseDir}/scripts/usage-report.sh

# JSON output
{baseDir}/scripts/usage-report.sh json

# Filter to today only
{baseDir}/scripts/usage-report.sh text today

# Filter to specific date
{baseDir}/scripts/usage-report.sh text 2026-04-07

# JSON for a specific date
{baseDir}/scripts/usage-report.sh json today

Output fields

Turns: number of assistant responses (API calls)
Cost: sum of per-turn costs (input + output + cache read + cache write)
Output tokens: tokens generated by the model
Cache read/write: prompt caching token counts

Notes

Reads from ~/.openclaw/agents/main/sessions/*.jsonl by default
Override with OPENCLAW_SESSIONS_DIR env var
Costs are calculated by OpenClaw at request time using provider pricing
Skips .lock and .reset backup files
When presenting to user, round total cost to 2 decimal places