ClawMetry provides real-time observability for AI agents, primarily within the OpenClaw ecosystem. It offers a zero-configuration, auto-detecting dashboard visualizing agent thought processes, message flows, resource usage, and session histories, aiding developers in debugging and monitoring.

How It Works

Using a Flask backend and React frontend, ClawMetry generates a live, animated "Flow" diagram of agent interactions. It automatically discovers agent runtimes, logs, and sessions, consolidating data. Key advantages include comprehensive real-time visualization, broad compatibility with diverse AI agent frameworks via adapters, and seamless OpenTelemetry integration for vendor-neutral trace management.

Quick Start & Requirements

• Install via pip install clawmetry then run clawmetry. A bash script and Docker are also available.
• Requires Python 3.8+, Flask, and an OpenClaw agent (or compatible runtime). Linux/macOS recommended.
• Dashboard accessible at http://localhost:8900.

Highlighted Details

• Flow Diagram: Real-time, animated visualization of agent message flow.
• Comprehensive Monitoring: Features include health checks, activity heatmaps, token/cost tracking, session management, live logs, memory browsing.
• Alerting & Approvals: Supports budget cap alerts, error rate triggers, and manual sign-off gates for sensitive operations.
• Extensive Runtime Support: Adapters for numerous AI agent frameworks beyond OpenClaw (e.g., PicoClaw, Hermes, Codex, Cursor).
• OpenTelemetry Integration: Vendor-neutral export of GenAI spans and a built-in OTLP receiver.

Maintenance & Community

Developed by @vivekchand within the OpenClaw ecosystem. Specific community channels or detailed maintenance status are not detailed in the README.

Licensing & Compatibility

MIT License permits commercial use and integration into closed-source projects.

Limitations & Caveats

Some runtime adapters are "Beta." Token cost visibility depends on the agent's logging. NemoClaw integration requires careful configuration, potentially involving host-side sync daemons or sandbox network policies.