> Русский 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)
**Наблюдайте за мышлением вашего агента.** Наблюдаемость в реальном времени для **14 сред выполнения AI-агентов**: [OpenClaw](https://github.com/openclaw/openclaw), [NVIDIA NemoClaw](https://github.com/NVIDIA/NemoClaw), Claude Code, OpenAI Codex и ещё 10 других. Единая панель для всего вашего флота агентов.
> 🌐 **Читайте на:** [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) · [ещё →](docs/i18n/)
Одна команда. Никакой настройки. Всё определяется автоматически.
```bash
pip install clawmetry && clawmetry
```
Откроется по адресу **http://localhost:8900** — и всё готово.
## Работает с 14 средами выполнения агентов
ClawMetry начинался как инструмент наблюдаемости для OpenClaw, а теперь измеряет **весь ваш флот агентов** на одной панели, автоматически определяя каждую среду выполнения на вашей машине:
🦞 **OpenClaw** · 🟩 **NVIDIA NemoClaw** · ◆ **Claude Code** · ⬡ **OpenAI Codex** · **Cursor** · 🪿 **Goose** · ⚡ **Hermes** · **opencode** · ◈ **Qwen Code** · **Aider** · **NanoClaw** · **PicoClaw** · **Pi** · **Deep Agents** · 🔗 **n8n**
OpenClaw и NemoClaw бесплатны в open-source приложении; остальные среды выполнения включаются с ClawMetry Cloud или лицензией Pro для самостоятельного хостинга. Переключайте среды выполнения из шапки, и каждая вкладка — стоимость, токены, инструменты, трассировки — пересчитывается для выбранной среды. Смотрите **[docs/ENTITLEMENTS.md](docs/ENTITLEMENTS.md)** для точного разделения на бесплатное/платное, матрицы уровней, формата `/api/entitlement` и CLI `clawmetry license`.
## Что вы получаете
- **Flow** — живая анимированная диаграмма, показывающая, как сообщения проходят через каналы, "мозг", инструменты и обратно
- **Overview** — проверки состояния, тепловая карта активности, счётчики сессий, информация о модели
- **Usage** — отслеживание токенов и стоимости с разбивкой по дням/неделям/месяцам
- **Sessions** — активные сессии агента с моделью, токенами, временем последней активности
- **Crons** — запланированные задачи со статусом, временем следующего запуска, длительностью
- **Logs** — цветная потоковая трансляция логов в реальном времени
- **Memory** — просмотр SOUL.md, MEMORY.md, AGENTS.md, ежедневных заметок
- **Transcripts** — интерфейс в виде чата для чтения истории сессий
- **Alerts** — лимиты бюджета, триггеры по частоте ошибок, обнаружение отключения агента; отправка в Slack, Discord, PagerDuty, Telegram, Email
- **Approvals** — блокировка деструктивных удалений, force push, изменений в БД, sudo, установок пакетов, сетевых вызовов до получения одобрения в один клик
## Скриншоты
### 🧠 Brain — живой поток событий агента
### 📊 Overview — использование токенов и сводка по сессиям
### ⚡ Flow — лента вызовов инструментов в реальном времени
### 💰 Tokens — разбивка стоимости по моделям и сессиям
### 🧬 Memory — браузер файлов рабочего пространства
### 🔐 Security — состояние защищённости и журнал аудита
### 🚨 Alerts — лимиты бюджета, триггеры по частоте ошибок, вебхуки в Slack / Discord / PagerDuty / Email
### ✋ Approvals — блокировка рискованных вызовов инструментов до ручного одобрения; правила защиты на основе политик
**Блокировка перед выполнением для Claude Code** — одна команда устанавливает
хук PreToolUse, который приостанавливает подходящие вызовы инструментов *до* их выполнения и ждёт
вашего решения (одно касание с телефона при включённых
[push-уведомлениях облака](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
```
Отказ блокирует только этот один вызов инструмента — агент сохраняет свою сессию и может
попробовать другой подход. Одобрение с телефона пропускает собственный запрос на разрешение
Claude Code (вы уже ответили). Несовпавшие инструменты стоят ~40 мс и
попадают в обычный процесс разрешений Claude Code. Вы также получите push-уведомление на телефон, когда
сам Claude Code ждёт вашего ответа (уведомления `permission_prompt` /
`idle_prompt`).
## Установка
**Однострочная команда (рекомендуется):**
```bash
curl -sSL https://raw.githubusercontent.com/vivekchand/clawmetry/main/install.sh | bash
```
**pip:**
```bash
pip install clawmetry
clawmetry
```
**Из исходного кода:**
```bash
git clone https://github.com/vivekchand/clawmetry.git
cd clawmetry && pip install flask && python3 dashboard.py
```
## Разработка фронтенда v2
Приложение React v2 находится в `frontend/` и раздаётся по пути `/v2`, когда сервер
Flask запущен с включённым v2.
Используйте два терминала во время разработки:
```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
```
Откройте `http://localhost:5173/v2/`. Vite проксирует запросы `/api` на
`http://localhost:8900`, поэтому приложение React может общаться с локальным сервером Flask
без дополнительной настройки CORS.
Чтобы собрать сборку, которая поставляется вместе с Python-пакетом:
```bash
cd frontend
npm run build
```
Продакшн-сборка записывается в `clawmetry/static/v2/dist/`.
## Совместимость со средами выполнения / агентами
ClawMetry наблюдает за многими средами выполнения AI-агентов, а не только за OpenClaw. Каждая среда выполнения, отличная от OpenClaw, поставляется с выделенным адаптером-ридером, который переводит её нативный формат сессий в унифицированные форматы ClawMetry; демон загружает их в то же хранилище DuckDB + облачный снимок, помечая среду выполнения, а вкладка воспроизведения сессий показывает **переключатель сред выполнения**, если присутствует больше одной. Смотрите [`docs/compatibility.md`](docs/compatibility.md) для полной матрицы и руководства по добавлению сред выполнения, а также [`docs/RUNTIME_FAMILY.md`](docs/RUNTIME_FAMILY.md) для введения в семейство OpenClaw.
| Среда выполнения / агент | Статус | Примечания |
|---|---|---|
| **OpenClaw** | Нативная | Эталонная среда выполнения, определяется автоматически |
| **PicoClaw** | Бета-адаптер | Плоский JSONL `providers.Message` (`~/.picoclaw/workspace/sessions`). Транскрипты, модель, вызовы инструментов. |
| **NanoClaw** | Бета-адаптер | SQLite на сессию (`data/v2-sessions`). Транскрипты + количество сообщений. |
| **Hermes** | Бета-адаптер | SQLite `~/.hermes/state.db`. Транскрипты, модель, токены/стоимость. |
| **Claude Code** | Бета-адаптер | JSONL `~/.claude/projects/.../.jsonl`. Транскрипты, модель, вызовы инструментов + мышление, использование токенов. |
| **Codex** | Бета-адаптер | Rollout JSONL `~/.codex/sessions/...`. Транскрипты, модель, вызовы инструментов, использование токенов. |
| **Cursor** | Бета-адаптер | SQLite `state.vscdb`. Транскрипты чата/composer, модель. |
| **Aider** | Бета-адаптер | `.aider.chat.history.md` на проект. Транскрипты, модель, счётчики токенов. |
| **Goose** | Бета-адаптер | SQLite `~/.local/share/goose`. Транскрипты, модель, вызовы инструментов, суммарные токены. |
| **opencode** | Бета-адаптер | SQLite `~/.local/share/opencode`. Транскрипты, модель, вызовы инструментов, токены + стоимость. |
| **Qwen Code** | Бета-адаптер | JSONL `~/.qwen/projects/.../chats`. Транскрипты, модель, вызовы инструментов, использование токенов. |
| **Pi** | Бета-адаптер | JSONL `~/.pi/agent/sessions`. Транскрипты, модель, вызовы инструментов, токены + стоимость. |
| **Deep Agents** | Бета-адаптер | SQLite `~/.deepagents/.state/sessions.db`. Транскрипты, модель, вызовы инструментов, токены + стоимость. |
| **n8n** | Бета-адаптер | SQLite `~/.n8n/database.sqlite`. Выполнения workflow, запуски узлов, промпты AI Agent, модель + токены там, где n8n их фиксирует. |
"Бета-адаптер" означает, что ClawMetry поставляет ридер для реального формата данных этой среды выполнения на диске, каждый из которых собран и проверен на реальной установке на реальной машине (см. `tests/fixtures/runtimes/
