> Français 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)
**Regardez votre agent penser.** Observabilité en temps réel pour **14 runtimes d'agents IA** : [OpenClaw](https://github.com/openclaw/openclaw), [NVIDIA NemoClaw](https://github.com/NVIDIA/NemoClaw), Claude Code, OpenAI Codex et 10 autres. Un seul tableau de bord pour toute votre flotte d'agents.
> 🌐 **Lire ceci en :** [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) · [plus →](docs/i18n/)
Une seule commande. Zéro configuration. Détection automatique de tout.
```bash
pip install clawmetry && clawmetry
```
S'ouvre sur **http://localhost:8900** et c'est terminé.
## Compatible avec 14 runtimes d'agents
ClawMetry a démarré comme un outil d'observabilité pour OpenClaw, et couvre désormais **toute votre flotte d'agents** dans un seul tableau de bord, en détectant automatiquement chaque runtime présent sur votre machine :
🦞 **OpenClaw** · 🟩 **NVIDIA NemoClaw** · ◆ **Claude Code** · ⬡ **OpenAI Codex** · **Cursor** · 🪿 **Goose** · ⚡ **Hermes** · **opencode** · ◈ **Qwen Code** · **Aider** · **NanoClaw** · **PicoClaw** · **Pi** · **Deep Agents** · 🔗 **n8n**
OpenClaw et NemoClaw sont gratuits dans l'application open source ; les autres runtimes s'activent avec ClawMetry Cloud ou une licence Pro auto-hébergée. Changez de runtime depuis l'en-tête et chaque onglet, coût, tokens, outils, traces, se recadre automatiquement sur ce runtime. Consultez **[docs/ENTITLEMENTS.md](docs/ENTITLEMENTS.md)** pour la répartition exacte gratuit/payant, la matrice des niveaux, la forme de `/api/entitlement`, et la CLI `clawmetry license`.
## Ce que vous obtenez
- **Flow** — Diagramme animé en direct montrant les messages circulant entre les canaux, le cerveau, les outils, et retour
- **Overview** — Bilans de santé, carte de chaleur d'activité, nombre de sessions, informations sur les modèles
- **Usage** — Suivi des tokens et des coûts avec des répartitions quotidiennes/hebdomadaires/mensuelles
- **Sessions** — Sessions d'agents actives avec modèle, tokens, dernière activité
- **Crons** — Tâches planifiées avec statut, prochaine exécution, durée
- **Logs** — Diffusion de journaux en temps réel avec code couleur
- **Memory** — Parcourez SOUL.md, MEMORY.md, AGENTS.md, les notes quotidiennes
- **Transcripts** — Interface en bulles de discussion pour lire l'historique des sessions
- **Alerts** — Plafonds budgétaires, déclencheurs de taux d'erreur, détection d'agent hors ligne ; achemine vers Slack, Discord, PagerDuty, Telegram, Email
- **Approvals** — Bloquez les suppressions destructrices, les push forcés, les mutations de base de données, sudo, les installations de paquets, les appels réseau derrière une validation en un clic
## Captures d'écran
### 🧠 Brain — Flux d'événements de l'agent en direct
### 📊 Overview — Utilisation des tokens et résumé des sessions
### ⚡ Flow — Flux d'appels d'outils en temps réel
### 💰 Tokens — Répartition des coûts par modèle et par session
### 🧬 Memory — Explorateur de fichiers de l'espace de travail
### 🔐 Security — Posture et journal d'audit
### 🚨 Alerts — Plafonds budgétaires, déclencheurs de taux d'erreur, webhooks vers Slack / Discord / PagerDuty / Email
### ✋ Approvals — Bloquez les appels d'outils risqués derrière une validation manuelle ; règles de protection appuyées sur des politiques
**Blocage avant exécution pour Claude Code** — une seule commande installe un
hook PreToolUse qui met en pause les appels d'outils correspondants *avant* qu'ils s'exécutent et attend
votre décision (un tap depuis votre téléphone avec les
[notifications push cloud](https://app.clawmetry.com/push) activées) :
```bash
clawmetry hooks install # écrit ~/.claude/settings.json (idempotent)
clawmetry hooks status # ce qui est câblé + combien de politiques sont actives
clawmetry hooks uninstall # retire uniquement les entrées de ClawMetry
```
Un refus ne bloque que cet appel d'outil précis, l'agent conserve sa session et peut
essayer une autre approche. Approuver depuis votre téléphone contourne l'invite de
permission propre à Claude Code (vous avez déjà répondu). Les outils non correspondants coûtent environ 40 ms et
retombent dans le flux de permission normal de Claude Code. Vous recevez aussi une notification push sur votre
téléphone lorsque Claude Code lui-même attend une réponse de votre part (notifications
`permission_prompt` / `idle_prompt`).
## Installation
**Ligne unique (recommandé) :**
```bash
curl -sSL https://raw.githubusercontent.com/vivekchand/clawmetry/main/install.sh | bash
```
**pip :**
```bash
pip install clawmetry
clawmetry
```
**Depuis les sources :**
```bash
git clone https://github.com/vivekchand/clawmetry.git
cd clawmetry && pip install flask && python3 dashboard.py
```
## Développement du frontend v2
L'application React v2 se trouve dans `frontend/` et est servie sur `/v2` lorsque le
serveur Flask est démarré avec v2 activé.
Utilisez deux terminaux pendant le développement :
```bash
# Terminal 1 : API/serveur Flask sur :8900
CLAWMETRY_V2=1 python3 dashboard.py
```
```bash
# Terminal 2 : serveur de développement Vite sur :5173
cd frontend
nvm use
npm ci
npm run dev
```
Ouvrez `http://localhost:5173/v2/`. Vite redirige les requêtes `/api` vers
`http://localhost:8900`, afin que l'application React puisse communiquer avec le serveur Flask local
sans configuration CORS supplémentaire.
Pour construire le bundle livré avec le paquet Python :
```bash
cd frontend
npm run build
```
Le bundle de production est écrit dans `clawmetry/static/v2/dist/`.
## Compatibilité des runtimes / agents
ClawMetry observe de nombreux runtimes d'agents IA, pas seulement OpenClaw. Chaque runtime autre qu'OpenClaw dispose d'un adaptateur de lecture dédié qui traduit son format de session natif vers les formats unifiés de ClawMetry ; le daemon les ingère dans le même magasin DuckDB + instantané cloud, étiquetés avec le runtime, et l'onglet de relecture de session affiche un **sélecteur de runtime** lorsque plusieurs sont présents. Consultez [`docs/compatibility.md`](docs/compatibility.md) pour la matrice complète + un guide pour ajouter des runtimes, et [`docs/RUNTIME_FAMILY.md`](docs/RUNTIME_FAMILY.md) pour l'introduction à la famille OpenClaw.
| Runtime / Agent | Statut | Notes |
|---|---|---|
| **OpenClaw** | Natif | Runtime de référence, détecté automatiquement |
| **PicoClaw** | Adaptateur bêta | JSONL plat `providers.Message` (`~/.picoclaw/workspace/sessions`). Transcriptions, modèle, appels d'outils. |
| **NanoClaw** | Adaptateur bêta | SQLite par session (`data/v2-sessions`). Transcriptions + nombre de messages. |
| **Hermes** | Adaptateur bêta | SQLite `~/.hermes/state.db`. Transcriptions, modèle, tokens/coût. |
| **Claude Code** | Adaptateur bêta | JSONL `~/.claude/projects/.../.jsonl`. Transcriptions, modèle, appels d'outils + réflexion, utilisation des tokens. |
| **Codex** | Adaptateur bêta | Rollout JSONL `~/.codex/sessions/...`. Transcriptions, modèle, appels d'outils, utilisation des tokens. |
| **Cursor** | Adaptateur bêta | SQLite `state.vscdb`. Transcriptions de chat/composer, modèle. |
| **Aider** | Adaptateur bêta | `.aider.chat.history.md` par projet. Transcriptions, modèle, comptages de tokens. |
| **Goose** | Adaptateur bêta | SQLite `~/.local/share/goose`. Transcriptions, modèle, appels d'outils, totaux de tokens. |
| **opencode** | Adaptateur bêta | SQLite `~/.local/share/opencode`. Transcriptions, modèle, appels d'outils, tokens + coût. |
| **Qwen Code** | Adaptateur bêta | JSONL `~/.qwen/projects/.../chats`. Transcriptions, modèle, appels d'outils, utilisation des tokens. |
| **Pi** | Adaptateur bêta | JSONL `~/.pi/agent/sessions`. Transcriptions, modèle, appels d'outils, tokens + coût. |
| **Deep Agents** | Adaptateur bêta | SQLite `~/.deepagents/.state/sessions.db`. Transcriptions, modèle, appels d'outils, tokens + coût. |
| **n8n** | Adaptateur bêta | SQLite `~/.n8n/database.sqlite`. Exécutions de workflows, exécutions de nœuds, prompts d'AI Agent, modèle + tokens lorsque n8n les enregistre. |
« Adaptateur bêta » signifie que ClawMetry fournit un lecteur pour le format réel sur disque de ce runtime, chacun construit et vérifié par rapport à une installation réelle sur une machine réelle (voir `tests/fixtures/runtimes/
