Как собрать AI-бота-квалификатора в Telegram через OpenClaw

Что мы собираем

Роль агента можно описать одним предложением:

AI‑квалификатор встречает входящий лид в Telegram, выясняет задачу и стадию готовности, даёт короткое предметное объяснение, сохраняет результат и предлагает один логичный следующий шаг.

У него пять рабочих состояний:

1. Новый диалог.
2. Уточнение задачи.
3. Квалификация.
4. Рекомендация.
5. Передача человеку или в CRM.

Это важнее модели. Если состояния не описаны, даже сильный AI будет каждый раз вести разговор по-разному.

Шаг 1. Опишите бизнес-контракт до установки

Не начинайте с фразы «хочу умного бота». Заполните семь строк:

• кто пишет боту;
• с какой типовой проблемой;
• какие вопросы обязательны;
• что считается квалифицированным лидом;
• какие продукты можно рекомендовать;
• в какой момент подключается человек;
• что боту запрещено.

Для нашего примера обязательные вопросы такие:

1. Чем занимается бизнес?
2. Что сейчас не работает: заявки, продажи, повторные покупки или процессы?
3. Есть ли действующие цифры и CRM?
4. Какой результат нужен в ближайшие один-три месяца?
5. Собственник готов внедрять сам или нужна помощь команды?

Запреты тоже должны быть написаны человеческим языком: не обещать рост выручки, не выдавать полную стратегию бесплатно, не менять цены, не публиковать данные клиента и не притворяться Светланой.

Шаг 2. Установите OpenClaw и поднимите Gateway

По актуальной официальной инструкции OpenClaw ставится установщиком для вашей системы, затем запускается мастер настройки:

openclaw onboard --install-daemon
openclaw gateway status
openclaw dashboard

Установщик проверяет Node.js и помогает выбрать модель. Требования к версиям меняются, поэтому перед установкой сверяйте страницу Install, а не копируйте старую команду из случайного ролика.

Gateway работает как узел между моделью, Telegram, памятью и инструментами. Если он остановлен, Telegram‑бот может быть виден пользователю, но агент отвечать не будет.

Шаг 3. Создайте Telegram‑бота

В Telegram откройте именно @BotFather и выполните /newbot. Задайте имя, username и получите токен.

Токен служит паролем от бота. Его нельзя вставлять в статью, пересылать подрядчику в общем чате или хранить в публичном репозитории. Используйте переменную окружения или защищённое хранилище OpenClaw.

Для публичного квалификатора понадобятся открытые личные сообщения. Для личного помощника безопаснее pairing или список разрешённых Telegram ID. Официальная документация OpenClaw отдельно предупреждает: режим open с allowFrom: ["*"] подходит только намеренно публичным ботам с жёстко ограниченными инструментами.

Шаг 4. Подключите Telegram к OpenClaw

Минимальная логика конфигурации выглядит так:

{
  channels: {
    telegram: {
      enabled: true,
      dmPolicy: "open",
      allowFrom: ["*"]
    }
  }
}

Сам токен передаётся отдельно через TELEGRAM_BOT_TOKEN. После изменения конфигурации проверьте:

openclaw doctor
openclaw gateway status
openclaw logs --follow

Если вы делаете закрытого внутреннего помощника, оставьте pairing и подтвердите свой Telegram ID:

openclaw pairing list telegram
openclaw pairing approve telegram <CODE>

Подробная схема и актуальные параметры находятся в официальном разделе Telegram.

Шаг 5. Соберите рабочее пространство агента

OpenClaw хранит инструкции агента в отдельном workspace. При первичной настройке появляются AGENTS.md, SOUL.md, IDENTITY.md и USER.md.

Для квалификатора достаточно разделить информацию на четыре слоя:

• AGENTS.md: алгоритм разговора, запреты и правила передачи;
• IDENTITY.md: кто агент и как он представляется;
• USER.md: для кого работает и что важно собственнику;
• products.md: продукты, кому подходят, ограничения, цена и следующий шаг.

Секреты в workspace не кладут. Официальная документация прямо отделяет рабочие файлы от конфигурации, credentials и сессий в ~/.openclaw/.

Шаг 6. Напишите инструкцию квалификатора

Рабочая инструкция должна задавать порядок действий, а не рисовать характер:

Ты работаешь Telegram-квалификатором маркетингового бюро.

Цель: понять задачу собственника, дать короткий полезный разбор и предложить один следующий шаг.

Порядок:
1. Поздоровайся и спроси, чем занимается бизнес.
2. Выясни одну главную проблему.
3. Задавай по одному вопросу за сообщение.
4. После 5-7 ответов верни резюме: проблема, вероятная причина, чего не хватает.
5. Рекомендуй только продукт, который соответствует ответам.
6. Если данных мало, скажи, чего не хватает.
7. Если вопрос юридический, финансовый или требует обещания результата, передай человеку.

Запрещено:
- придумывать кейсы, цены и гарантии;
- выдавать полную стратегию;
- обещать рост продаж;
- давить срочностью;
- изображать живого сотрудника;
- выполнять внешние действия без разрешения.

Фраза «задавай по одному вопросу» кажется мелочью. На телефоне это разница между диалогом и анкетой из налоговой.

Шаг 7. Добавьте знания о продуктах

Плохая карточка продукта:

«Точка прорыва»: уникальная авторская программа трансформации бизнеса.

Хорошая:

product: Точка прорыва
for_whom: собственник действующего бизнеса с цифрами
problem: продажи остановились, непонятно где течёт воронка
result: диагностика и план первого рабочего рычага
not_for: бизнес с нуля, запрос на волшебную кнопку
next_step: передать заявку Светлане

Агенту нужны критерии выбора, а не рекламные прилагательные. Тогда он объясняет, почему предлагает продукт, и умеет честно сказать «это вам пока не подходит».

Шаг 8. Подключите CRM без раздачи ключей от сейфа

Минимальная запись лида:

• Telegram ID;
• username;
• источник;
• ниша;
• главная проблема;
• стадия готовности;
• рекомендованный продукт;
• краткое резюме диалога;
• время передачи человеку.

На первом этапе можно писать данные в защищённую таблицу или внутренний API. Не давайте публичному боту shell, доступ ко всем файлам сервера и право менять CRM. OpenClaw позволяет ограничивать навыки и инструменты конкретного агента. Это надо делать до запуска трафика.

Шаг 9. Проверьте восемь сценариев

Не тестируйте только вежливого клиента с идеальными ответами.

1. Человек пишет «сколько стоит?» без контекста.
2. Отказывается отвечать на вопросы.
3. Просит гарантировать продажи.
4. Присылает голосовое.
5. Пишет персональные или платёжные данные.
6. Просит удалить информацию.
7. Возвращается через неделю.
8. Подходит сразу под два продукта.

Для каждого сценария заранее определите правильный результат. Агент должен уметь не только отвечать, но и останавливаться.

Что уже умеет @AiKozyrinasbot

По фактическому коду бот Бюро «УМ» уже закрывает значительную часть роли квалификатора:

• принимает текст и голосовые сообщения;
• проводит AI‑диагностику процессов;
• ведёт отдельную квалификацию на стратегическую консультацию;
• запускает чек‑лист «Где течёт ведро»;
• сохраняет сырой лид и события в CRM;
• рекомендует «Точку прорыва» или «Козырную движуху»;
• передаёт результат Светлане;
• ограничивает бесплатную выдачу полной стратегии.

Это не чистый OpenClaw‑бот: текущая версия собрана отдельным Python‑контуром. Но бизнес‑архитектура та же: состояния, память, вопросы, рекомендации и человеческий шлюз.

Что стоит усилить перед тем, как использовать его как эталон:

1. Зафиксировать единую таблицу критериев квалификации по продуктам.
2. Добавить явное согласие перед сохранением лида.
3. Показывать пользователю короткое резюме его ответов до передачи.
4. Разделить «полезное объяснение» и «продажную рекомендацию».
5. Завести тесты на устаревшие цены, ссылки и даты.
6. Проверять весь путь после каждого обновления: старт → вопросы → CRM → рекомендация → человек.

Где чаще всего ломается такой агент

Первая ошибка: бот задаёт много вопросов и ничего не отдаёт взамен. Человек чувствует, что его допрашивают ради CRM.

Вторая ошибка: каждому предлагается самый дорогой продукт. Получается электронный менеджер с планом продаж вместо квалификатора.

Третья ошибка: знания обновили в одном файле, а старое сообщение осталось в другом. Пользователь получает разные даты, цены или условия. После истории с восьмым СХОДом мы знаем цену такой мелочи: автоматизация размножает ошибку быстрее человека.

Четвёртая ошибка: бот не умеет передавать диалог. Светлана получает имя и телефон, но заново выясняет всё, что человек уже рассказал машине.

Критерий готовности

Квалификатор готов не тогда, когда красиво отвечает. Он готов, когда:

• десять тестовых диалогов проходят повторяемо;
• данные доходят до CRM без дублей;
• рекомендация объяснима ответами человека;
• неизвестные факты не выдумываются;
• цены, даты и ссылки берутся из одного актуального источника;
• сложный лид передаётся человеку вместе с резюме;
• публикация, деньги и обещания остаются за человеком.

Начинайте с одного маршрута и одного продукта. Когда он стабильно работает, добавляйте второй. Иначе вместо AI‑воронки получите очень разговорчивый склад ошибок.

Источники

• OpenClaw: Getting Started
• OpenClaw: Install
• OpenClaw: Telegram
• OpenClaw: Agent workspace
• OpenClaw: Skills and tool boundaries

Следующий шаг

Если вы понимаете, что бот нужен, но не знаете, какой процесс ему отдавать, начинать с установки рано. Сначала найдите одну дорогую повторяющуюся дыру в воронке. На «Точке прорыва» мы разбираем процесс, цифры и первый AI‑контур без обещаний кнопки «бабло».