← Back to Skills Marketplace
871
Downloads
2
Stars
2
Active Installs
8
Versions
Install in OpenClaw
/install usage-visualizer
Description
Advanced usage statistics and high-fidelity visual reporting for OpenClaw. 100% local processing. Audit-verified privacy (No credentials stored).
Usage Guidance
This skill is internally consistent with its stated purpose and appears to only read local OpenClaw/Clawdbot session logs, store aggregates in a local SQLite DB, and render images via a headless browser. Before installing, consider: 1) The install step invokes pip and will download packages from PyPI (network activity during install). 2) The rendering dependency (html2image) requires Chromium; ensure you trust/verify the Chromium binary and/or the system package source. 3) The skill reads files under ~/.openclaw and ~/.clawdbot—confirm you are comfortable with local session logs being parsed and stored in the skill's workspace. 4) The skill's package.json references a GitHub repo but the registry source is 'unknown'—if provenance matters, manually review the upstream repository for additional context. If any of those points are unacceptable, review the code locally (it is included) before running, or run it in a restricted environment.
Capability Analysis
Type: OpenClaw Skill
Name: usage-visualizer
Version: 1.1.3
The skill is classified as suspicious due to a potential arbitrary file write vulnerability in `scripts/generate_report_image.py` if the `--output` argument were user-controlled, and the heavy dependency on Chromium for image rendering, which significantly expands the attack surface. While the agent's execution flow (via `scripts/run_usage_report.py`) mitigates the arbitrary file write by constraining output to `OPENCLAW_WORKSPACE` or the project root, and the HTML content for rendering is generated locally without external network calls, these factors introduce meaningful risks. There is no evidence of intentional malicious behavior like data exfiltration or persistence.
Capability Assessment
Purpose & Capability
Name/description match the code and runtime requirements: the scripts parse local OpenClaw/Clawdbot session JSONL files, compute token/cost metrics, persist to a local SQLite DB, and render PNG reports using a headless Chromium via html2image. Required binaries (python3, chromium) and the OPENCLAW_WORKSPACE env var are used by the code.
Instruction Scope
SKILL.md runtime instructions are narrowly scoped to syncing session logs, generating reports, and delivering images via the agent message tool. The scripts read filesystem session logs (under ~/.openclaw and ~/.clawdbot) and a local SQLite DB; they do not contain code that transmits data over the network or access unrelated system credentials.
Install Mechanism
This is an instruction-and-script skill with a pip install step (pip3 install -r requirements.txt). Installing will fetch dependencies from PyPI (network access during install). The runtime claims '100% local' and 'No External Calls', which is true at runtime, but the install step itself will contact PyPI. Also html2image or its dependencies can sometimes pull or require a local browser binary; the skill requires chromium to be present but some html-rendering libraries may attempt downloads if not found. This is expected for this functionality but worth noting.
Credentials
Only OPENCLAW_WORKSPACE is requested and is used as the workspace/storage path. No credentials or unrelated secrets are required. The code reads user session log files (which may contain metadata about sessions) but only extracts usage/token counts and model names in the shown logic; it does not request API keys or other external credentials.
Persistence & Privilege
The skill creates a local SQLite database and other report files under the workspace (default ~/.llm-cost-monitor or OPENCLAW_WORKSPACE). It does not request always:true and does not modify other skills' configurations. This level of persistence and file creation is appropriate for the described functionality.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install usage-visualizer - After installation, invoke the skill by name or use
/usage-visualizer - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.1.3
v1.1.3: Privacy Clarity. Renamed all internal api_key references to source_id to avoid audit confusion. Explicitly verified no credentials are stored.
v1.1.2
v1.1.2: 100% Purity. Removed all legacy external API references, unified reporting logic, and eliminated unused jq dependency.
v1.1.1
v1.1.1: Complete privacy overhaul. Removed requests dependency and all external webhook mentions. Aligned metadata with actual implementation.
v1.1.0
v1.1.0: Secure Delivery Protocol, JSON output, and mandatory path verification.
v1.0.3
Improve trigger behavior for 用量汇报/用量统计 and add one-step auto-sync report runner.
v1.0.2
Address review: add privacy docs, fix missing dependencies (html2image, Pillow), unify package metadata
v1.0.1
Fixed: Removed redundant generated images from assets/ and cleaned up project root.
v1.0.0
Major release: renamed from llm-cost-monitor to usage-visualizer, focused on high-fidelity visual reporting, token analytics, and efficiency metrics.
Metadata
Frequently Asked Questions
What is Usage Visualizer?
Advanced usage statistics and high-fidelity visual reporting for OpenClaw. 100% local processing. Audit-verified privacy (No credentials stored). It is an AI Agent Skill for Claude Code / OpenClaw, with 871 downloads so far.
How do I install Usage Visualizer?
Run "/install usage-visualizer" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Usage Visualizer free?
Yes, Usage Visualizer is completely free (open-source). You can download, install and use it at no cost.
Which platforms does Usage Visualizer support?
Usage Visualizer is cross-platform and runs anywhere OpenClaw / Claude Code is available (darwin, linux).
Who created Usage Visualizer?
It is built and maintained by Vint (@vintlin); the current version is v1.1.3.
More Skills