← Back to Skills Marketplace
ranasalalali

OpenClaw Model Usage

by Rana Salal Ali · GitHub ↗ · v1.2.1 · MIT-0
cross-platform ✓ Security Clean
159
Downloads
0
Stars
0
Active Installs
4
Versions
Install in OpenClaw
/install openclaw-model-usage
Description
Inspect local OpenClaw model usage directly from session logs. Use when asked for the current model, recent model usage, usage breakdown by model, token tota...
Usage Guidance
This skill appears to do what it says: parse local OpenClaw session JSONL files and build local summaries and an HTML dashboard. Before installing/running: (1) confirm you have Python 3.12+ available (the package requires it), (2) be aware it will read files under ~/.openclaw/agents by default (so don't run it if those logs are sensitive or you don't want local analysis), (3) the dashboard is written locally (--out path) and is self-contained (no external scripts), and (4) no credentials or network calls are requested by the code—if you need extra assurance, inspect the bundled scripts (scripts/model_usage.py and src/openclaw_model_usage/cli.py) or run the tool in a sandboxed environment. The smoke tests exercise subprocesses for local invocation but those are test-only and not network-related.
Capability Analysis
Type: OpenClaw Skill Name: openclaw-model-usage Version: 1.2.1 The openclaw-model-usage skill is a legitimate utility designed to analyze local OpenClaw session logs (~/.openclaw/agents) to provide usage summaries and cost reports. The core logic in src/openclaw_model_usage/cli.py reads local JSONL files, aggregates token counts and costs, and generates human-readable summaries or a self-contained HTML dashboard. The code is well-structured, includes comprehensive tests (tests/smoke_test.py), and lacks any indicators of malicious intent such as data exfiltration, unauthorized network access, or obfuscation. The instructions in SKILL.md are aligned with the tool's purpose and provide helpful guidance to the AI agent on distinguishing between real and test data.
Capability Assessment
Purpose & Capability
Name/description match the code and instructions: the package includes a Python CLI and script that parse ~/.openclaw/agents/*/sessions/*.jsonl and sessions.json to produce usage summaries and an optional local HTML dashboard. Nothing requested (env vars, binaries, config paths) is unrelated to this purpose.
Instruction Scope
SKILL.md and the CLI are scoped to reading local session JSONL and sessions.json files, producing summaries and a self-contained HTML file. The instructions explicitly direct the agent to use a local root (default ~/.openclaw/agents) and warn not to use test fixtures for production. There are no instructions to collect or transmit data to external endpoints.
Install Mechanism
No install spec is provided (instruction-only at registry level) and the project bundles Python scripts and a CLI implementation. This is low-risk: nothing is fetched from external URLs and no archive extraction or remote installs are present in the metadata. Running the tool requires a local Python runtime (pyproject requires >=3.12).
Credentials
The skill requires no environment variables, credentials, or special config paths beyond reading local OpenClaw logs. The requested file access (user home ~/.openclaw/agents) is coherent with the described functionality. No unrelated secrets or external service keys are requested.
Persistence & Privilege
The skill is not forced-always (always:false) and does not modify other skills or global agent configuration. It writes output only when asked (e.g., --out for dashboard) and otherwise performs read-only analysis of local logs.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install openclaw-model-usage
  3. After installation, invoke the skill by name or use /openclaw-model-usage
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.2.1
Clarify live dashboard usage and mark fixtures as development-only
v1.2.0
Add static HTML dashboard and polish human-friendly summary workflow
v1.1.0
Add Phase 1 session-aware attribution with sessions/subagents/session-tree views
v1.0.0
Initial release
Metadata
Slug openclaw-model-usage
Version 1.2.1
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 4
Frequently Asked Questions

What is OpenClaw Model Usage?

Inspect local OpenClaw model usage directly from session logs. Use when asked for the current model, recent model usage, usage breakdown by model, token tota... It is an AI Agent Skill for Claude Code / OpenClaw, with 159 downloads so far.

How do I install OpenClaw Model Usage?

Run "/install openclaw-model-usage" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is OpenClaw Model Usage free?

Yes, OpenClaw Model Usage is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does OpenClaw Model Usage support?

OpenClaw Model Usage is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created OpenClaw Model Usage?

It is built and maintained by Rana Salal Ali (@ranasalalali); the current version is v1.2.1.

💬 Comments