← Back to Skills Marketplace
Usage Report
by
Brice Thrower
· GitHub ↗
· v1.0.1
· MIT-0
137
Downloads
0
Stars
0
Active Installs
2
Versions
Install in OpenClaw
/install 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...
Usage Guidance
This script appears to do what it says: aggregate local OpenClaw session usage and cost fields. Before installing or running it, review the script yourself (it will read your session JSONL files which may contain private conversation text). Ensure jq and bc are installed, and on macOS install coreutils (gdate) or adapt the date commands. Because the source is 'unknown' in the registry, prefer running the script locally with a test/open copy of your session files (or inspect it line-by-line) rather than running it as-is on sensitive data. It does not contact external endpoints or request credentials.
Capability Analysis
Type: OpenClaw Skill
Name: usage-report
Version: 1.0.1
The usage-report skill is a utility for aggregating token usage and API costs from local OpenClaw session logs. The bash script (scripts/usage-report.sh) safely processes JSONL files using jq and bc, including regex validation for date filters to prevent shell injection. The behavior is entirely consistent with the stated purpose in SKILL.md and lacks any indicators of data exfiltration or malicious intent.
Capability Assessment
Purpose & Capability
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.
Instruction Scope
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).
Install Mechanism
No install spec — instruction-only with an included shell script. Nothing is downloaded or written to arbitrary locations during install.
Credentials
No credentials or secrets requested. One optional env var (OPENCLAW_SESSIONS_DIR) is justified for overriding the sessions directory.
Persistence & Privilege
always is false, the skill does not modify other skills or system configuration, and contains no persistent privileged behavior.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install usage-report - After installation, invoke the skill by name or use
/usage-report - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.1
Added declared dependencies (jq, bc) and optional OPENCLAW_SESSIONS_DIR env var to metadata for VirusTotal/ClawHub compliance
v1.0.0
Initial release: text/JSON output, date filtering, per-session breakdown, cache token tracking
Metadata
Frequently Asked Questions
What is Usage Report?
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... It is an AI Agent Skill for Claude Code / OpenClaw, with 137 downloads so far.
How do I install Usage Report?
Run "/install usage-report" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Usage Report free?
Yes, Usage Report is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Usage Report support?
Usage Report is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Usage Report?
It is built and maintained by Brice Thrower (@directorvector); the current version is v1.0.1.
More Skills