Usage Visualizer

Overview

Advanced usage statistics and high-fidelity visual reporting for OpenClaw. 100% local processing.

Complete Documentation

View Source →

Usage Visualizer

Usage Visualizer is a high-fidelity analytics engine for OpenClaw that transforms raw session logs into professional, actionable visual reports.

🚀 Quick Start

bash

# Generate today's visual report
python3 scripts/run_usage_report.py --mode image --period today

📈 Usage Guide

Visual Reports

The visualizer syncs logs first, then generates the report image.

python3 scripts/run_usage_report.py --mode image --period today
python3 scripts/run_usage_report.py --mode image --period week --json

Text Summaries

python3 scripts/run_usage_report.py --mode text --period today --json

🛡 Delivery Protocol (MANDATORY FOR AGENTS)

Image Delivery: Extract image_path from JSON and send as attachment using message tool's filePath. NEVER send the local path as a string.
Verification: Verify the file exists and is a valid PNG before sending.
No Network: This skill is 100% local. It has zero network dependencies.

📄 License

MIT

Installation

Terminal bash


openclaw install usage-visualizer

Copied!

Tags

#coding_agents-and-ides

Quick Info

Category Development

Model Claude 3.5

Complexity Advanced

Author vintlin

Last Updated 3/10/2026

🚀

Optimized for

Claude 3.5

🧠

Ready to Install?

Get started with this skill in seconds

openclaw install usage-visualizer