> Deutsch translation of [README](../../../README.md), auto-generated from the English source. English is canonical; open a PR against `README.md` for content changes.
# 🦞 ClawMetry
[](https://clickpy.clickhouse.com/dashboard/clawmetry)
[](https://clickpy.clickhouse.com/dashboard/clawmetry)
[](https://pypi.org/project/clawmetry/)
[](https://github.com/vivekchand/clawmetry/stargazers)
[](https://opensource.org/licenses/MIT)
**Sieh zu, wie dein Agent denkt.** Echtzeit-Observability für **14 KI-Agenten-Runtimes**: [OpenClaw](https://github.com/openclaw/openclaw), [NVIDIA NemoClaw](https://github.com/NVIDIA/NemoClaw), Claude Code, OpenAI Codex und 10 weitere. Ein Dashboard für deine gesamte Agenten-Flotte.
> 🌐 **Lies dies auf:** [English](README.md) · [简体中文](docs/i18n/zh-CN/README.md) · [日本語](docs/i18n/ja/README.md) · [한국어](docs/i18n/ko/README.md) · [Español](docs/i18n/es/README.md) · [Português (BR)](docs/i18n/pt-BR/README.md) · [Français](docs/i18n/fr/README.md) · [Deutsch](docs/i18n/de/README.md) · [हिन्दी](docs/i18n/hi/README.md) · [العربية](docs/i18n/ar/README.md) · [Русский](docs/i18n/ru/README.md) · [mehr →](docs/i18n/)
Ein Befehl. Keine Konfiguration. Erkennt alles automatisch.
```bash
pip install clawmetry && clawmetry
```
Öffnet sich unter **http://localhost:8900** und schon bist du fertig.
## Funktioniert mit 14 Agenten-Runtimes
ClawMetry begann als Observability-Lösung für OpenClaw und misst nun deine **gesamte Agenten-Flotte** in einem Dashboard, wobei jede Runtime auf deinem Rechner automatisch erkannt wird:
🦞 **OpenClaw** · 🟩 **NVIDIA NemoClaw** · ◆ **Claude Code** · ⬡ **OpenAI Codex** · **Cursor** · 🪿 **Goose** · ⚡ **Hermes** · **opencode** · ◈ **Qwen Code** · **Aider** · **NanoClaw** · **PicoClaw** · **Pi** · **Deep Agents** · 🔗 **n8n**
OpenClaw und NemoClaw sind in der Open-Source-App kostenlos; die anderen Runtimes werden mit ClawMetry Cloud oder einer selbst gehosteten Pro-Lizenz freigeschaltet. Wechsle Runtimes über die Kopfzeile und jeder Tab, Kosten, Tokens, Tools, Traces, bezieht sich neu auf diese Runtime. Siehe **[docs/ENTITLEMENTS.md](docs/ENTITLEMENTS.md)** für die genaue kostenlos/kostenpflichtig-Aufteilung, die Stufenmatrix, die `/api/entitlement`-Struktur und die `clawmetry license` CLI.
## Was du bekommst
- **Flow** — Live animiertes Diagramm, das zeigt, wie Nachrichten durch Kanäle, Brain, Tools und zurück fließen
- **Overview** — Gesundheitschecks, Aktivitäts-Heatmap, Sitzungszahlen, Modellinformationen
- **Usage** — Token- und Kostenverfolgung mit täglichen/wöchentlichen/monatlichen Aufschlüsselungen
- **Sessions** — Aktive Agentensitzungen mit Modell, Tokens, letzter Aktivität
- **Crons** — Geplante Jobs mit Status, nächstem Lauf, Dauer
- **Logs** — Farbcodiertes Echtzeit-Log-Streaming
- **Memory** — Durchsuche SOUL.md, MEMORY.md, AGENTS.md, tägliche Notizen
- **Transcripts** — Chat-Bubble-UI zum Lesen von Sitzungsverläufen
- **Alerts** — Budgetgrenzen, Fehlerraten-Trigger, Erkennung von Offline-Agenten; leitet weiter an Slack, Discord, PagerDuty, Telegram, E-Mail
- **Approvals** — Blockiert destruktive Löschungen, erzwungene Pushes, DB-Mutationen, sudo, Paketinstallationen, Netzwerkaufrufe hinter einer Freigabe per Klick
## Screenshots
### 🧠 Brain — Live-Ereignisstream des Agenten
### 📊 Overview — Token-Nutzung & Sitzungsübersicht
### ⚡ Flow — Echtzeit-Feed der Tool-Aufrufe
### 💰 Tokens — Kostenaufschlüsselung nach Modell & Sitzung
### 🧬 Memory — Workspace-Dateibrowser
### 🔐 Security — Sicherheitslage & Audit-Log
### 🚨 Alerts — Budgetgrenzen, Fehlerraten-Trigger, Webhooks zu Slack / Discord / PagerDuty / E-Mail
### ✋ Approvals — Riskante Tool-Aufrufe hinter manueller Freigabe blockieren; richtliniengestützte Schutzregeln
**Blockierung vor der Ausführung für Claude Code** — ein Befehl installiert
einen PreToolUse-Hook, der passende Tool-Aufrufe *bevor* sie ausgeführt werden pausiert und auf deine
Entscheidung wartet (ein Tippen von deinem Handy aus mit aktivierten
[Cloud-Push-Benachrichtigungen](https://app.clawmetry.com/push)):
```bash
clawmetry hooks install # writes ~/.claude/settings.json (idempotent)
clawmetry hooks status # what's wired + how many policies are active
clawmetry hooks uninstall # removes only ClawMetry's entries
```
Eine Ablehnung blockiert nur diesen einen Tool-Aufruf, der Agent behält seine Sitzung und kann
einen anderen Ansatz versuchen. Eine Genehmigung auf deinem Handy überspringt Claude Codes eigene
Berechtigungsabfrage (du hast bereits geantwortet). Nicht zutreffende Tools kosten ~40ms und
fallen zurück auf Claude Codes normalen Berechtigungsablauf. Du bekommst außerdem eine Push-Benachrichtigung aufs Handy, wenn Claude Code selbst auf dich wartet (`permission_prompt`- /
`idle_prompt`-Benachrichtigungen).
## Installation
**Ein-Zeilen-Installation (empfohlen):**
```bash
curl -sSL https://raw.githubusercontent.com/vivekchand/clawmetry/main/install.sh | bash
```
**pip:**
```bash
pip install clawmetry
clawmetry
```
**Aus dem Quellcode:**
```bash
git clone https://github.com/vivekchand/clawmetry.git
cd clawmetry && pip install flask && python3 dashboard.py
```
## v2 Frontend-Entwicklung
Die v2 React-App befindet sich in `frontend/` und wird unter `/v2` bereitgestellt, wenn der Flask-
Server mit aktiviertem v2 gestartet wird.
Verwende zwei Terminals während der Entwicklung:
```bash
# Terminal 1: Flask API/server on :8900
CLAWMETRY_V2=1 python3 dashboard.py
```
```bash
# Terminal 2: Vite dev server on :5173
cd frontend
nvm use
npm ci
npm run dev
```
Öffne `http://localhost:5173/v2/`. Vite leitet `/api`-Anfragen an
`http://localhost:8900` weiter, sodass die React-App mit dem lokalen Flask-Server sprechen kann,
ohne zusätzliche CORS-Konfiguration.
Um das Bundle zu erstellen, das mit dem Python-Paket ausgeliefert wird:
```bash
cd frontend
npm run build
```
Das Produktions-Bundle wird nach `clawmetry/static/v2/dist/` geschrieben.
## Runtime-/Agenten-Kompatibilität
ClawMetry beobachtet viele KI-Agenten-Runtimes, nicht nur OpenClaw. Jede Nicht-OpenClaw-Runtime liefert einen eigenen Reader-Adapter, der ihr natives Sitzungsformat in ClawMetrys einheitliche Datenstrukturen übersetzt; der Daemon nimmt sie in denselben DuckDB-Speicher + Cloud-Snapshot auf, markiert mit der Runtime, und der Session-Replay-Tab zeigt einen **Runtime-Umschalter**, wenn mehr als eine vorhanden ist. Siehe [`docs/compatibility.md`](docs/compatibility.md) für die vollständige Matrix + eine Anleitung zum Hinzufügen von Runtimes, und [`docs/RUNTIME_FAMILY.md`](docs/RUNTIME_FAMILY.md) für die Einführung in die OpenClaw-Familie.
| Runtime / Agent | Status | Notizen |
|---|---|---|
| **OpenClaw** | Nativ | Referenz-Runtime, automatisch erkannt |
| **PicoClaw** | Beta-Adapter | Flaches `providers.Message` JSONL (`~/.picoclaw/workspace/sessions`). Transkripte, Modell, Tool-Aufrufe. |
| **NanoClaw** | Beta-Adapter | SQLite pro Sitzung (`data/v2-sessions`). Transkripte + Nachrichtenzahlen. |
| **Hermes** | Beta-Adapter | SQLite `~/.hermes/state.db`. Transkripte, Modell, Tokens/Kosten. |
| **Claude Code** | Beta-Adapter | JSONL `~/.claude/projects/.../.jsonl`. Transkripte, Modell, Tool-Aufrufe + Denkprozesse, Token-Nutzung. |
| **Codex** | Beta-Adapter | Rollout-JSONL `~/.codex/sessions/...`. Transkripte, Modell, Tool-Aufrufe, Token-Nutzung. |
| **Cursor** | Beta-Adapter | SQLite `state.vscdb`. Chat-/Composer-Transkripte, Modell. |
| **Aider** | Beta-Adapter | `.aider.chat.history.md` pro Projekt. Transkripte, Modell, Token-Zählungen. |
| **Goose** | Beta-Adapter | SQLite `~/.local/share/goose`. Transkripte, Modell, Tool-Aufrufe, Token-Summen. |
| **opencode** | Beta-Adapter | SQLite `~/.local/share/opencode`. Transkripte, Modell, Tool-Aufrufe, Tokens + Kosten. |
| **Qwen Code** | Beta-Adapter | JSONL `~/.qwen/projects/.../chats`. Transkripte, Modell, Tool-Aufrufe, Token-Nutzung. |
| **Pi** | Beta-Adapter | JSONL `~/.pi/agent/sessions`. Transkripte, Modell, Tool-Aufrufe, Tokens + Kosten. |
| **Deep Agents** | Beta-Adapter | SQLite `~/.deepagents/.state/sessions.db`. Transkripte, Modell, Tool-Aufrufe, Tokens + Kosten. |
| **n8n** | Beta-Adapter | SQLite `~/.n8n/database.sqlite`. Workflow-Ausführungen, Node-Läufe, AI-Agent-Prompts, Modell + Tokens, sofern n8n diese erfasst. |
"Beta-Adapter" bedeutet, dass ClawMetry einen Reader für das tatsächliche On-Disk-Format dieser Runtime mitliefert, jeder erstellt + verifiziert gegen eine echte Installation auf einer echten Maschine (siehe `tests/fixtures/runtimes/
