ClawMetry Documentation

Complete guide to installing, configuring, and using ClawMetry — the real-time observability dashboard for AI agents.

Installation

Via pip (recommended)

pip install clawmetry
clawmetry

Opens at http://localhost:8900. Auto-detects your OpenClaw workspace.

Via install script

curl -fsSL https://clawmetry.com/install.sh | bash

Works on macOS, Linux, and Windows WSL. The script detects your OS and installs accordingly.

From source

curl -O https://raw.githubusercontent.com/vivekchand/clawmetry/main/dashboard.py
pip install flask
python3 dashboard.py

Requirements

• Python 3.8 or higher
• Flask (installed automatically via pip)
• An OpenClaw workspace (ClawMetry auto-detects it)

Features

🌊 Live Flow Visualization

The signature feature. An animated SVG architecture diagram that lights up in real-time as your agent processes messages. Color-coded by type:

• 🟣 Purple — your message entering through a channel
• 🔵 Blue — request flowing to the brain (LLM)
• 🟡 Yellow — tool calls (exec, browser, search, cron, TTS, memory)
• 🟢 Green — response flowing back to you
• 🔴 Red — errors

📊 Token & Cost Tracking

Track token usage and costs per session, per model, and per tool. Bar charts show daily, weekly, and monthly totals. With OpenTelemetry enabled, get real token counts and actual costs instead of estimates.

🤖 Sub-Agent Monitoring

When your agent spawns sub-agents, ClawMetry shows you every step: files being read, commands being run, tools being called, and what the sub-agent is thinking. Available as summary, narrative, or full logs.

⏰ Cron Job Dashboard

Monitor scheduled jobs with status indicators, schedule expressions, last/next run times, and duration. Get alerted when cron jobs fail.

📜 Session History & Transcripts

Every session is logged with timeline, tool calls, and cost. The transcript viewer shows conversations in a chat-bubble UI with color-coded roles.

📁 Memory File Browser

Browse and track changes to your agent's memory files: SOUL.md, MEMORY.md, AGENTS.md, and daily notes. See what changed and when.

🏥 System Health

At-a-glance dashboard showing service uptime, disk usage, active sub-agents, and cron job status.

Configuration

ClawMetry works with zero configuration. It auto-detects your OpenClaw workspace by looking for standard files and directories. To customize:

• CLAWMETRY_PORT — Change the port (default: 8900)
• CLAWMETRY_HOST — Change the host (default: 0.0.0.0)
• OPENCLAW_HOME — Point to a specific OpenClaw workspace

How ClawMetry Compares

Feature	ClawMetry	Grafana	Datadog	LangSmith
AI agent native	✅	❌	❌	Partial
Zero config	✅	❌	❌	❌
Self-hosted	✅	✅	❌	❌
Free	✅	✅	❌	Limited
Sub-agent visibility	✅	❌	❌	❌
Token cost tracking	✅	Manual	Manual	✅
One-command install	✅	❌	❌	❌

FAQ

Does ClawMetry work without OpenClaw?

ClawMetry is designed for OpenClaw agents. It reads OpenClaw's workspace structure, logs, and APIs to provide observability.

Is my data sent anywhere?

No. ClawMetry runs entirely locally. No data leaves your machine. No cloud accounts, no telemetry, no tracking.

Can I run it on a Raspberry Pi?

Yes! ClawMetry is lightweight (single Python file + Flask). It runs on any device that supports Python 3.8+.

How do I update?

pip install --upgrade clawmetry

Where do I report bugs?

Open an issue on GitHub.

← Back to Home