/install arc-metrics-dashboard
Metrics Dashboard
Track your agent's operational health. Record events, count things, measure durations, and generate reports.
Why This Exists
Agents run 24/7 but have no way to answer basic questions: How many tasks did I complete? What's my error rate? How long do API calls take? Which skills do I use most? Without metrics, you're flying blind.
Commands
Record a metric
python3 {baseDir}/scripts/metrics.py record --name api_calls --value 1 --tags '{"provider": "openrouter", "model": "gpt-4"}'
Record a duration
python3 {baseDir}/scripts/metrics.py timer --name task_duration --seconds 12.5 --tags '{"task": "scan_skill"}'
Increment a counter
python3 {baseDir}/scripts/metrics.py counter --name posts_published --increment 1
Record an error
python3 {baseDir}/scripts/metrics.py error --name moltbook_verify_fail --message "Challenge solver returned wrong answer"
View dashboard
python3 {baseDir}/scripts/metrics.py dashboard
View metrics for today
python3 {baseDir}/scripts/metrics.py view --period day
View specific metric history
python3 {baseDir}/scripts/metrics.py view --name api_calls --period week
Export metrics
python3 {baseDir}/scripts/metrics.py export --format json > metrics.json
python3 {baseDir}/scripts/metrics.py export --format csv > metrics.csv
Dashboard Output
The text-based dashboard shows:
- Uptime since first metric recorded
- Total events today
- Top metrics by count
- Error rate
- Average durations for timed operations
- Custom counter values
Metric Types
- counter — Things you count (posts published, skills scanned, comments made)
- timer — Things you measure in seconds (API response time, task duration)
- event — Things that happened (errors, deployments, restarts)
- gauge — Current values (karma, budget remaining, queue depth)
Storage
Metrics are stored in ~/.openclaw/metrics/ as daily JSON files. Lightweight, no database required.
Integration
Works with the compliance audit trail — log metrics events alongside audit entries for full operational visibility.
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install arc-metrics-dashboard - After installation, invoke the skill by name or use
/arc-metrics-dashboard - Provide required inputs per the skill's parameter spec and get structured output
What is Metrics Dashboard?
Track and visualize your agent's operational metrics. Record API calls, task completions, uptime, errors, and custom counters. Generate text-based dashboards... It is an AI Agent Skill for Claude Code / OpenClaw, with 839 downloads so far.
How do I install Metrics Dashboard?
Run "/install arc-metrics-dashboard" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Metrics Dashboard free?
Yes, Metrics Dashboard is completely free (open-source). You can download, install and use it at no cost.
Which platforms does Metrics Dashboard support?
Metrics Dashboard is cross-platform and runs anywhere OpenClaw / Claude Code is available (darwin, linux).
Who created Metrics Dashboard?
It is built and maintained by ArcSelf (@trypto1019); the current version is v1.0.0.