Запуск Telegram-бота

Вы создадите своего бота и запустите его на компьютере. Для ответов программа обращается к сервису DeepSeek через API — программное подключение к модели.

Сначала проверьте ответ на своём компьютере. Если бот должен оставаться доступным после выключения компьютера, перейдите к разделу «Работа 24/7 на VPS». VPN настраивайте отдельно, если для исходящих подключений нужен VPN-маршрут.

1. Создайте бота в Telegram

  1. Откройте официальный @BotFather.
  2. Отправьте команду:
/newbot

Команда /newbot в диалоге с BotFather

Скриншот из руководства Timeweb Cloud. Кадр сделан до получения токена.

  1. Введите название бота, которое увидят пользователи.
  2. Задайте уникальное имя пользователя — username — латиницей, без пробелов, с окончанием bot. Если имя занято, выберите другое.
  3. BotFather выдаст токен — секретный ключ управления ботом. Сохраните его отдельно в защищённом месте, например в менеджере паролей. Порядок создания и правила хранения токена — Telegram.

2. Получите ключ DeepSeek

  1. Откройте официальный кабинет DeepSeek: API keys и войдите в аккаунт.
  2. Создайте API-ключ и сохраните его отдельно в защищённом месте.
  3. Проверьте баланс кабинета. До первого запроса может потребоваться пополнение. Доступ к обычному чату DeepSeek и доступ программы через API проверяются отдельно. Наличие чата само по себе не подтверждает готовность API.

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

Токен Telegram и ключ DeepSeek вводите только в запросы программы в терминале. Не вставляйте их в чат с ИИ, переписку, скриншоты или файлы с инструкциями. Если ключ раскрыт, отзовите его в соответствующем кабинете и создайте новый.

3. Подготовьте программу

  1. Установите Python версии 3.10 или новее с официального сайта Python, если он ещё не установлен. Для новой установки выберите актуальную стабильную версию.
  2. Файлы бота уже находятся в скачанном архиве.
  3. Полностью распакуйте архив. В Windows нажмите на архив правой кнопкой и выберите «Извлечь всё». На macOS откройте архив двойным щелчком.
  4. Откройте распакованную папку и найдите bot.py. Команды ниже нужно выполнять именно из этой папки. Устанавливать дополнительные пакеты не требуется.

4. Откройте терминал и проверьте Python

Windows

В Проводнике откройте папку с bot.py. Нажмите на адресную строку, введите powershell и нажмите Enter. В открывшемся окне выполните:

py -3 --version

Если команда py не найдена, выполните:

python --version

В ответе нужна версия Python 3.10 или новее. Если команда не найдена, открывается магазин приложений или версия ниже, установите подходящий Python и заново откройте терминал.

macOS

Откройте приложение «Терминал». Введите cd и пробел, перетащите из Finder папку с bot.py в окно терминала и нажмите Enter. Затем выполните:

python3 --version

В ответе нужна версия Python 3.10 или новее. Если её нет, установите Python с официального сайта и заново откройте терминал.

5. Запустите программу

В Windows выполните:

py -3 bot.py

Если py отсутствует, а проверка python --version прошла:

python bot.py

На macOS выполните:

python3 bot.py

Программа по очереди попросит токен Telegram и API-ключ DeepSeek. Вставьте каждый ключ в соответствующий запрос и нажмите Enter. Ввод скрыт: буквы и даже звёздочки могут не появляться. Это ожидаемое поведение.

Программа не сохраняет введённые ключи на диск. После проверки Telegram в терминале появится строка «Бот запущен» со ссылкой вида https://t.me/имя_вашего_бота. Откройте показанную ссылку. Оставьте терминал открытым и компьютер подключённым к интернету.

6. Проверьте ответ

Откройте личный чат с ботом. Нажмите «Начать» или отправьте:

/start

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

Здравствуйте! Можно сегодня заменить молнию на куртке? И сколько это стоит?

Проверьте ответ:

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

7. Как изменить поведение

  1. В распакованной папке откройте workshop-bot-prompt.txt в текстовом редакторе.
  2. Согласуйте одно изменение правила. Например: если вещь не названа, помощник задаёт один вопрос — «На какой вещи нужно заменить молнию?».
  3. Внесите изменение и сохраните файл с прежним именем и расширением .txt в кодировке UTF-8.
  4. В терминале остановите программу сочетанием Ctrl+C. Повторите команду запуска из шага 5 и снова введите оба ключа.
  5. Проверьте два отдельных обращения. Перед каждым отправьте /start, чтобы сбросить историю чата. Затем отправьте соответствующее сообщение:
Здравствуйте! Можно сегодня заменить молнию на куртке? И сколько это стоит?
Мне молнию поменять. Сколько?

В первом ответе помощник должен учесть куртку. Во втором — уточнить вещь. В обоих ответах цену и возможность выполнить работу сегодня подтверждает мастер.

Если используете Codex, можно поручить ему только правку файла:

Измени только workshop-bot-prompt.txt в распакованной папке. Добавь правило: если клиент не назвал вещь, задай один вопрос «На какой вещи нужно заменить молнию?». Если вещь названа, используй её в ответе. Сохрани остальные правила, включая подтверждение цены и срока мастером. Покажи изменение. Программу не запускай, другие файлы не меняй.

Ключи в Codex не вводите. Они нужны только запущенной программе в терминале.

8. Остановите бота

В окне терминала нажмите Ctrl+C. Для повторного запуска выполните ту же команду и снова введите оба ключа. После остановки программы бот перестаёт отвечать.

Если запуск не получился

Ориентируйтесь на название сервиса и текст ошибки, а также на её код.

Что видите Что проверить и сделать
Не найден bot.py Полностью распакован ли архив? Открыт ли терминал в папке, где лежит файл?
401 от Telegram или DeepSeek Проверьте ключ для указанного сервиса. Если его отозвали, создайте новый. Запустите программу заново и введите оба ключа.
402 от DeepSeek Проверьте баланс API в официальном кабинете. Когда доступ восстановится, заново запустите программу, введите оба ключа и повторите проверочное сообщение.
409 от Telegram: упомянут другой getUpdates Для этого токена уже работает другой процесс получения сообщений. Остановите прежний экземпляр бота и оставьте один запуск. Проверьте другие окна и компьютеры.
«У бота настроен webhook» при старте или 409 от Telegram с упоминанием webhook Для бота настроена доставка сообщений в другой сервис. Получение через getUpdates с ней несовместимо. Программа останавливается и сохраняет прежнее подключение. Для практикума создайте отдельного бота через BotFather.
429 Слишком много запросов. Сделайте паузу и повторите один запрос. Если указан срок ожидания, выдержите его.
Ошибка сети, ожидания или сертификата Проверьте интернет и доступ к сервису, названному в ошибке. В корпоративной сети уточните ограничения у администратора. На macOS при ошибке сертификата Python с python.org используйте Install Certificates.command из папки установленного Python. Проверку сертификатов не отключайте.
Программа работает, ответа нет Откройте показанную программой ссылку, проверьте личный чат и отправку /start. Посмотрите сообщение в терминале. Если появились 401, 402, 409 или 429, используйте соответствующую строку выше.

Если доступ к API получить не удалось, сообщите ведущему, на каком шаге остановились. Показывайте только сообщение об ошибке без ключей.

Работа 24/7 на VPS

VPS — виртуальный сервер, который работает независимо от вашего компьютера. Бот сам получает сообщения из Telegram исходящими запросами. Для этого способа домен, веб-сервер и входящий порт бота не нужны. Понадобятся токен и ключ из первых шагов, архив программы и отдельный VPS с Ubuntu 24.04 LTS.

9. Подготовьте ключ для подключения

Выполните команды на своём компьютере. SSH-ключ — пара файлов. Файл с окончанием .pub можно добавить в панель VPS. Файл без .pub оставьте у себя.

Windows, PowerShell

New-Item -ItemType Directory -Force "$env:USERPROFILE\.ssh" | Out-Null
ssh-keygen -t ed25519 -f "$env:USERPROFILE\.ssh\workshop-bot-ed25519" -C "workshop-bot"
Get-Content "$env:USERPROFILE\.ssh\workshop-bot-ed25519.pub"

macOS, Терминал

mkdir -p "$HOME/.ssh"
ssh-keygen -t ed25519 -f "$HOME/.ssh/workshop-bot-ed25519" -C "workshop-bot"
cat "$HOME/.ssh/workshop-bot-ed25519.pub"

При создании ключа задайте парольную фразу. Если файл с этим именем уже существует, откажитесь от перезаписи и используйте существующую пару. Скопируйте целиком строку, которая начинается с ssh-ed25519.

10. Арендуйте VPS в Timeweb Cloud

  1. Войдите в панель Timeweb Cloud. В разделе «Облачные серверы» нажмите «Добавить» или «Создать».
  2. Выберите чистую Ubuntu 24.04 LTS, регион и обычный сервер без GPU. Модель работает в DeepSeek. В провайдере VPS вы оплачиваете работающую машину и выбранные услуги. Проверьте итоговую сумму перед заказом.
  3. Проверьте, что у сервера будет публичный IPv4. В разделе «Авторизация» добавьте открытую часть SSH-ключа из шага 9. Для нового сервера с добавленным ключом выбирайте вход по ключу.
  4. Нажмите «Заказать». Дождитесь запуска сервера и откройте его «Дашборд». Скопируйте публичный IPv4 из реквизитов подключения.

Раздел облачных серверов с кнопкой «Добавить»

Скриншот из документации Timeweb Cloud.

Дашборд Timeweb Cloud с реквизитами для SSH

Пример дашборда из документации Timeweb Cloud. Скопируйте IPv4 своего сервера из своей панели.

11. Подключитесь по SSH и загрузите архив

Сначала проверьте отпечаток серверного ключа. В панели откройте вкладку «Консоль», войдите доступным способом и выполните на сервере:

ssh-keygen -lf /etc/ssh/ssh_host_ed25519_key.pub

При первом подключении клиент покажет отпечаток ключа. Для ключа ED25519 он должен совпасть с тем, который вы увидели в консоли. При несовпадении прервите подключение и проверьте IPv4. Если войти в консоль не получается, уточните, как получить отпечаток сервера, у поддержки Timeweb Cloud до подтверждения ключа. Веб-консоль Timeweb Cloud

В отдельном окне на своём компьютере откройте папку, где скачан workshop-bot.zip, и подключитесь:

Windows, PowerShell

$VpsIp = Read-Host "Публичный IPv4 сервера"
ssh -i "$env:USERPROFILE\.ssh\workshop-bot-ed25519" "root@$VpsIp"

macOS, Терминал

printf 'Публичный IPv4 сервера: '
read -r vps_ip
ssh -i "$HOME/.ssh/workshop-bot-ed25519" "root@${vps_ip}"

В открывшейся консоли VPS создайте папку для файлов и выйдите из SSH:

install -d -m 0700 /root/workshop-upload
exit

Теперь вы снова на своём компьютере. Отправьте архив и подключитесь повторно.

Windows, PowerShell

scp -i "$env:USERPROFILE\.ssh\workshop-bot-ed25519" .\workshop-bot.zip "root@${VpsIp}:/root/workshop-upload/"
ssh -i "$env:USERPROFILE\.ssh\workshop-bot-ed25519" "root@$VpsIp"

macOS, Терминал

scp -i "$HOME/.ssh/workshop-bot-ed25519" ./workshop-bot.zip "root@${vps_ip}:/root/workshop-upload/"
ssh -i "$HOME/.ssh/workshop-bot-ed25519" "root@${vps_ip}"

Если scp пишет, что архив не найден, проверьте, что локальный терминал открыли в папке с ZIP. Дальше все команды выполняйте на VPS, где приглашение терминала начинается с root@.

12. Установите программу и настройте автозапуск

  1. Если эта же копия бота ещё работает на компьютере, остановите её через Ctrl+C. Для одного токена оставьте один процесс.
  2. На VPS установите системные инструменты и проверьте Python:
apt-get update
apt-get install -y python3 unzip nano curl ca-certificates
python3 --version
  1. Распакуйте комплект. Создайте отдельного пользователя для сервиса. Он будет запускать бота без прав администратора.
unzip -o /root/workshop-upload/workshop-bot.zip -d /root/workshop-upload
id -u workshopbot >/dev/null 2>&1 || useradd --system --user-group --no-create-home --shell /usr/sbin/nologin workshopbot
install -d -m 0755 /opt/workshop-bot
install -m 0644 /root/workshop-upload/bot.py /opt/workshop-bot/bot.py
install -m 0644 /root/workshop-upload/workshop-bot-prompt.txt /opt/workshop-bot/workshop-bot-prompt.txt
install -m 0644 /root/workshop-upload/workshop-bot.service /etc/systemd/system/workshop-bot.service
  1. Создайте закрытый файл для ключей. Если файл уже есть, следующая команда его сохранит.
install -d -m 0700 /etc/workshop-bot
test -e /etc/workshop-bot/bot.env || install -m 0600 /dev/null /etc/workshop-bot/bot.env
chmod 0600 /etc/workshop-bot/bot.env
nano /etc/workshop-bot/bot.env

Вставьте в редактор две строки и подставьте свои значения. Не вставляйте этот блок в командную строку. Во время ввода отключите трансляцию экрана.

TELEGRAM_BOT_TOKEN=ВАШ_ТОКЕН_ИЗ_BOTFATHER
DEEPSEEK_API_KEY=ВАШ_КЛЮЧ_DEEPSEEK

В nano: Ctrl+O, Enter, Ctrl+X.

  1. Запустите службу через systemd и включите запуск при загрузке сервера:
systemctl daemon-reload
systemctl enable --now workshop-bot.service
systemctl is-enabled workshop-bot.service
systemctl is-active workshop-bot.service
journalctl -u workshop-bot.service -n 25 --no-pager

enabled подтверждает автозапуск, active — запущенный процесс в момент проверки. В журнале найдите «Бот запущен» и ссылку на своего бота.

Где увидеть состояние службы и адрес бота в терминале

Пример ожидаемого вывода. Адрес в кадре учебный.

13. Проверьте круглосуточный запуск

  1. Откройте своего бота с телефона, отправьте /start, затем обычный вопрос про молнию. Первый ответ проверяет связь с Telegram, второй также проверяет DeepSeek.
  2. Закройте SSH через exit. Отправьте ещё один вопрос. Ответ подтверждает, что сессия SSH не держит процесс.
  3. Для проверки старта после перезагрузки перезагрузите свой отдельный VPS, когда можно прервать показ. После загрузки вновь отправьте вопрос с телефона.

Если служба не отвечает, снова подключитесь к VPS по SSH командой из шага 11 и посмотрите журнал:

journalctl -u workshop-bot.service -n 50 --no-pager

Исправьте причину по таблице выше. После исправления ключа или баланса, а также если сработал лимит перезапусков, выполните на VPS:

systemctl reset-failed workshop-bot.service
systemctl restart workshop-bot.service
systemctl is-active workshop-bot.service

При изменении инструкции сначала отредактируйте /opt/workshop-bot/workshop-bot-prompt.txt, затем перезапустите службу и повторите знакомые проверочные вопросы. Для временной остановки используйте systemctl stop workshop-bot.service. Автозапуск при следующей загрузке останется включён.

14. Если боту нужен VPN — запрос для вашего чата с ИИ

Сначала проверьте запуск без VPN. Если сервер не может подключиться к Telegram или DeepSeek, скопируйте запрос ниже в свой чат с ИИ. Отвечайте на вопросы по одному. Для диагностики достаточно названия системы, типа VPN и текста ошибки без ключей.

Помоги мне разобраться с подключением учебного Telegram-бота на VPS. Я новичок. Бот настроен как служба workshop-bot.service на Ubuntu 24.04. Он обращается к Telegram Bot API и DeepSeek API по HTTPS. Доступ к VPS у меня по SSH.

Сначала спроси меня по одному:
1. Где арендован VPS, какая установлена система и работает ли SSH.
2. На каком шаге возникает ошибка и к какому сервису не проходит соединение: Telegram или DeepSeek.
3. Есть ли у меня уже VPN, какой он поддерживает протокол или тип подключения и выдаёт ли провайдер профиль для Linux.
4. Нужно ли провести через VPN только запросы бота или у меня есть другая задача.

Не проси присылать токен Telegram, ключ DeepSeek, пароль SSH, приватный ключ или полный VPN-конфиг. Если нужен фрагмент журнала, объясни, какие значения скрыть перед отправкой.

Сначала проведи безопасную диагностику без ключей. Помоги отличить проблему сети от неверного ключа, нехватки баланса и второго запуска бота. Если нужен VPN, предложи один вариант под мой профиль и систему. Для моего бота по умолчанию сохраняй обычный маршрут SSH и остального трафика VPS. Прежде чем предлагать менять общий маршрут сервера, объясни последствия и альтернативу для одной службы.

Давай команды небольшими группами. У каждой группы напиши, где её вводить, что заменить, какой результат увидеть и когда остановиться. Перед изменениями объясни, как откатить настройку, если SSH или бот перестанет работать. В конце помоги проверить из окружения службы доступ к Telegram и DeepSeek, затем ответ бота на обычное сообщение и запуск после перезагрузки. Сверяй конкретные команды с официальной документацией моей системы и VPN-провайдера.

Официальные источники

Проверено 19 ноября 2026 года.