Диагностика проблем
Если что-то пошло не так — не паникуйте. Большинство проблем решаются за несколько минут. Ниже собраны самые частые ситуации и пошаговые инструкции по их устранению.
Агент не отвечает в Telegram
Симптомы: вы отправляете сообщение боту, но ответа нет.
Возможные причины и решения:
- Агент остановлен. Откройте личный кабинет → Агенты → проверьте статус. Если статус «Остановлен», нажмите «Запустить».
- Неверный токен бота. Убедитесь, что токен в настройках агента совпадает с токеном из BotFather. Если вы перевыпускали токен — обновите его в настройках.
- Вебхук не настроен. Перейдите в настройки агента → Telegram → нажмите «Переустановить вебхук».
- Превышен лимит токенов. Если вы на бесплатном тарифе и исчерпали месячный лимит, агент перестаёт обрабатывать запросы до начала нового периода.
Ошибки при подключении Telegram-бота
Симптомы: ошибка при сохранении токена бота или установке вебхука.
Решения:
- «Invalid bot token» — токен введён неправильно. Скопируйте его из BotFather заново, убедитесь, что нет лишних пробелов.
- «Webhook URL is not HTTPS» — платформа автоматически использует HTTPS. Если ошибка возникает, обратитесь в поддержку.
- «Bot is already in use» — этот бот уже привязан к другому агенту. Один бот = один агент. Создайте нового бота через BotFather.
Проблемы с хранилищем данных
Симптомы: агент не может создать таблицу или записать данные.
Решения:
- Превышен лимит таблиц. На бесплатном тарифе доступно 3 таблицы. Удалите ненужные или перейдите на Pro.
- Превышен объём данных. Проверьте использование хранилища в личном кабинете → Агент → Использование. Очистите устаревшие данные или увеличьте лимит.
- Ошибка SQL-запроса. Агент автоматически генерирует запросы, но иногда структура данных может вызывать конфликты. Попробуйте переформулировать задачу для агента.
Проблемы с оплатой
Симптомы: платёж не проходит или подписка не активируется.
Решения:
- Платёж отклонён банком. Попробуйте другую карту или используйте СБП (Систему быстрых платежей).
- Подписка не активировалась. Подождите до 5 минут — обработка платежа через YuKassa может занять некоторое время. Если не помогло — обратитесь в поддержку с номером транзакции.
- Двойное списание. Проверьте историю платежей в личном кабинете → Биллинг. Если видите дубль — обратитесь в поддержку, мы вернём средства.
Агент даёт неточные ответы
Симптомы: агент отвечает невпопад, путает факты или игнорирует контекст.
Решения:
- Обновите SOUL.md. Ваш промпт — основа поведения агента. Добавьте конкретные инструкции, примеры диалогов и ограничения.
- Уточните контекст. Если агент работает с каталогом товаров — убедитесь, что данные в хранилище актуальны.
- Переключите модель. В настройках агента можно выбрать более мощную LLM-модель (доступно на Pro и Business тарифах).
Медленная работа агента
Симптомы: агент отвечает с задержкой более 10 секунд.
Возможные причины:
- Нагрузка на LLM-провайдера. В пиковые часы ответы могут занимать больше времени. Это временное явление.
- Большой контекст диалога. Длинные диалоги увеличивают время обработки. Агент автоматически управляет контекстом, но для снижения задержки можно начать новый диалог.
- Тяжёлые операции с хранилищем. Если агент выполняет сложные запросы к большим таблицам, это может занять время.
Проблемы с авторизацией
Симптомы: не удаётся войти в личный кабинет.
Решения:
- Magic link не приходит. Проверьте папку «Спам». Убедитесь, что email введён правильно. Запросите ссылку повторно через 2 минуты.
- Telegram Login не работает. Убедитесь, что вы используете тот же Telegram-аккаунт, который был привязан при регистрации.
- Сессия истекла. Войдите заново — сессии действительны 30 дней.
Как обратиться в поддержку
Если проблема не решается с помощью этого руководства:
- Опишите проблему максимально подробно
- Укажите идентификатор агента (виден в личном кабинете)
- Приложите скриншоты, если возможно
- Напишите на support@clawmatic.ru
Мы отвечаем в течение 24 часов в рабочие дни.