Open source observability for OpenClaw agents — real-time observability, cost guardrails, and autonomous issue resolution
Your AI agents spawn sub-agents, burn tokens, call tools, and sometimes get stuck in loops or blow through API credits. ClaWatch doesn't just show you what's happening — it steps in. Set cost thresholds that auto-pause runaway agents. Get intelligent alerts that explain why something broke. Let the auto-fixer resolve common failures before you even wake up.
Visibility is table stakes. ClaWatch gives you control and autonomy — so your agents run reliably while you sleep.
Built for teams shipping AI products. Open source. Free forever.
Set daily or monthly spend limits per agent. When a threshold is hit, ClaWatch auto-pauses the agent before it drains your credits — no human in the loop required.
Stuck in a loop? Crashed mid-task? ClaWatch detects common failure patterns and auto-resolves them — restart agents, kill runaway sessions, and recover gracefully.
Pause, resume, or stop agents directly from the dashboard or your phone. One click, instant effect — even at 3 AM from your bed.
Not just "agent crashed." ClaWatch tells you what failed, why it happened, and what it did about it. Telegram, Slack, or webhook — your choice.
Group sessions into projects for a bird's-eye view. See cost, timeline, and agent breakdown across related work. Interactive charts with zoom.
Monitor multiple OpenClaw installations from one dashboard. Switch profiles instantly — dev, staging, production.
npm install -g clawatch
clawatch start
That's it! ClaWatch auto-detects your OpenClaw agents and opens the dashboard at http://localhost:3001.
# Get Telegram notifications when agents misbehave export TELEGRAM_BOT_TOKEN="your_bot_token" export TELEGRAM_CHAT_ID="your_chat_id" clawatch start
| Command | Description |
|---|---|
clawatch start |
Auto-detect agents, start monitoring, and open the dashboard |
clawatch stop |
Stop the monitoring daemon gracefully |
clawatch status |
Show active agents, sessions, and daemon health |
clawatch logs |
Stream real-time logs from the monitoring daemon |
┌──────────────────┐
│ OpenClaw Agents │ (~/.openclaw/*)
│ Sessions, Logs │
└────────┬─────────┘
│
▼
┌──────────────────┐ ┌──────────────────┐ ┌──────────────────┐
│ ClaWatch CLI │─────▶│ Backend API │─────▶│ Alert Channels │
│ (Daemon) │ │ Express+SQLite │ │ Telegram/Slack │
└──────────────────┘ └────────┬─────────┘ └──────────────────┘
│
┌────────▼─────────┐
│ Web Dashboard │
│ (Next.js) │
└──────────────────┘
http://localhost:3001
- CLI daemon watches
~/.openclaw/for agent activity - Backend API aggregates data into SQLite
- Dashboard visualizes everything in real-time
- Alert system watches for anomalies and notifies you
ClaWatch auto-detects your agent framework. Full support today, more coming soon.
| Framework | Status |
|---|---|
| 🦞 OpenClaw | ✅ Fully supported |
| NanoClaw | ✅ Fully supported |
| ZeroClaw | 🔜 Coming soon |
| TrustClaw | 🔜 Coming soon |
| Nanobot | 🔜 Coming soon |
| PicoClaw | 🔜 Coming soon |
Want support for your framework? Request it →
Get notified where your team already works.
| Channel | Status | Setup Guide |
|---|---|---|
| 📱 Telegram | ✅ Live | Setup docs |
| 💬 Slack | 🔜 Soon | Coming soon |
| 🎮 Discord | 🔜 Soon | Coming soon |
| 🔜 Soon | Coming soon | |
| 📟 PagerDuty | 🔜 Soon | Coming soon |
- 🔴 Agent Crash — Agent stopped unexpectedly
- 🔁 Infinite Loop — Agent stuck repeating the same action
- 💸 Cost Spike — Agent exceeded hourly/daily budget
- 🕐 Agent Stalled — No activity for >10 minutes
⚠️ High Error Rate — Multiple tool call failures
Want to run ClaWatch on a remote server? Use Docker:
git clone https://github.com/GENWAY-AI/clawatch.git cd clawatch docker build -t clawatch . docker run -p 3001:3001 -e TELEGRAM_BOT_TOKEN=xxx clawatch
Supports any platform with Docker: AWS, GCP, Azure, Hetzner, Digital Ocean, Render, Fly.io.
If OpenClaw runs there, ClaWatch runs there.
- ✅ macOS (Apple Silicon & Intel)
- ✅ Linux (Ubuntu/Debian)
- ✅ Windows WSL
- ✅ Raspberry Pi
- ✅ AWS / GCP / Digital Ocean / Hetzner
- Node.js 18+
- npm or pnpm
# Clone the repo git clone https://github.com/GENWAY-AI/clawatch.git cd clawatch # Backend cd backend npm install npm run dev # http://localhost:3001/api # Frontend (new terminal) cd frontend npm install npm run dev # http://localhost:3000 # CLI (new terminal) cd cli npm install npm run build npm link # Makes `clawatch` command available
clawatch/
├── cli/ # Monitoring daemon + CLI
│ ├── src/
│ │ ├── cli.ts # Main entry point
│ │ └── daemon.ts # Background monitoring
│ └── package.json
├── backend/ # Express API
│ ├── src/
│ │ ├── index.ts # Server
│ │ ├── routes/ # REST endpoints
│ │ └── db.ts # SQLite schema
│ └── package.json
├── frontend/ # Next.js dashboard
│ ├── app/ # Pages
│ ├── components/ # React components
│ └── package.json
├── Dockerfile # Production container
└── API_CONTRACT.md # Backend API docs
- Real-time agent monitoring
- Cost tracking (per agent, per model)
- Telegram alerts
- Multi-profile support
- Session logs & project grouping
- Agent control (pause/resume)
- Docker support for self-hosting
- Pure WASM SQLite (no native deps)
- Interactive analytics with chart zoom & URL persistence
- Agent Auto-Fixer (autonomous failure detection & recovery)
- Slack integration
- Discord bot
- Custom alert rules builder
- NanoClaw/ZeroClaw/TrustClaw support
- Multi-user auth & teams
- Agent performance scoring
- Cost prediction
- Webhook alerts
- Email alerts
We love contributions! Bug reports, feature requests, and PRs are all welcome.
- Fork the repo and create a feature branch
- Make your changes (add tests if applicable)
- Open a PR with a clear description
- We'll review and merge within 48 hours
Check out issues labeled good first issue.
- GitHub Discussions: Ask questions, share tips
- GitHub Issues: Report bugs, request features
- Discord: Join our community
- Email: hello@genway.ai
MIT © GENWAY AI
Free to use in commercial products. See LICENSE for details.