Личный ИИ ассистент аналитик: как подружить OpenClaw и Umami / Хабр

Просмотр аналитики и поведения пользователей — это важный аспект, который позволит улучшить сайт, что может увеличить выручку. Один из вариантов, собирать обратную связь (далее — ОС) от пользователей напрямую, но лишь малый процент пользователей даёт ОС, даже если это простейшая кнопка с оценкой или кнопка вида «Плохо/Хорошо». По аналитике и поведению можно примерно понять, что пользователям неудобно, сколько времени они проводят на сайте, в определённом разделе. Откуда чаще всего уходят, что нажимают и самое главное — можно проводить A/B исследования, как увеличить продажи и выручку, меняя разделы, элементы, тексты и упрощая пользователю взаимодействие с сайтом. Кроме того, можно выявить аномалии в поведении на раннем этапе (разведку от конкурентов, ботов, абьюзеров и прочих лиц, которые не намерены совершить покупку или другое целевое действие).

Постановка проблемы

На первых порах, когда общее кол‑во пользователей менее 10–100, важно собирать как можно больше анонимной аналитики: глубина скролла, на какие кнопки нажимает, куда переходит, когда уходит или делает целевое действие. Когда у вас копится достаточно большое кол‑во сайтов, просмотр действий становится рутиной. Можно упустить ключевые детали, ключевые сессии или события, можно банально забыть провести аналитику, позже утонув в море скопившихся событий.

Вашему вниманию предлагается одно из решений данной проблемы: ИИ ассистент на базе OpenClaw, который будет подключаться к Umami, анализировать события, сессии, устройства, и гео, отвечать на вопросы и выполнять сложные аналитические запросы, требующие комплексного анализа нескольких сессий с разными событиями. Без единой строчки кода.

Описание инструментов

OpenClaw — это гибкий open‑source фреймворк для создания автономных ИИ‑агентов, ориентированный на локальное управление и кастомизацию под конкретные бизнес‑задачи. OpenClaw поддерживает концепцию Tool Use (вызов функций), что позволяет подключать к языковой модели внешние инструменты, базы данных и сторонние API. Агент может читать файлы конфигурации, выполнять HTTP‑запросы, обрабатывать структурированные данные и сохранять контекст диалога.

Umami — это современная, быстрая и ориентированная на конфиденциальность альтернатива Google Analytics и Yandex Metrika с открытым исходным кодом. Она позволяет собирать детальную статистику посещаемости сайта, включая просмотры страниц, поведение пользователей, типы устройств и географию, анонимно и без использования cookie. Одно из преимуществ Umami для разработчиков — наличие полноценного и документированного REST API, которое позволяет управлять платформой и выгружать любые метрики программным путем.

Подготовка инструментов

В текущем руководстве используется Umami v3.1.0 и OpenClaw v2026.5.7. Перед тем как переходить к настройке интеграции, убедитесь, что у вас подготовлены следующие компоненты:

Развернутая копия Self‑hosted Umami — сервис может быть установлен на вашем сервере (например, через Docker) и обновлен до версии v3.1.0 или выше.
OpenClaw версии v2026.5.7 или выше должен быть настроен и запущен.
Подключенный веб‑сайт. Целевой сайт уже должен быть добавлен в панель Umami, а на самом ресурсе должен быть установлен скрипт отслеживания, который уже собирает первые анонимные события и сессии пользователей.

Общая схема и принцип работы

Наглядная пошаговая иллюстрация от GPT Image

Интеграция строится на взаимодействии трех компонентов: веб‑сайта, self‑hosted панели Umami и OpenClaw. Процесс обмена данными и логика работы выглядят следующим образом:

1) Подготовка инфраструктуры и прав доступа в Umami

В панели аналитики Umami сначала регистрируется новый пользователь (выделенный аккаунт для агента), которому даётся роль Read Only (или View Only). Затем создается отдельная команда (Team), в которую добавляются целевой сайт и созданный пользователь‑агент. Это изолирует ИИ от других ваших проектов и защищает данные от случайного удаления, модификации и неавторизованного доступа к другим сайтам.

2) Контекстное обучение агента работе с API в OpenClaw

В конфигурационный файл tools.md OpenClaw добавляется подробное описание нового инструмента (Tool). Этот файл служит инструкцией для языковой модели. В нем прописываются URL‑адрес панели Umami, учетные данные созданного пользователя, ID команд и сайтов, а также эндпоинты REST API с правилами формирования запросов. Таким образом, OpenClaw «узнает», куда обращаться и какие параметры передавать для получения аналитики.

3) Авторизация и получение токена доступа

Взаимодействие между системами происходит по REST API. При инициализации или первом запросе ИИ‑агент отправляет POST‑запрос на эндпоинт авторизации Umami, передавая имя пользователя и пароль. В ответ Umami генерирует временный JWT‑токен. Все последующие запросы к аналитике агент выполняет, прикрепляя этот токен в заголовок Authorization: Bearer <token>.

4) Обработка пользовательского запроса

Когда вы отправляете текстовый запрос ассистенту (например, через Telegram‑бот или веб‑интерфейс OpenClaw), языковая модель анализирует ваш запрос. Понимая, что запрос касается аналитики, ИИ обращается к инструкции в tools.md, выбирает нужный эндпоинт Umami API, подставляет актуальные ID сайтов, забирает сырые JSON‑данные из аналитики, обрабатывает их и выдает вам готовый структурированный ответ на понятном языке.

Пошаговое руководство

1) Создаём нового пользователя в Umami

От имени этого пользователя OpenClaw будет входить на сайт.

admin → admin → Users → “Create User”

Скрытый текст

Шаг 1 - создаём нового юзера — Шаг 1 — создаём нового юзера

Устанавливаем сложный пароль, устойчивый к брутфорс атаке, задаём username. В поле «Роль/Role» я настоятельно рекомендую выбирать View Only. Так ваш ассистент не удалит случайно сайт и не натворит других ещё более плохих дел. В моём случае его username: SASаsistant
Должен отметить, что ваш web‑сервер, который проксирует запросы к umami, должен быть устойчив к брутфорс атаке, блокируя IP адрес при слишком частых запросах.

2) Создаём новую команду (Team) в Umami и добавляем в неё ассистента

В Umami команды объединяют пользователей для работы с определёнными сайтами.

Teams → «Create team». В качестве владельца команды я выбираю admin.

Скрытый текст

Шаг 2 - создание команды — Шаг 2 — создание команды

Теперь нужно добавить ассистента в команду, а также запомнить id команды (team):

Скрытый текст

Выбираем нашего ассистента, указывая роль View Only

Скрытый текст

3) Добавим сайт в команду

3.1) Если сайт ещё не был создан, нужно его создать в команде:

Скрытый текст

3.2) Если сайт уже создан, нужно перенести его в новую команду

Перейти в настройки сайта:

Скрытый текст

Найти секцию «Transfer website» внизу страницы настроек:

И выбрать новую команду:

4) Подготовить OpenClaw

Теперь в OpenClaw нужно добавить новый TOOLS. Это можно сделать через UI:

Agents → Files → TOOLS

Скрытый текст

Добавляем новым абзацем описание новой функции:

...Предыдущий текст из файл TOOLS.md

### Umami Analytics (analytics.domain.com)

**Сайт:** https://analytics.domain.com
**Тип:** Self-hosted Umami

**Учётные данные пользователя-агента:**
- Username: `SASаsistant`
- Password: `strongLongPassword`
- Роль: view-only

**Подключение через API:**
1. POST `/api/auth/login` с `username` + `password` → получить `token`
2. Все запросы с заголовком `Authorization: Bearer <token>`

**Команды (teams):**
1. **Team_1** — ID: `team-1-id`
2. **Team_2** — ID: `team-2-id`
3. **InsAider AI Team** — ID: `team-3-id`
...
N. **Team_N** — ID: `team-N-id`   

**Сайты — получать через** `GET /api/teams/{teamId}/websites`:

**InsAider AI**
- ID: `site-id`
- Домен: site.domain.com
- Команда: InsAider AI Team
... 
**Site N** (Другой сайт)
- ID: `site-N-id`
- Домен: site.N.com
- Команда: N Team или другая


**Основные API-запросы:**
- GET `/api/websites/{id}/active` — онлайн сейчас
- GET `/api/websites/{id}/stats?startAt={ms}&endAt={ms}` — общая статистика
- GET `/api/websites/{id}/pageviews?startAt={ms}&endAt={ms}&unit=day&tz=Europe/Moscow` — просмотры/сессии по дням
- GET `/api/websites/{id}/metrics?startAt={ms}&endAt={ms}&type={"source"|"url"|"browser"|"os"|"device"|"country"|"event"}` — метрики
- GET `/api/websites/{id}/events?startAt={ms}&endAt={ms}` — события

**Важно:** Токен живёт, пока активна сессия. При переподключении делать новый login.

...Следующий текст из файл TOOLS.md

Затем не забыть сохранить новый текст через UI OpenClaw.

П.4 можно не делать вручную, а попросить агента подключиться к Umami, найти сайт и записать алгоритм работы в TOOLS.md. Агент сам разберётся как подключиться и запросит информацию, если чего‑то не хватит. На это уйдёт чуть больше токенов.

5) Проверяем работу. Например, в телеграмм боте ассистента:

Скрытый текст

Что дальше?

Далее, через ассистента можно настроить ежедневную аналитику, поиск узких мест и мест отказов. Автоматизируйте рутину с помощью Cron‑задач в OpenClaw или регулярных промптов в Telegram‑боте.

Агент может каждое утро собирать аналитику за прошедшие 24 часа, анализировать страницы с самым высоким показателем отказов и присылать структурированный отчет.
Ежемесячную статистику. Ассистент сравнит показатели текущего месяца с предыдущим, выявит долгосрочные тренды, подсветит изменения в поведении. Вместо ручного анализа из Umami вы получаете краткое содержание с выводами, какие каналы принесли наиболее вовлеченную аудиторию.
Однократные вопросы, сводки с графиками. Используйте возможности LLM для быстрых запросов в режиме реального времени. Вы можете спросить у бота: «Сколько% человек дошло до оплаты за сегодня? На каком этапе больше всего ушли?».

Посмотрите реальный пример ежедневного отчёта на боевом сайте с реальными пользователями и выручкой (данные анонимизированы). OpenClaw ассистент создал CRON, по которому каждый день заходит и смотрит аналитику.

Скрытый текст

📊 Ежедневная сводка аналитики — 27 мая (ср)

FirstSite
👥 Посетители: 106 | 👁 Просмотры: 317 | 🔄 Визиты: 109
📉 Отказы: 78 (71.6%)
⏱️ Среднее время: ~1 мин 22 сек
📊 Сравнение: просмотры −17%, посетители +13%, время на сайте −35%

Популярные страницы: FirstPage (214 эвентов — 47% трафика), SecondPage (27), ThirdPage (16)

Вовлечённость: User Presence 109+34, доскроллили до 100% — лишь 2 чел., Cookie accepted 9, написали — 1

Аномалии: пик 48 просмотров в 12:00 MSK (обычно 15–25); странные эвенты tc23822245 ×3, ShowTost: Доступ запрещён — похоже на ошибку валидации

Ушли ничего не сделав: 78 отказов (71.6%)
Выводы: Трафик растёт, но люди не переходят между . Критически нужны рекомендации похожих .

—

*** SecondSite
👥 Посетители: 69 | 👁 Просмотры: 274 | 🔄 Визиты: 85
📉 Отказы: 38 (44.7%)
⏱️ Среднее время: ~4 мин 21 сек 🎉
📊 Сравнение: просмотры +16%, время на сайте +41% — супер

💳 Воронка оплаты:
Показана кнопка — 29
Нажали Pay — 8 (27.6% конверсии)
Выбрали метод — 8
Открыли подтверждение — 15 раз (7 осн. + 8 с секции)
Закрыли без оплаты — 4

Странные эвенты: submit ×2, toHero ×2 (возврат к началу), Already ×4, клики по рекламе 7, User load ×2

Ушли ничего не сделав: 38 отказов (44.7%)

—

Выводы и рекомендации:

FirstSite — критический bounce rate 71.6%. Нужна система рекомендаций похожих ***, сокращение времени загрузки и улучшенные превью на главной.
SecondSite — отличная вовлечённость (4+ мин!), работает хорошо. Проблема: из 29 показов кнопки оплаты — 8 кликов (27.6%). Из 15 открытий подтверждения — 4 закрыли без оплаты. Стоит поработать над UX платёжной формы и ценностным предложением.
🔍 Яндекс — главный источник для обоих проектов.
📱 Мобайл + Android доминируют — проверьте, что мобильный UX в порядке.

Вместо выводов: это не идеальный способ подружить Umami и OpenClaw, это самый простой и быстрый способ, не требующий написания кода и конфигов, занимающий несколько минут.

Если это будет интересно, можно продолжить цикл статей на эту тему. По подобной схеме через отдельного пользователя можно «обучить» OpenClaw агента работать с:

Self hosted glitchtip сервисом логирования ошибок (бесплатным аналогом sentry)
Базой данных PostgreSQL в PGAdmin интерфейсе
Apatche Airflow пайплайнами