{"id":50577864,"url":"https://github.com/GENWAY-AI/clawatch","last_synced_at":"2026-06-21T19:00:25.776Z","repository":{"id":343898831,"uuid":"1176983472","full_name":"GENWAY-AI/clawatch","owner":"GENWAY-AI","description":"Open source observability for OpenClaw agents. Real-time monitoring, cost tracking \u0026 management, and smart alerts. Free forever.","archived":false,"fork":false,"pushed_at":"2026-03-25T10:55:41.000Z","size":6471,"stargazers_count":24,"open_issues_count":15,"forks_count":1,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-03-26T03:56:18.267Z","etag":null,"topics":["ai-agents","cost-management","cost-optimization","nanoclaw","observability","openclaw"],"latest_commit_sha":null,"homepage":"https://clawatch.dev","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/GENWAY-AI.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-03-09T15:19:54.000Z","updated_at":"2026-03-16T09:23:25.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/GENWAY-AI/clawatch","commit_stats":null,"previous_names":["genway-ai/clawatch"],"tags_count":15,"template":false,"template_full_name":null,"purl":"pkg:github/GENWAY-AI/clawatch","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GENWAY-AI%2Fclawatch","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GENWAY-AI%2Fclawatch/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GENWAY-AI%2Fclawatch/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GENWAY-AI%2Fclawatch/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/GENWAY-AI","download_url":"https://codeload.github.com/GENWAY-AI/clawatch/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GENWAY-AI%2Fclawatch/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34622271,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-21T02:00:05.568Z","response_time":54,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai-agents","cost-management","cost-optimization","nanoclaw","observability","openclaw"],"created_at":"2026-06-05T00:00:28.685Z","updated_at":"2026-06-21T19:00:25.754Z","avatar_url":"https://github.com/GENWAY-AI.png","language":"TypeScript","funding_links":[],"categories":["Open Source Projects"],"sub_categories":["Observability"],"readme":"\u003cdiv align=\"center\"\u003e\n  \u003cimg src=\"frontend/public/clawatch-owl.svg\" alt=\"ClaWatch\" width=\"160\" height=\"160\" /\u003e\n  \n  # ClaWatch\n  \n  ### **Monitor, control, and auto-fix your AI agents.**\n  \n  *Open source observability for OpenClaw agents — real-time observability, cost guardrails, and autonomous issue resolution*\n  \n  [![npm version](https://img.shields.io/npm/v/clawatch.svg?style=flat\u0026color=00C853)](https://www.npmjs.com/package/clawatch)\n  [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg?style=flat)](https://opensource.org/licenses/MIT)\n  \n  [**🚀 Live Demo**](https://clawatch.dev/dashboard) · [**📦 npm**](https://www.npmjs.com/package/clawatch) · [**⭐ Star on GitHub**](https://github.com/GENWAY-AI/clawatch)\n\u003c/div\u003e\n\n---\n\n## Why ClaWatch?\n\nYour 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.\n\nVisibility is table stakes. ClaWatch gives you **control and autonomy** — so your agents run reliably while you sleep.\n\nBuilt for teams shipping AI products. Open source. Free forever.\n\n---\n\n## ✨ Features\n\n\u003ctable\u003e\n\u003ctr\u003e\n\u003ctd width=\"50%\"\u003e\n\n### 🛡️ **Cost Guardrails \u0026 Auto-Pause**\nSet 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.\n\n\u003c/td\u003e\n\u003ctd width=\"50%\"\u003e\n\n### 🔧 **Autonomous Issue Resolution**\nStuck in a loop? Crashed mid-task? ClaWatch detects common failure patterns and auto-resolves them — restart agents, kill runaway sessions, and recover gracefully.\n\n\u003c/td\u003e\n\u003c/tr\u003e\n\u003ctr\u003e\n\u003ctd\u003e\n\n### ⏯️ **Control Agents from Anywhere**\nPause, resume, or stop agents directly from the dashboard or your phone. One click, instant effect — even at 3 AM from your bed.\n\n\u003c/td\u003e\n\u003ctd\u003e\n\n### 🚨 **Smart Alerts That Explain Why**\nNot just \"agent crashed.\" ClaWatch tells you *what* failed, *why* it happened, and *what it did about it*. Telegram, Slack, or webhook — your choice.\n\n\u003c/td\u003e\n\u003c/tr\u003e\n\u003ctr\u003e\n\u003ctd\u003e\n\n### 📊 **Unified Session View**\nGroup sessions into projects for a bird's-eye view. See cost, timeline, and agent breakdown across related work. Interactive charts with zoom.\n\n\u003c/td\u003e\n\u003ctd\u003e\n\n### 🌐 **Multi-Profile Support**\nMonitor multiple OpenClaw installations from one dashboard. Switch profiles instantly — dev, staging, production.\n\n\u003c/td\u003e\n\u003c/tr\u003e\n\u003c/table\u003e\n\n---\n\n## 🚀 Quick Start\n\n### Install\n\n```bash\nnpm install -g clawatch\n```\n\n### Start Monitoring\n\n```bash\nclawatch start\n```\n\nThat's it! ClaWatch auto-detects your OpenClaw agents and opens the dashboard at `http://localhost:3001`.\n\n### Add Alerts (Optional)\n\n```bash\n# Get Telegram notifications when agents misbehave\nexport TELEGRAM_BOT_TOKEN=\"your_bot_token\"\nexport TELEGRAM_CHAT_ID=\"your_chat_id\"\n\nclawatch start\n```\n\n---\n\n## 🛠️ CLI Commands\n\n| Command | Description |\n|---------|-------------|\n| `clawatch start` | Auto-detect agents, start monitoring, and open the dashboard |\n| `clawatch stop` | Stop the monitoring daemon gracefully |\n| `clawatch status` | Show active agents, sessions, and daemon health |\n| `clawatch logs` | Stream real-time logs from the monitoring daemon |\n\n---\n\n## 🏗️ How It Works\n\n```\n┌──────────────────┐\n│  OpenClaw Agents │  (~/.openclaw/*)\n│  Sessions, Logs  │\n└────────┬─────────┘\n         │\n         ▼\n┌──────────────────┐      ┌──────────────────┐      ┌──────────────────┐\n│  ClaWatch CLI    │─────▶│  Backend API     │─────▶│  Alert Channels  │\n│  (Daemon)        │      │  Express+SQLite  │      │  Telegram/Slack  │\n└──────────────────┘      └────────┬─────────┘      └──────────────────┘\n                                   │\n                          ┌────────▼─────────┐\n                          │   Web Dashboard  │\n                          │   (Next.js)      │\n                          └──────────────────┘\n                         http://localhost:3001\n```\n\n1. **CLI daemon** watches `~/.openclaw/` for agent activity\n2. **Backend API** aggregates data into SQLite\n3. **Dashboard** visualizes everything in real-time\n4. **Alert system** watches for anomalies and notifies you\n\n---\n\n## 🦞 Works with Your Stack\n\nClaWatch auto-detects your agent framework. Full support today, more coming soon.\n\n| Framework | Status |\n|-----------|--------|\n| [🦞 OpenClaw](https://openclaw.ai) | ✅ Fully supported |\n| [NanoClaw](https://nanoclaw.net) | ✅ Fully supported |\n| [ZeroClaw](https://zeroclaw.dev) | 🔜 Coming soon |\n| [TrustClaw](https://www.trustclaw.app) | 🔜 Coming soon |\n| [Nanobot](https://nanobot.ai) | 🔜 Coming soon |\n| [PicoClaw](https://picoclaw.dev) | 🔜 Coming soon |\n\nWant support for your framework? [Request it →](https://github.com/GENWAY-AI/clawatch/issues)\n\n---\n\n## 🔔 Alert Channels\n\nGet notified where your team already works.\n\n| Channel | Status | Setup Guide |\n|---------|--------|-------------|\n| 📱 **Telegram** | ✅ Live | [Setup docs](https://github.com/GENWAY-AI/clawatch#add-alerts-optional) |\n| 💬 **Slack** | 🔜 Soon | Coming soon |\n| 🎮 **Discord** | 🔜 Soon | Coming soon |\n| 📧 **Email** | 🔜 Soon | Coming soon |\n| 📟 **PagerDuty** | 🔜 Soon | Coming soon |\n\n### Alert Types\n\n- 🔴 **Agent Crash** — Agent stopped unexpectedly\n- 🔁 **Infinite Loop** — Agent stuck repeating the same action\n- 💸 **Cost Spike** — Agent exceeded hourly/daily budget\n- 🕐 **Agent Stalled** — No activity for \u003e10 minutes\n- ⚠️ **High Error Rate** — Multiple tool call failures\n\n---\n\n## 🐳 Self-Host with Docker\n\nWant to run ClaWatch on a remote server? Use Docker:\n\n```bash\ngit clone https://github.com/GENWAY-AI/clawatch.git\ncd clawatch\ndocker build -t clawatch .\ndocker run -p 3001:3001 -e TELEGRAM_BOT_TOKEN=xxx clawatch\n```\n\nSupports any platform with Docker: **AWS, GCP, Azure, Hetzner, Digital Ocean, Render, Fly.io**.\n\n---\n\n## 💻 Runs Where You Run\n\nIf OpenClaw runs there, ClaWatch runs there.\n\n- ✅ macOS (Apple Silicon \u0026 Intel)\n- ✅ Linux (Ubuntu/Debian)\n- ✅ Windows WSL\n- ✅ Raspberry Pi\n- ✅ AWS / GCP / Digital Ocean / Hetzner\n\n---\n\n## 🧑‍💻 Development\n\n### Prerequisites\n\n- Node.js 18+\n- npm or pnpm\n\n### Local Setup\n\n```bash\n# Clone the repo\ngit clone https://github.com/GENWAY-AI/clawatch.git\ncd clawatch\n\n# Backend\ncd backend\nnpm install\nnpm run dev        # http://localhost:3001/api\n\n# Frontend (new terminal)\ncd frontend\nnpm install\nnpm run dev        # http://localhost:3000\n\n# CLI (new terminal)\ncd cli\nnpm install\nnpm run build\nnpm link           # Makes `clawatch` command available\n```\n\n### Project Structure\n\n```\nclawatch/\n├── cli/              # Monitoring daemon + CLI\n│   ├── src/\n│   │   ├── cli.ts    # Main entry point\n│   │   └── daemon.ts # Background monitoring\n│   └── package.json\n├── backend/          # Express API\n│   ├── src/\n│   │   ├── index.ts  # Server\n│   │   ├── routes/   # REST endpoints\n│   │   └── db.ts     # SQLite schema\n│   └── package.json\n├── frontend/         # Next.js dashboard\n│   ├── app/          # Pages\n│   ├── components/   # React components\n│   └── package.json\n├── Dockerfile        # Production container\n└── API_CONTRACT.md   # Backend API docs\n```\n\n---\n\n## 📈 Roadmap\n\n### ✅ Shipped\n\n- [x] Real-time agent monitoring\n- [x] Cost tracking (per agent, per model)\n- [x] Telegram alerts\n- [x] Multi-profile support\n- [x] Session logs \u0026 project grouping\n- [x] Agent control (pause/resume)\n- [x] Docker support for self-hosting\n- [x] Pure WASM SQLite (no native deps)\n- [x] Interactive analytics with chart zoom \u0026 URL persistence\n\n### 🚧 In Progress\n\n- [ ] Agent Auto-Fixer (autonomous failure detection \u0026 recovery)\n- [ ] Slack integration\n- [ ] Discord bot\n- [ ] Custom alert rules builder\n\n### 🔮 Coming Soon\n\n- [ ] NanoClaw/ZeroClaw/TrustClaw support\n- [ ] Multi-user auth \u0026 teams\n- [ ] Agent performance scoring\n- [ ] Cost prediction\n- [ ] Webhook alerts\n- [ ] Email alerts\n\n[**Vote on features →**](https://github.com/GENWAY-AI/clawatch/discussions)\n\n---\n\n## 🤝 Contributing\n\nWe love contributions! Bug reports, feature requests, and PRs are all welcome.\n\n### How to Contribute\n\n1. **Fork the repo** and create a feature branch\n2. **Make your changes** (add tests if applicable)\n3. **Open a PR** with a clear description\n4. **We'll review** and merge within 48 hours\n\n### Good First Issues\n\nCheck out issues labeled [`good first issue`](https://github.com/GENWAY-AI/clawatch/labels/good%20first%20issue).\n\n---\n\n## 💬 Community \u0026 Support\n\n- **GitHub Discussions**: [Ask questions, share tips](https://github.com/GENWAY-AI/clawatch/discussions)\n- **GitHub Issues**: [Report bugs, request features](https://github.com/GENWAY-AI/clawatch/issues)\n- **Discord**: [Join our community](https://discord.gg/A7mYjwja)\n- **Email**: hello@genway.ai\n\n---\n\n## 📜 License\n\nMIT © [GENWAY AI](https://github.com/GENWAY-AI)\n\nFree to use in commercial products. See [LICENSE](./LICENSE) for details.\n\n---\n\n\u003cdiv align=\"center\"\u003e\n  \n  ### **Built with ❤️ by [GENWAY AI](https://genway.ai)**\n  \n  [Website](https://clawatch.dev) · [GitHub](https://github.com/GENWAY-AI/clawatch) · [npm](https://www.npmjs.com/package/clawatch)\n  \n\u003c/div\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FGENWAY-AI%2Fclawatch","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FGENWAY-AI%2Fclawatch","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FGENWAY-AI%2Fclawatch/lists"}