← Back to Skills Marketplace
OpenClaw Usage Dashboard
by
vanhuelsing
· GitHub ↗
· v2.0.2
· MIT-0
419
Downloads
0
Stars
1
Active Installs
5
Versions
Install in OpenClaw
/install openclaw-usage-dashboard
Description
Interactive local dashboard for OpenClaw API usage. Shows token consumption, request counts, and system health across all configured LLM models — broken down...
Usage Guidance
This skill appears to do what it says: run a local Node server that reads ~/.openclaw/agents/*/sessions/*.jsonl and shows usage metrics on http://localhost:PORT. Before installing/running: (1) Inspect server.js yourself (it is bundled) to verify you are comfortable with the file I/O and the fixed system commands it runs; (2) Run it unprivileged (your normal user), not as root/admin; (3) Confirm the server binds only to localhost (SKILL.md and code default to 127.0.0.1) or explicitly pass --host 127.0.0.1; (4) If you are concerned about secrets in logs, either review a few session files manually or run the server in a sandbox to confirm no raw secrets are exposed; (5) Because the server uses execSync for system health commands, make sure your platform's commands are safe and that the machine is otherwise secure. If you need additional assurance, you can run node server.js in an isolated environment and monitor outbound network activity to confirm nothing leaves your machine.
Capability Analysis
Type: OpenClaw Skill
Name: openclaw-usage-dashboard
Version: 2.0.2
The bundle provides a local Node.js dashboard for monitoring OpenClaw token usage and system health by parsing session logs in the `~/.openclaw` directory. The implementation in `server.js` includes several security best practices, such as regex-based redaction of API keys (e.g., Anthropic and OpenAI tokens), a memory budget for log parsing, and a restrictive Content Security Policy (CSP) for the web interface. System information is gathered using hardcoded shell commands (e.g., `vm_stat`, `df`, `powershell`) without user-input interpolation, and the server is restricted to `localhost`. The included `AUDIT.md` further documents a self-correction process for minor security and functional issues, reinforcing the tool's legitimate purpose.
Capability Assessment
Purpose & Capability
Name/description claim a local dashboard that reads OpenClaw session logs; the package includes server.js and dashboard.html that read ~/.openclaw/agents/*/sessions/*.jsonl and compute aggregates (tokens, request counts, system health). No unrelated credentials or services are requested.
Instruction Scope
SKILL.md instructs running node server.js and opening localhost. server.js reads only local session log files and exposes aggregated metrics; it does not embed instructions to read unrelated system state or exfiltrate data. The server does run a small set of fixed system commands (vm_stat, df, powershell, openclaw version, and platform openers) for system-health fields, which matches the 'system health' feature described.
Install Mechanism
No install spec is provided (instruction-only install), and the README/SKILL.md explicitly tell the user to run node server.js. No third-party packages or remote downloads are required. Code is included in the skill bundle so nothing needs to be fetched from external URLs at install time.
Credentials
The skill requests no environment variables or credentials. The server contains explicit sanitization patterns and an audit claiming it redacts secrets and does not return raw message content. The few operations that could surface sensitive text (parsing toolResult text) are used only to extract numeric rate-limit headers, not to expose raw responses.
Persistence & Privilege
The skill does not request permanent 'always' inclusion and binds to localhost by default. It opens a local HTTP server and may auto-open the user's browser; it does not modify other skills or global agent settings.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install openclaw-usage-dashboard - After installation, invoke the skill by name or use
/openclaw-usage-dashboard - Provide required inputs per the skill's parameter spec and get structured output
Version History
v2.0.2
Security fix: patch shell injection vulnerability. --open flag and df disk check now use spawn/spawnSync with array args (no shell). All execSync calls are hardcoded strings with zero variable interpolation.
v2.0.1
Security transparency: document child_process usage in source and README. All shell calls are fixed system commands (vm_stat, df, powershell, openclaw version) — no user input interpolation, all timeouts set, all wrapped in try/catch.
v2.0.0
v2.0 — Complete rewrite. Multi-model timeline with Models/Agents/Both toggle, model cards sorted by usage, agent activity heatmap, token efficiency metrics, system health (RAM VM-aware on macOS), period selector Hour/Day/Week/Month/Year. Cross-platform macOS/Linux/Windows. Zero dependencies, Node.js 18+. Security audit by Opus: XSS fix, CSP tightened, Intel Mac page size fix, Windows PowerShell fallback.
v1.0.1
Security fixes: removed unused subprocess import, added output path sanitization (VirusTotal scan feedback)
v1.0.0
Initial release — multi-provider usage dashboard with SVG charts, budget tracking, CSV export, demo mode
Metadata
Frequently Asked Questions
What is OpenClaw Usage Dashboard?
Interactive local dashboard for OpenClaw API usage. Shows token consumption, request counts, and system health across all configured LLM models — broken down... It is an AI Agent Skill for Claude Code / OpenClaw, with 419 downloads so far.
How do I install OpenClaw Usage Dashboard?
Run "/install openclaw-usage-dashboard" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is OpenClaw Usage Dashboard free?
Yes, OpenClaw Usage Dashboard is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does OpenClaw Usage Dashboard support?
OpenClaw Usage Dashboard is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created OpenClaw Usage Dashboard?
It is built and maintained by vanhuelsing (@vanhuelsing); the current version is v2.0.2.
More Skills