Skip to content

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

License

Notifications You must be signed in to change notification settings

vivekchand/clawmetry

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

244 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

🦞 ClawMetry

PyPI License: MIT GitHub stars

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

Flow Overview Sub-Agent
Flow Overview Sub-Agent
Summary Crons Memory
Summary Crons Memory

Install

pip (recommended):

pip install clawmetry
clawmetry

One-liner:

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

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

License

MIT


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

About

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

Topics

Resources

License

Contributing

Security policy

Stars

Watchers

Forks

Packages

 
 
 

Contributors

Languages