Свой бот в Телеграме с нейросетью: первый за вечер

Что получишь

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

Код за тебя пишет Claude. Твоё дело нажимать кнопки, вставлять и запускать. Программировать уметь не надо.

Этот бот работает, пока включён твой компьютер. Для первого вечера так и задумано, проще способа нет.

Что нужно до старта

• Телеграм на телефоне или компьютере. Бесплатно
• Компьютер на Windows или Mac. С телефона этот путь не пройти
• Python, бесплатная программа, ставится с python.org за пять минут
• Claude (claude.ai), бесплатного тарифа хватит. Из России открывается через VPN. Подойдёт и ChatGPT, просьба та же
• GigaChat API от Сбера. Работает из России без VPN. Для физлиц есть бесплатный режим Freemium: по странице тарифов на 04.10.2026 это 365 миллионов токенов на 12 месяцев на разные модели, из них 250 миллионов на лёгкую модель Lite. Для бота, которому пишешь ты и пара знакомых, это очень много. Нужен Сбер ID для входа в личный кабинет
• Вечер. Часа два с запасом, если всё в первый раз

Шаги

Шаг 1. Заведи бота у BotFather

BotFather это официальный бот Телеграма, через него создаются все остальные боты.

1. В поиске Телеграма найди @BotFather. Проверь, что у него синяя галочка
2. Нажми «Запустить» и отправь команду /newbot
3. BotFather спросит имя. Это то, что видно в списке чатов, можно по-русски: «Помощник по рецептам»
4. Потом попросит username, адрес бота. Только латиница, и в конце обязательно bot: например recepty_mama_bot. Если занято, придумай другой
5. В ответ придёт сообщение с длинной строкой вида 1234567890:AAH.... Это ключ бота, по-английски token

Про ключ бота отдельно, прочитай обязательно

Ключ бота никому не показываешь. Ни в чате, ни на скриншоте, ни в сторис, ни помощнику «на минутку глянуть». Телеграм в своей инструкции пишет прямо: у кого есть токен, тот полностью управляет ботом. Он может от имени твоего бота писать всем, кто на него подписан, и прочитать всё, что бота спрашивают. Поэтому ключ живёт только в одном месте, в файле .env на твоём компьютере (шаг 5). В чат с Claude его тоже не вставляй, Claude он не нужен. Если ключ всё-таки утёк или ты сомневаешься, открой @BotFather, отправь /mybots, выбери бота, нажми API Token и там Revoke current token. Старый ключ перестанет работать, тебе выдадут новый. Это бесплатно и занимает минуту, так что лучше лишний раз сменить, чем гадать.

То же самое касается ключа GigaChat из следующего шага. Он привязан к твоему аккаунту и тратит твои токены.

Шаг 2. Получи ключ GigaChat

1. Зайди на developers.sber.ru, раздел GigaChat API, и войди через Сбер ID
2. Создай проект GigaChat API для физического лица
3. В проекте слева открой «Настройки API» и нажми «Получить ключ»
4. Скопируй ключ авторизации (Authorization key). Его показывают один раз, так что сразу положи в надёжное место, например в заметку на компьютере, которую никто не видит. Потом он переедет в файл .env

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

Шаг 3. Поставь Python

1. Открой python.org/downloads и скачай последнюю версию для своей системы
2. На Windows в самом первом окне установки поставь галочку Add python.exe to PATH. Без неё дальше ничего не запустится. Потом Install Now
3. Проверь: открой «Командную строку» (на Windows нажми Пуск и набери cmd) или «Терминал» на Mac, напиши и нажми Enter:

python --version

Если ответ вида Python 3.13..., всё стоит. На Mac иногда надо писать python3 вместо python, и дальше везде тоже.

Шаг 4. Попроси Claude написать бота

Открой claude.ai и вставь просьбу целиком. В квадратных скобках подставь своё.

Ты опытный разработчик. Я не программист, объясняй просто.

Напиши мне Телеграм-бота на Python, который отвечает на сообщения через GigaChat API (Сбер), я физлицо, scope GIGACHAT_API_PERS.

Что должен уметь бот:
- на /start здороваться и коротко объяснять, что он умеет
- на любое текстовое сообщение отвечать через GigaChat
- помнить последние 10 сообщений разговора с каждым человеком, чтобы понимать продолжение
- на /reset забывать разговор и начинать заново
- если GigaChat не ответил или ошибка, писать человеку «Что-то пошло не так, попробуй ещё раз» и не падать

Характер бота (системная инструкция для GigaChat):
[например: Ты помощник по домашним рецептам. Отвечаешь на «ты», коротко, по-простому. Даёшь рецепты из обычных продуктов, которые есть в любом магазине. Если спрашивают не про еду, вежливо говоришь, что умеешь только про рецепты.]

Технические требования:
- библиотека aiogram 3 для Телеграма и официальная библиотека gigachat с PyPI для GigaChat. Проверь, что синтаксис соответствует актуальным версиям этих библиотек
- ключи бери из файла .env через python-dotenv: TELEGRAM_TOKEN и GIGACHAT_CREDENTIALS. Ключей в коде быть не должно
- для GigaChat используй модель Lite
- про сертификаты НУЦ Минцифры: подскажи, как правильно подключить корневой сертификат, отключать проверку SSL не надо
- весь код в одном файле bot.py

Дай мне по порядку:
1. файл requirements.txt
2. файл bot.py целиком
3. как должен выглядеть файл .env (с пустыми местами вместо ключей)
4. команды, которые мне надо ввести, чтобы всё установить и запустить на [Windows / Mac]

Ключи в эту просьбу не вставляешь. Claude напишет код с пустыми местами, ключи ты положишь сама в шаге 5.

Шаг 5. Разложи файлы

1. Создай на рабочем столе папку mybot
2. Внутри создай три файла в обычном Блокноте (на Mac в TextEdit, режим «Простой текст»): bot.py, requirements.txt, .env. Вставь в каждый то, что дал Claude. При сохранении в Блокноте выбери «Тип файла: Все файлы», иначе получится bot.py.txt
3. В .env подставь свои ключи вместо пустых мест, вот так, без кавычек и пробелов:

TELEGRAM_TOKEN=1234567890:AAH...твой_ключ_бота
GIGACHAT_CREDENTIALS=твой_ключ_авторизации_GigaChat

4. Если Claude сказал скачать сертификат Минцифры, скачай его с Госуслуг (страница про сертификаты НУЦ) и положи туда, куда он сказал

Файл .env никому не пересылаешь, в облако не выкладываешь, в чат не скриншотишь. Если когда-нибудь будешь показывать папку с ботом кому-то, сначала убери оттуда .env.

Шаг 6. Запусти

В Командной строке или Терминале перейди в папку и запусти команды, которые дал Claude. Обычно это три строки:

cd Desktop/mybot
pip install -r requirements.txt
python bot.py

Если пишет что-то вроде «Bot started» или просто молчит без ошибок, иди в Телеграм, найди своего бота по username и нажми «Запустить». Напиши ему вопрос. Ответ должен прийти секунд через пять-десять.

Пока окно с ботом открыто, бот работает. Закрыла окно или выключила компьютер, бот уснул. Запустишь python bot.py снова, проснётся.

Шаг 7. Доведи характер

Теперь самое интересное. Поговори с ботом минут десять, как будто ты его будущий собеседник. Где ответил не так, правь системную инструкцию в bot.py (Claude подскажет, где она лежит) и перезапускай. Хорошо работают простые правила:

Отвечай не длиннее 5 предложений.
Если не знаешь ответа, так и скажи, не выдумывай.
Не обсуждай политику, медицину и деньги, говори, что с этим лучше к специалисту.
В конце ответа задавай один уточняющий вопрос, если вопрос был размытым.

Чтобы остановить бота, в окне Командной строки нажми Ctrl+C.

Где обычно ломается

python не найден. На Windows почти всегда забыта галочка Add to PATH при установке. Удали Python через «Установка и удаление программ» и поставь заново с галочкой. На Mac пробуй python3 и pip3.

Ошибка про SSL или certificate verify failed. Это сертификат Минцифры, без него GigaChat не пускает. Скопируй текст ошибки целиком в чат Claude: «Вот ошибка, я на Windows, что делать по шагам». Отключать проверку сертификатов не соглашайся, это дыра, правильный путь установить сертификат.

Unauthorized или 401. Ключ вставлен не тот или с пробелом. Для GigaChat нужен именно ключ авторизации из «Настроек API», а не что-то другое из кабинета. Для Телеграма проверь, что ключ скопирован целиком, вместе с цифрами до двоеточия.

Бот молчит, ошибок нет. Проверь, что пишешь тому самому боту, username сверь. Ещё бывает, что запущено два окна с одним ботом, тогда Телеграм ругается на конфликт. Закрой лишнее.

Файл называется bot.py.txt. Блокнот дописал расширение. В Проводнике включи «Вид», «Расширения имён файлов» и переименуй.

Что дальше

Первый бот готов, и он уже отвечает. Дальше обычно хочется, чтобы он работал круглые сутки без твоего компьютера, собирал заявки в таблицу и принимал оплату. Это всё делается тем же способом, просьбами к Claude, просто шагов больше. В мини-курсе «Свой бот в Телеграме за вечер: заявки и оплата» как раз про это: куда поселить бота, чтобы не спал, как он принимает заявки и как подключить оплату

Источники

1. https://core.telegram.org/bots/tutorial
2. https://core.telegram.org/bots
3. https://developers.sber.ru/docs/ru/gigachat/tariffs/individual-tariffs
4. https://developers.sber.ru/docs/ru/gigachat/quickstart/ind-using-api
5. https://developers.sber.ru/docs/ru/gigachat/limitations
6. https://github.com/ai-forever/gigachat
7. https://www.python.org/downloads/

Ещё уроки