> Español 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)
**Observa a tu agente pensar.** Observabilidad en tiempo real para **14 runtimes de agentes de IA**: [OpenClaw](https://github.com/openclaw/openclaw), [NVIDIA NemoClaw](https://github.com/NVIDIA/NemoClaw), Claude Code, OpenAI Codex y 10 más. Un solo panel para toda tu flota de agentes.
> 🌐 **Lee esto 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) · [más →](docs/i18n/)
Un solo comando. Cero configuración. Detecta todo automáticamente.
```bash
pip install clawmetry && clawmetry
```
Se abre en **http://localhost:8900** y listo.
## Funciona con 14 runtimes de agentes
ClawMetry comenzó como observabilidad para OpenClaw, y ahora mide toda tu **flota de agentes** en un solo panel, detectando automáticamente cada runtime en tu máquina:
🦞 **OpenClaw** · 🟩 **NVIDIA NemoClaw** · ◆ **Claude Code** · ⬡ **OpenAI Codex** · **Cursor** · 🪿 **Goose** · ⚡ **Hermes** · **opencode** · ◈ **Qwen Code** · **Aider** · **NanoClaw** · **PicoClaw** · **Pi** · **Deep Agents** · 🔗 **n8n**
OpenClaw y NemoClaw son gratuitos en la app de código abierto; los demás runtimes se activan con ClawMetry Cloud o una licencia Pro autohospedada. Cambia de runtime desde el encabezado y cada pestaña (costo, tokens, herramientas, trazas) se reajusta a ese runtime. Consulta **[docs/ENTITLEMENTS.md](docs/ENTITLEMENTS.md)** para conocer el reparto exacto entre gratuito y de pago, la matriz de niveles, la forma de `/api/entitlement` y la CLI de `clawmetry license`.
## Qué obtienes
- **Flow** — Diagrama animado en vivo que muestra los mensajes fluyendo por canales, brain, herramientas y de vuelta
- **Overview** — Comprobaciones de salud, mapa de calor de actividad, conteo de sesiones, información del modelo
- **Usage** — Seguimiento de tokens y costos con desgloses diarios/semanales/mensuales
- **Sessions** — Sesiones de agentes activas con modelo, tokens, última actividad
- **Crons** — Tareas programadas con estado, próxima ejecución, duración
- **Logs** — Transmisión de registros en tiempo real con colores
- **Memory** — Explora SOUL.md, MEMORY.md, AGENTS.md, notas diarias
- **Transcripts** — Interfaz de burbujas de chat para leer historiales de sesiones
- **Alerts** — Límites de presupuesto, disparadores de tasa de error, detección de agente fuera de línea; enruta a Slack, Discord, PagerDuty, Telegram, Email
- **Approvals** — Bloquea eliminaciones destructivas, force pushes, mutaciones de base de datos, sudo, instalaciones de paquetes, llamadas de red detrás de una aprobación con un clic
## Capturas de pantalla
### 🧠 Brain — Transmisión en vivo de eventos del agente
### 📊 Overview — Uso de tokens y resumen de sesiones
### ⚡ Flow — Feed en tiempo real de llamadas a herramientas
### 💰 Tokens — Desglose de costos por modelo y sesión
### 🧬 Memory — Explorador de archivos del workspace
### 🔐 Security — Postura y registro de auditoría
### 🚨 Alerts — Límites de presupuesto, disparadores de tasa de error, webhooks a Slack / Discord / PagerDuty / Email
### ✋ Approvals — Bloquea llamadas a herramientas riesgosas detrás de una aprobación manual; reglas de protección respaldadas por políticas
**Bloqueo previo a la ejecución para Claude Code**: un solo comando instala
un hook PreToolUse que pausa las llamadas a herramientas coincidentes *antes* de que se ejecuten y espera
tu decisión (un toque desde tu teléfono con
[notificaciones push en la nube](https://app.clawmetry.com/push) habilitadas):
```bash
clawmetry hooks install # escribe ~/.claude/settings.json (idempotente)
clawmetry hooks status # qué está conectado y cuántas políticas están activas
clawmetry hooks uninstall # elimina solo las entradas de ClawMetry
```
Un rechazo bloquea solo esa llamada a herramienta; el agente conserva su sesión y puede
intentar otro enfoque. Aprobar desde tu teléfono omite el propio
aviso de permisos de Claude Code (ya respondiste). Las herramientas sin coincidencia cuestan ~40ms y
caen al flujo de permisos normal de Claude Code. También recibes un aviso push en tu teléfono cuando el propio Claude Code
está esperando tu respuesta (notificaciones `permission_prompt` /
`idle_prompt`).
## Instalación
**Comando único (recomendado):**
```bash
curl -sSL https://raw.githubusercontent.com/vivekchand/clawmetry/main/install.sh | bash
```
**pip:**
```bash
pip install clawmetry
clawmetry
```
**Desde el código fuente:**
```bash
git clone https://github.com/vivekchand/clawmetry.git
cd clawmetry && pip install flask && python3 dashboard.py
```
## Desarrollo del frontend v2
La app React v2 vive en `frontend/` y se sirve en `/v2` cuando el servidor
Flask se inicia con v2 habilitado.
Usa dos terminales durante el desarrollo:
```bash
# Terminal 1: API/servidor Flask en :8900
CLAWMETRY_V2=1 python3 dashboard.py
```
```bash
# Terminal 2: servidor de desarrollo Vite en :5173
cd frontend
nvm use
npm ci
npm run dev
```
Abre `http://localhost:5173/v2/`. Vite reenvía las solicitudes `/api` a
`http://localhost:8900`, de modo que la app React puede comunicarse con el servidor Flask local
sin configuración adicional de CORS.
Para compilar el paquete que se distribuye con el paquete Python:
```bash
cd frontend
npm run build
```
El paquete de producción se escribe en `clawmetry/static/v2/dist/`.
## Compatibilidad de runtimes / agentes
ClawMetry observa muchos runtimes de agentes de IA, no solo OpenClaw. Cada runtime que no sea OpenClaw incluye un adaptador lector dedicado que traduce su formato de sesión nativo a las formas unificadas de ClawMetry; el daemon los ingiere en el mismo almacén DuckDB + snapshot en la nube, etiquetados con el runtime, y la pestaña de repetición de sesión muestra un **selector de runtime** cuando hay más de uno presente. Consulta [`docs/compatibility.md`](docs/compatibility.md) para ver la matriz completa y una guía para añadir runtimes, y [`docs/RUNTIME_FAMILY.md`](docs/RUNTIME_FAMILY.md) para la introducción a la familia OpenClaw.
| Runtime / Agente | Estado | Notas |
|---|---|---|
| **OpenClaw** | Nativo | Runtime de referencia, detectado automáticamente |
| **PicoClaw** | Adaptador beta | JSONL plano de `providers.Message` (`~/.picoclaw/workspace/sessions`). Transcripciones, modelo, llamadas a herramientas. |
| **NanoClaw** | Adaptador beta | SQLite por sesión (`data/v2-sessions`). Transcripciones + conteo de mensajes. |
| **Hermes** | Adaptador beta | SQLite `~/.hermes/state.db`. Transcripciones, modelo, tokens/costo. |
| **Claude Code** | Adaptador beta | JSONL `~/.claude/projects/.../.jsonl`. Transcripciones, modelo, llamadas a herramientas + razonamiento, uso de tokens. |
| **Codex** | Adaptador beta | Rollout JSONL `~/.codex/sessions/...`. Transcripciones, modelo, llamadas a herramientas, uso de tokens. |
| **Cursor** | Adaptador beta | SQLite `state.vscdb`. Transcripciones de chat/composer, modelo. |
| **Aider** | Adaptador beta | `.aider.chat.history.md` por proyecto. Transcripciones, modelo, conteo de tokens. |
| **Goose** | Adaptador beta | SQLite `~/.local/share/goose`. Transcripciones, modelo, llamadas a herramientas, totales de tokens. |
| **opencode** | Adaptador beta | SQLite `~/.local/share/opencode`. Transcripciones, modelo, llamadas a herramientas, tokens + costo. |
| **Qwen Code** | Adaptador beta | JSONL `~/.qwen/projects/.../chats`. Transcripciones, modelo, llamadas a herramientas, uso de tokens. |
| **Pi** | Adaptador beta | JSONL `~/.pi/agent/sessions`. Transcripciones, modelo, llamadas a herramientas, tokens + costo. |
| **Deep Agents** | Adaptador beta | SQLite `~/.deepagents/.state/sessions.db`. Transcripciones, modelo, llamadas a herramientas, tokens + costo. |
| **n8n** | Adaptador beta | SQLite `~/.n8n/database.sqlite`. Ejecuciones de flujos de trabajo, ejecuciones de nodos, prompts del AI Agent, modelo + tokens cuando n8n los registra. |
"Adaptador beta" significa que ClawMetry incluye un lector para el formato real en disco de ese runtime, cada uno construido y verificado contra una instalación real en una máquina real (consulta `tests/fixtures/runtimes/
