See your agent think. Real-time observability for OpenClaw AI agents.
One command. Zero config. Auto-detects everything.
pip install clawmetry && clawmetryOpens at http://localhost:8900 and you're done.
- Flow β Live animated diagram showing messages flowing through channels, brain, tools, and back
- Overview β Health checks, activity heatmap, session counts, model info
- Usage β Token and cost tracking with daily/weekly/monthly breakdowns
- Sessions β Active agent sessions with model, tokens, last activity
- Crons β Scheduled jobs with status, next run, duration
- Logs β Color-coded real-time log streaming
- Memory β Browse SOUL.md, MEMORY.md, AGENTS.md, daily notes
- Transcripts β Chat-bubble UI for reading session histories
| Flow | Overview | Sub-Agent |
|---|---|---|
![]() |
![]() |
![]() |
| Summary | Crons | Memory |
|---|---|---|
![]() |
![]() |
![]() |
pip (recommended):
pip install clawmetry
clawmetryOne-liner:
curl -sSL https://raw.githubusercontent.com/vivekchand/clawmetry/main/install.sh | bashFrom source:
git clone https://github.com/vivekchand/clawmetry.git
cd clawmetry && pip install flask && python3 dashboard.pyMost people don't need any config. ClawMetry auto-detects your workspace, logs, sessions, and crons.
If you do need to customize:
clawmetry --port 9000 # Custom port (default: 8900)
clawmetry --host 127.0.0.1 # Bind to localhost only
clawmetry --workspace ~/mybot # Custom workspace path
clawmetry --name "Alice" # Your name in Flow visualizationAll options: clawmetry --help
ClawMetry shows live activity for every OpenClaw channel you have configured. Only channels that are actually set up in your openclaw.json appear in the Flow diagram β unconfigured ones are automatically hidden.
Click any channel node in the Flow to see a live chat bubble view with incoming/outgoing message counts.
| Channel | Status | Live Popup | Notes |
|---|---|---|---|
| π± Telegram | β Full | β | Messages, stats, 10s refresh |
| π¬ iMessage | β Full | β | Reads ~/Library/Messages/chat.db directly |
| π WhatsApp | β Full | β | Via WhatsApp Web (Baileys) |
| π΅ Signal | β Full | β | Via signal-cli |
| π£ Discord | β Full | β | Guild + channel detection |
| πͺ Slack | β Full | β | Workspace + channel detection |
| π Webchat | β Full | β | Built-in web UI sessions |
| π‘ IRC | β Full | β | Terminal-style bubble UI |
| π BlueBubbles | β Full | β | iMessage via BlueBubbles REST API |
| π΅ Google Chat | β Full | β | Via Chat API webhooks |
| π£ MS Teams | β Full | β | Via Teams bot plugin |
| π· Mattermost | β Full | β | Self-hosted team chat |
| π© Matrix | β Full | β | Decentralized, E2EE support |
| π’ LINE | β Full | β | LINE Messaging API |
| β‘ Nostr | β Full | β | Decentralized NIP-04 DMs |
| π£ Twitch | β Full | β | Chat via IRC connection |
| π· Feishu/Lark | β Full | β | WebSocket event subscription |
| π΅ Zalo | β Full | β | Zalo Bot API |
Auto-detection: ClawMetry reads your
~/.openclaw/openclaw.jsonand only renders the channels you've actually configured. No manual setup required.
- Python 3.8+
- Flask (installed automatically via pip)
- OpenClaw running on the same machine
- Linux or macOS
See the Cloud Testing Guide for SSH tunnels, reverse proxy, and Docker.
This project is tested with BrowserStack.
MIT
π¦ See your agent think
Built by @vivekchand Β· clawmetry.com Β· Part of the OpenClaw ecosystem





