← 返回 Skills 市场
Usage Report
作者
Brice Thrower
· GitHub ↗
· v1.0.1
· MIT-0
137
总下载
0
收藏
0
当前安装
2
版本数
在 OpenClaw 中安装
/install 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...
安全使用建议
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.
功能分析
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.
能力评估
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.
如何使用
- 确保已安装 OpenClaw（本地或 Docker 部署）
- 在对话框中输入安装命令：
/install usage-report - 安装完成后，直接呼叫该 Skill 的名称或使用
/usage-report触发 - 根据 Skill 的参数说明提供必要输入，即可获得结构化输出
版本历史
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
元数据
常见问题
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... 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件，目前累计下载 137 次。
如何安装 Usage Report？
在 OpenClaw 或 Claude Code 对话框中运行命令「/install usage-report」即可一键安装，无需额外配置。
Usage Report 是免费的吗？
是的，Usage Report 完全免费，采用 MIT-0 许可证，可自由下载、安装和使用。
Usage Report 支持哪些平台？
Usage Report 跨平台运行，可在任意部署了 OpenClaw / Claude Code 的环境中使用（cross-platform）。
谁开发了 Usage Report？
由 Brice Thrower（@directorvector）开发并维护，当前版本 v1.0.1。
推荐 Skills