Написать своего Telegram-бота на JavaScript проще, чем кажется. Для этого не нужно быть опытным программистом: базовых знаний JavaScript и часа свободного времени достаточно, чтобы получить рабочего бота, который отвечает на сообщения, показывает клавиатуры и выполняет команды.
Другой вопрос: что делать с ботом, когда код уже готов. Если просто запустить его на своём компьютере, он будет работать только пока компьютер включён и открыт терминал. Закрыли ноутбук, бот замолчал. Чтобы бот отвечал пользователям круглосуточно, его нужно перенести на сервер и настроить так, чтобы он перезапускался сам после сбоя или перезагрузки.
В этой статье разберём весь путь по порядку. Сначала напишем простого бота на JavaScript и разберёмся, какую библиотеку для этого выбрать. Потом перенесём готовый код на VPS, настроим автозапуск через PM2 и разберём типичные ошибки, из-за которых боты перестают отвечать в первую же неделю после запуска.
Что понадобится для создания бота
Для работы понадобится всего четыре вещи.
- js. Это среда, которая выполняет JavaScript-код вне браузера, именно на ней будет работать бот. На середину 2026 года актуальная стабильная ветка это Node.js 24, её и стоит ставить для нового проекта. Более свежая двадцать шестая ветка ещё не получила статус LTS (долгосрочной поддержки) и подходит скорее для экспериментов, чем для рабочего бота.
- Редактор кода. Подойдёт любой, от VS Code до простого текстового редактора с подсветкой синтаксиса.
- Аккаунт в Telegram. Он понадобится для регистрации бота через служебного бота BotFather.
- Сервер для постоянной работы. Пока код лежит на локальном компьютере, бот работает только тогда, когда открыт терминал. Для круглосуточной работы нужен отдельный сервер, например VPS.
Ресурсы боту нужны скромные: для большинства проектов хватает минимальной конфигурации. Арендовать такую можно на 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, старейшая из трёх. Библиотека тянет за собой устаревшие зависимости и обновляется не так активно, как хотелось бы. Для учебных примеров она встречается часто, поскольку исторически была одной из первых, но для нового проекта в 2026 году лучше присмотреться к альтернативам.
- Telegraf, проверенная временем библиотека с большим сообществом. В ней уже есть готовые механизмы для сцен (многошаговых диалогов) и сессий (хранения состояния конкретного пользователя), что удобно для ботов со сложной логикой.
- grammY, более новая библиотека, написанная на TypeScript. За последний год она обошла Telegraf по числу скачиваний и активно развивается: разработчики делают ставку на простой и предсказуемый код и на типизацию из коробки, даже если сам проект пишется на обычном 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 не требует домена, SSL-сертификата и открытых входящих портов, достаточно исходящего соединения в интернет. Это удобно для разработки и для небольших личных ботов. Минус в задержке: сообщение иногда приходит с опозданием в несколько секунд, а постоянные обращения к серверу создают небольшую фоновую нагрузку.
- Webhook работает быстрее: обновления приходят мгновенно, без опроса вхолостую. Но для него понадобится собственный домен с действующим HTTPS-сертификатом, что усложняет первоначальную настройку.
Для старта и для большинства личных или небольших рабочих ботов 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 бот поднимется сам, без ручного вмешательства.
Несколько команд, которые пригодятся в повседневной работе с ботом.
- pm2 logs telegram-bot для просмотра логов в реальном времени, полезно при отладке ошибок.
- pm2 restart telegram-bot для перезапуска после обновления кода.
- pm2 stop telegram-bot чтобы временно остановить бота, не удаляя его из списка процессов.
Частые ошибки при запуске бота на сервере
Даже при аккуратном следовании инструкции есть несколько мест, где новички спотыкаются чаще всего.
- Токен в коде вместо .env. Если вписать токен прямо в index.js и загрузить проект в публичный репозиторий, он мгновенно станет доступен кому угодно. Решение простое: токен только в .env, а сам файл .env в .gitignore.
- Одновременный запуск polling и webhook. Если на сервере случайно остались активны оба режима, бот начинает отвечать через раз или дублировать сообщения. Перед переключением на webhook важно явно отключить polling.
- Бот работает, только пока открыт терминал. Это самая частая причина, по которой бот перестаёт отвечать через несколько часов после запуска. Решается через PM2 и команду pm2 startup, описанные выше.
- Устаревшая версия Node.js. Некоторые библиотеки перестают поддерживать совсем старые версии, а часть современных возможностей языка на них просто не работает. Стоит держать на сервере актуальную LTS-ветку и время от времени проверять её актуальность.
- Открытый порт без защиты при переходе на webhook. Если бот со временем переходит на webhook, важно закрыть порт файрволом от посторонних обращений и оставить доступ только для нужных адресов.
Что делать дальше: как развивать бота
Базовый бот, который отвечает на команды и текстовые сообщения, это только отправная точка. Дальше логика развития обычно такая.
- Подключить базу данных (подойдёт даже простой SQLite), если бот должен запоминать пользователей или хранить историю переписки.
- Перейти на webhook, когда аудитория вырастет и задержка long polling станет заметной.
- Добавить инлайн-клавиатуры и кнопки для удобного взаимодействия, вместо того чтобы просить пользователя печатать команды вручную.
- Разместить на одном сервере сразу несколько ботов через PM2, каждый под своим именем процесса, если задачи небольшие и не требуют отдельной машины под каждый проект.
Заключение
Путь от пустого файла до бота, который работает круглосуточно, укладывается в несколько понятных шагов: получить токен у BotFather, написать код на grammY или Telegraf, перенести его на сервер и запустить через PM2 с автозапуском.
Расширять бота можно постепенно, добавляя функции по мере необходимости, вместо того чтобы пытаться продумать всё заранее.
Начать можно с малого: арендовать минимальную VPS-конфигурацию на Serverspace, развернуть на ней бота из этой инструкции и уже на практике понять, каких возможностей ему не хватает.