Подключение Telegram-бота

Создание бота в Telegram

Для работы агента Clawmatic необходим Telegram-бот. Создать его можно за пару минут через официального бота @BotFather.

Шаг 1: Создайте бота через BotFather

1. Откройте Telegram и найдите @BotFather
2. Отправьте команду /newbot
3. Введите отображаемое имя бота (например, «ТехноМагазин Поддержка»)
4. Введите username бота — должен заканчиваться на bot (например, technomagazin_support_bot)

BotFather вернёт сообщение с токеном — строку вида 7123456789:AAF.... Сохраните её — она понадобится для подключения.

Храните токен в безопасности. Не публикуйте его в открытом доступе. Если токен скомпрометирован, отзовите его через BotFather командой /revoke.

Шаг 2: Настройте бота (опционально)

Через BotFather можно настроить дополнительные параметры:

Описание и аватар

• /setdescription — описание, которое видят пользователи при первом открытии бота
• /setabouttext — текст в разделе «О боте»
• /setuserpic — аватар бота

Команды

• /setcommands — список команд бота (например, /start, /help)

Рекомендуем добавить как минимум:

start - Начать общение
help - Получить помощь

Шаг 3: Подключите бота к Clawmatic

1. Войдите в личный кабинет
2. Перейдите в раздел «Агенты» → «Создать агента» или откройте мастер создания
3. На шаге «Telegram» вставьте токен бота и нажмите «Проверить»
4. Clawmatic проверит токен и покажет имя и username бота

Как это работает

Ваш агент запускается в изолированном контейнере и сам получает сообщения от Telegram по токену бота. Никаких webhook, серверов или дополнительных настроек с вашей стороны не требуется — достаточно действующего токена.

Шаг 4: Проверьте подключение

После подключения:

1. Откройте вашего бота в Telegram
2. Отправьте /start или любое сообщение
3. Убедитесь, что агент ответил

Если ответа нет, проверьте:

• Токен введён корректно
• Агент запущен (статус «Работает» в дашборде)
• Нет ошибок в логах агента

Смена бота

Сменить Telegram-бота у существующего агента пока нельзя: токен привязывается к агенту при создании. Если нужен другой бот — создайте нового агента с новым токеном и удалите старого. Мы работаем над возможностью менять токен без пересоздания агента.

Несколько агентов

Каждый Telegram-бот можно подключить только к одному агенту Clawmatic. Для разных задач создавайте отдельных ботов через BotFather.

Количество агентов ограничено тарифным планом. Подробнее — на странице тарифов.