> Português (BR) 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)
**Veja seu agente pensar.** Observabilidade em tempo 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 e mais 10. Um único painel para toda a sua frota de agentes.
> 🌐 **Leia isto em:** [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) · [mais →](docs/i18n/)
Um comando. Zero configuração. Detecta tudo automaticamente.
```bash
pip install clawmetry && clawmetry
```
Abre em **http://localhost:8900** e pronto.
## Funciona com 14 runtimes de agentes
O ClawMetry começou como observabilidade para o OpenClaw e agora monitora toda a sua **frota de agentes** em um único painel, detectando automaticamente cada runtime na sua máquina:
🦞 **OpenClaw** · 🟩 **NVIDIA NemoClaw** · ◆ **Claude Code** · ⬡ **OpenAI Codex** · **Cursor** · 🪿 **Goose** · ⚡ **Hermes** · **opencode** · ◈ **Qwen Code** · **Aider** · **NanoClaw** · **PicoClaw** · **Pi** · **Deep Agents** · 🔗 **n8n**
OpenClaw e NemoClaw são gratuitos no app de código aberto; os demais runtimes são liberados com o ClawMetry Cloud ou uma licença Pro autogerenciada. Troque de runtime pelo cabeçalho e cada aba, custo, tokens, ferramentas, traces, reajusta o escopo para esse runtime. Veja **[docs/ENTITLEMENTS.md](docs/ENTITLEMENTS.md)** para a divisão exata entre gratuito/pago, a matriz de níveis, o formato de `/api/entitlement` e a CLI `clawmetry license`.
## O que você recebe
- **Flow** — Diagrama animado ao vivo mostrando mensagens fluindo por canais, cérebro, ferramentas e de volta
- **Overview** — Verificações de saúde, mapa de calor de atividade, contagem de sessões, informações do modelo
- **Usage** — Rastreamento de tokens e custos com detalhamento diário/semanal/mensal
- **Sessions** — Sessões de agentes ativas com modelo, tokens, última atividade
- **Crons** — Jobs agendados com status, próxima execução, duração
- **Logs** — Streaming de logs em tempo real com cores
- **Memory** — Navegue por SOUL.md, MEMORY.md, AGENTS.md, notas diárias
- **Transcripts** — Interface de balões de chat para ler históricos de sessões
- **Alerts** — Limites de orçamento, gatilhos de taxa de erro, detecção de agente offline; roteia para Slack, Discord, PagerDuty, Telegram, Email
- **Approvals** — Bloqueia exclusões destrutivas, force pushes, mutações de banco de dados, sudo, instalações de pacotes, chamadas de rede atrás de uma aprovação com um clique
## Capturas de tela
### 🧠 Brain — Fluxo de eventos do agente ao vivo
### 📊 Overview — Uso de tokens e resumo de sessões
### ⚡ Flow — Feed de chamadas de ferramentas em tempo real
### 💰 Tokens — Detalhamento de custos por modelo e sessão
### 🧬 Memory — Navegador de arquivos do workspace
### 🔐 Security — Postura e log de auditoria
### 🚨 Alerts — Limites de orçamento, gatilhos de taxa de erro, webhooks para Slack / Discord / PagerDuty / Email
### ✋ Approvals — Bloqueia chamadas de ferramentas arriscadas atrás de aprovação manual; regras de proteção baseadas em política
**Bloqueio pré-execução para Claude Code** — um comando instala um
hook PreToolUse que pausa as chamadas de ferramentas correspondentes *antes* de
serem executadas e aguarda sua decisão (um toque a partir do seu celular com
[notificações push na nuvem](https://app.clawmetry.com/push) habilitadas):
```bash
clawmetry hooks install # escreve ~/.claude/settings.json (idempotente)
clawmetry hooks status # o que está conectado + quantas políticas estão ativas
clawmetry hooks uninstall # remove apenas as entradas do ClawMetry
```
Uma negação bloqueia apenas aquela chamada de ferramenta específica, o agente mantém sua sessão e pode
tentar outra abordagem. Aprovar pelo celular pula o próprio prompt de
permissão do Claude Code (você já respondeu). Ferramentas não correspondentes custam ~40ms e
seguem para o fluxo de permissão normal do Claude Code. Você também recebe um push no celular quando o Claude Code
está aguardando sua resposta (notificações `permission_prompt` /
`idle_prompt`).
## Instalação
**Um comando (recomendado):**
```bash
curl -sSL https://raw.githubusercontent.com/vivekchand/clawmetry/main/install.sh | bash
```
**pip:**
```bash
pip install clawmetry
clawmetry
```
**A partir do código-fonte:**
```bash
git clone https://github.com/vivekchand/clawmetry.git
cd clawmetry && pip install flask && python3 dashboard.py
```
## Desenvolvimento do Frontend v2
O app React v2 está em `frontend/` e é servido em `/v2` quando o servidor
Flask é iniciado com o v2 habilitado.
Use dois terminais durante o desenvolvimento:
```bash
# Terminal 1: Flask API/server na porta :8900
CLAWMETRY_V2=1 python3 dashboard.py
```
```bash
# Terminal 2: Servidor de desenvolvimento Vite na porta :5173
cd frontend
nvm use
npm ci
npm run dev
```
Abra `http://localhost:5173/v2/`. O Vite faz proxy das requisições `/api` para
`http://localhost:8900`, então o app React consegue conversar com o servidor Flask local
sem configuração extra de CORS.
Para gerar o bundle que é distribuído com o pacote Python:
```bash
cd frontend
npm run build
```
O bundle de produção é gravado em `clawmetry/static/v2/dist/`.
## Compatibilidade de Runtime / Agente
O ClawMetry observa muitos runtimes de agentes de IA, não apenas o OpenClaw. Cada runtime que não seja o OpenClaw traz um adaptador leitor dedicado que traduz o formato nativo de sessões desse runtime para os formatos unificados do ClawMetry; o daemon os ingere no mesmo armazenamento DuckDB + snapshot na nuvem, marcados com o runtime, e a aba Session replay mostra um **seletor de runtime** quando mais de um está presente. Veja [`docs/compatibility.md`](docs/compatibility.md) para a matriz completa + um guia para adicionar runtimes, e [`docs/RUNTIME_FAMILY.md`](docs/RUNTIME_FAMILY.md) para a introdução à família OpenClaw.
| Runtime / Agente | Status | Notas |
|---|---|---|
| **OpenClaw** | Nativo | Runtime de referência, detectado automaticamente |
| **PicoClaw** | Adaptador beta | JSONL plano `providers.Message` (`~/.picoclaw/workspace/sessions`). Transcrições, modelo, chamadas de ferramentas. |
| **NanoClaw** | Adaptador beta | SQLite por sessão (`data/v2-sessions`). Transcrições + contagem de mensagens. |
| **Hermes** | Adaptador beta | SQLite `~/.hermes/state.db`. Transcrições, modelo, tokens/custo. |
| **Claude Code** | Adaptador beta | JSONL `~/.claude/projects/.../.jsonl`. Transcrições, modelo, chamadas de ferramentas + raciocínio, uso de tokens. |
| **Codex** | Adaptador beta | Rollout JSONL `~/.codex/sessions/...`. Transcrições, modelo, chamadas de ferramentas, uso de tokens. |
| **Cursor** | Adaptador beta | SQLite `state.vscdb`. Transcrições de chat/composer, modelo. |
| **Aider** | Adaptador beta | `.aider.chat.history.md` por projeto. Transcrições, modelo, contagem de tokens. |
| **Goose** | Adaptador beta | SQLite `~/.local/share/goose`. Transcrições, modelo, chamadas de ferramentas, totais de tokens. |
| **opencode** | Adaptador beta | SQLite `~/.local/share/opencode`. Transcrições, modelo, chamadas de ferramentas, tokens + custo. |
| **Qwen Code** | Adaptador beta | JSONL `~/.qwen/projects/.../chats`. Transcrições, modelo, chamadas de ferramentas, uso de tokens. |
| **Pi** | Adaptador beta | JSONL `~/.pi/agent/sessions`. Transcrições, modelo, chamadas de ferramentas, tokens + custo. |
| **Deep Agents** | Adaptador beta | SQLite `~/.deepagents/.state/sessions.db`. Transcrições, modelo, chamadas de ferramentas, tokens + custo. |
| **n8n** | Adaptador beta | SQLite `~/.n8n/database.sqlite`. Execuções de workflow, execuções de nós, prompts do AI Agent, modelo + tokens onde o n8n os registra. |
"Adaptador beta" significa que o ClawMetry distribui um leitor para o formato real em disco daquele runtime, cada um construído + verificado em uma instalação real, em uma máquina real (veja `tests/fixtures/runtimes/
