Skillget

clawmetry

agent
SUMMARY

See your agent think. Real-time observability dashboard for OpenClaw AI agents.

README.md

🦞 ClawMetry

PyPI Downloads
PyPI Downloads/week
PyPI version
GitHub stars
License: MIT

ClawMetry - #5 Product of the Day on Product Hunt

See your agent think. Real-time observability for OpenClaw AI agents.

One command. Zero config. Auto-detects everything.

pip install clawmetry && clawmetry

Opens at http://localhost:8900 and you're done.

Flow Visualization

What You Get

  • 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

Screenshots

🧠 Brain — Live agent event stream

Brain tab

📊 Overview — Token usage & session summary

Overview tab

⚡ Flow — Real-time tool call feed

Flow tab

💰 Tokens — Cost breakdown by model & session

Tokens tab

🧬 Memory — Workspace file browser

Memory tab

🔐 Security — Posture & audit log

Security tab

Install

One-liner (recommended):

curl -sSL https://raw.githubusercontent.com/vivekchand/clawmetry/main/install.sh | bash

pip:

pip install clawmetry
clawmetry

From source:

git clone https://github.com/vivekchand/clawmetry.git
cd clawmetry && pip install flask && python3 dashboard.py

Configuration

Most 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 visualization

All options: clawmetry --help

Supported Channels

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.json and only renders the channels you've actually configured. No manual setup required.

Requirements

  • Python 3.8+
  • Flask (installed automatically via pip)
  • OpenClaw running on the same machine
  • Linux or macOS

Cloud Deployment

See the Cloud Testing Guide for SSH tunnels, reverse proxy, and Docker.

Testing

This project is tested with BrowserStack.

BrowserStack

Star History

Star History Chart

License

MIT

🦞 See your agent think
Built by @vivekchand · clawmetry.com · Part of the OpenClaw ecosystem

Reviews (0)

No results found