☰
03.08.2026

Как написать Telegram-бота на JavaScript и запустить его на VPS

Написать своего Telegram-бота на JavaScript проще, чем кажется. Для этого не нужно быть опытным программистом: базовых знаний JavaScript и часа свободного времени достаточно, чтобы получить рабочего бота, который отвечает на сообщения, показывает клавиатуры и выполняет команды.

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

В этой статье разберём весь путь по порядку. Сначала напишем простого бота на JavaScript и разберёмся, какую библиотеку для этого выбрать. Потом перенесём готовый код на VPS, настроим автозапуск через PM2 и разберём типичные ошибки, из-за которых боты перестают отвечать в первую же неделю после запуска.

Что понадобится для создания бота

Для работы понадобится всего четыре вещи.

Ресурсы боту нужны скромные: для большинства проектов хватает минимальной конфигурации. Арендовать такую можно на Serverspace, VPS там разворачивается за несколько минут, без долгой ручной настройки инфраструктуры с нуля.

Как получить токен бота через BotFather

Прежде чем писать код, нужно зарегистрировать бота в самом Telegram и получить токен, ключ доступа к API.

Открываем Telegram и находим в поиске @BotFather, это официальный бот для создания и управления другими ботами. Отправляем команду /newbot и следуем подсказкам: сначала указываем имя бота, которое увидят пользователи, затем короткий технический username, обязательно заканчивающийся на bot.

После этого BotFather присылает токен, длинную строку из цифр и букв. Это главный ключ доступа к боту: с его помощью любой человек сможет управлять ботом от вашего имени.

Важно. Токен нельзя публиковать в открытом коде, выкладывать на GitHub или вставлять прямо в файл со скриптом. Дальше в статье разберём, как хранить его правильно.

Какую библиотеку выбрать: Telegraf, grammY или node-telegram-bot-api

Писать код напрямую через Telegram Bot API можно, но это долго: придётся вручную обрабатывать HTTP-запросы и разбирать структуру каждого события. Проще взять готовую библиотеку, которая берёт на себя всю рутину.

На JavaScript для этого чаще всего используют три варианта.

Для небольшого или среднего бота подойдёт любая из двух современных библиотек. Ниже сравнение, которое поможет определиться.

Библиотека Популярность Особенности Кому подходит
node-telegram-bot-api Снижается, обновляется редко Простой API, но тянет устаревшие зависимости Только учебные примеры, для нового проекта не рекомендуется
Telegraf Стабильно высокая, большое сообщество Готовые сцены и сессии, богатая экосистема плагинов Боты со сложной логикой диалогов и многошаговыми сценариями
grammY Растёт быстрее остальных, обгоняет Telegraf по скачиваниям Написан на TypeScript, лёгкий и современный подход к middleware Новые проекты и разработчики, которым важен актуальный стек

В этой статье возьмём grammY как основу для примеров, поскольку это актуальный выбор для нового проекта, а сама логика без труда переносится и на Telegraf, разница будет в основном в синтаксисе.

Пишем первого бота: базовый код на JavaScript

Создаём папку проекта и инициализируем в ней Node.js-проект:

mkdir my-telegram-bot

cd my-telegram-bot

npm init -y

Устанавливаем библиотеку и модуль для работы с переменными окружения:

npm install grammy dotenv

Модуль dotenv понадобится, чтобы хранить токен бота отдельно от кода, в файле, который не попадёт в git.

Создаём в корне проекта файл .env и вписываем туда токен, полученный от BotFather:

BOT_TOKEN=ваш_токен_от_botfather

Теперь создаём главный файл бота, например index.js:

require('dotenv').config();

const { Bot } = require('grammy');

const bot = new Bot(process.env.BOT_TOKEN);

bot.command('start', (ctx) => {

ctx.reply('Привет! Я простой бот на JavaScript. Напиши мне что-нибудь.');

});

bot.on('message:text', (ctx) => {

ctx.reply(`Вы написали: ${ctx.message.text}`);

});

bot.start();

Разберём, что делает этот код. Строка require('dotenv').config() подгружает переменные из файла .env, поэтому токен доступен через process.env.BOT_TOKEN и не хранится прямо в скрипте. Объект bot создаётся с этим токеном и становится точкой входа для всей логики. Обработчик bot.command('start', ...) срабатывает, когда пользователь отправляет команду /start, а bot.on('message:text', ...) реагирует на любое текстовое сообщение и отправляет его обратно с небольшой припиской.

Запускаем бота локально:

node index.js

Если всё сделано верно, консоль ничего не выведет, но бот в Telegram уже начнёт отвечать. Открываем чат с ним и отправляем /start, должно прийти приветственное сообщение. Дальше можно добавить обработку кнопок, инлайн-клавиатуры или подключить внешний API, но для базового бота этого кода уже достаточно.

Webhook или long polling: как бот будет получать сообщения

Код выше запускает бота в режиме long polling: он сам, в цикле, обращается к серверам Telegram и спрашивает, нет ли новых сообщений. Это самый простой способ получать обновления, метод bot.start() как раз включает именно его.

У long polling есть альтернатива, webhook. В этом случае Telegram сам присылает POST-запрос на указанный вами адрес при каждом новом событии, вместо того чтобы бот сам его запрашивал.

У каждого подхода свои сильные стороны.

Для старта и для большинства личных или небольших рабочих ботов long polling подходит без оговорок. К webhook имеет смысл переходить, когда бот набирает заметную аудиторию и задержка в несколько секунд становится критичной, либо когда бот работает в связке с другими сервисами на том же домене.

Переносим бота на VPS и настраиваем постоянную работу

Выбираем и готовим сервер

В отличие, например, от запуска локальных языковых моделей, телеграм-боту не нужны большие вычислительные мощности. Даже боту с несколькими тысячами активных пользователей обычно хватает минимальной конфигурации VPS: одного процессорного ядра и одного двух гигабайт оперативной памяти. Больше ресурсов имеет смысл брать только тогда, когда бот параллельно решает тяжёлые задачи, например обработку изображений или частые запросы к объёмной базе данных.

Арендовать такой сервер можно у любого провайдера. У Serverspace минимальные тарифы как раз рассчитаны на подобные лёгкие задачи, а сама VPS разворачивается за несколько минут без ручной настройки инфраструктуры с нуля.

После того как сервер готов, подключаемся к нему по SSH:

ssh root@ваш_IP_адрес

Первым делом обновляем систему:

apt update && apt upgrade -y

Затем устанавливаем Node.js актуальной LTS-ветки. Проще всего сделать это через NodeSource:

curl -fsSL https://deb.nodesource.com/setup_24.x | bash -

apt install nodejs -y

Проверяем версию:

node -v

Если команда вывела что-то в районе v24.x.x, сервер готов к следующему шагу.

Переносим код и настраиваем .env

Есть два простых способа доставить код на сервер. Если проект уже лежит в git-репозитории, например на GitHub, достаточно его клонировать:

git clone https://github.com/ваш_аккаунт/my-telegram-bot.git

cd my-telegram-bot

Если репозитория нет, можно скопировать файлы напрямую с локального компьютера через scp:

scp -r my-telegram-bot root@ваш_IP_адрес:/root/

Дальше в обоих случаях устанавливаем зависимости:

npm install

Важный момент: файл .env с токеном в git обычно не попадает (его стоит сразу добавить в .gitignore), поэтому на сервере его нужно создать заново:

nano .env

И вписать туда тот же BOT_TOKEN, что использовался при локальном тестировании. Хранить токен именно так, отдельно от кода репозитория, стоит вне зависимости от того, публичный репозиторий или приватный. Это исключает риск случайно закоммитить секретный ключ вместе с остальным кодом.

Запускаем через PM2 и включаем автозапуск

Если запустить бота командой node index.js и просто закрыть терминал, процесс завершится вместе с SSH-сессией. Чтобы бот работал постоянно, нужен менеджер процессов. Для Node.js для этого чаще всего берут PM2.

Устанавливаем его глобально:

npm install -g pm2

Запускаем бота через PM2:

pm2 start index.js --name telegram-bot

Теперь процесс работает в фоне независимо от терминала. Проверить статус можно командой:

pm2 status

Осталось настроить автозапуск после перезагрузки сервера:

pm2 save

pm2 startup

Вторая команда выведет ещё одну строку, которую нужно скопировать и выполнить отдельно, обычно это команда с sudo, привязывающая PM2 к systemd. После этого при перезагрузке VPS бот поднимется сам, без ручного вмешательства.

Несколько команд, которые пригодятся в повседневной работе с ботом.

Частые ошибки при запуске бота на сервере

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

Что делать дальше: как развивать бота

Базовый бот, который отвечает на команды и текстовые сообщения, это только отправная точка. Дальше логика развития обычно такая.

Заключение

Путь от пустого файла до бота, который работает круглосуточно, укладывается в несколько понятных шагов: получить токен у BotFather, написать код на grammY или Telegraf, перенести его на сервер и запустить через PM2 с автозапуском.

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

Начать можно с малого: арендовать минимальную VPS-конфигурацию на Serverspace, развернуть на ней бота из этой инструкции и уже на практике понять, каких возможностей ему не хватает.