Telegram-бот на Node.js (grammY) — стартовый бот для botdepo

Небольшой, но настоящий бот-заметки: пришлите ему текст — он сохранит, /list покажет заметки с кнопками удаления. Его удобно взять за основу своего бота: здесь уже есть команды, кнопки, хранение данных и всё, что нужно, чтобы бот работал на botdepo.

Запустить за минуту

1. Получите токен бота — от @BotFather в Telegram: /newbot → придумать имя → скопировать токен.
2. Зарегистрируйтесь на botdepo.ru → «Новый бот».
3. В поле «Репозиторий» вставьте ссылку на этот репозиторий, в «Токен бота» — токен.
4. «Задеплоить». Через минуту бот отвечает.

Сделать своего бота на его основе

1. Нажмите Fork вверху этой страницы — у вас появится своя копия.
2. В botdepo создайте бота со ссылкой на свой форк (если уже запустили этот репозиторий — удалите того бота: ссылку у существующего бота пока поменять нельзя, а один токен не может работать в двух ботах сразу).
3. Меняйте код в своей копии — прямо в браузере на GitHub или у себя на компьютере — и нажимайте «Передеплоить» в карточке бота.

Что где лежит

Файл	Что внутри
index.js	бот: команды, кнопки, обработчики
storage.js	хранение заметок в JSON-файле в /data
package.json	библиотеки и команда запуска (npm start)
AGENTS.md	правила для ИИ-ассистентов (Cursor, Claude, ChatGPT)

Как менять

Добавить команду — новый обработчик:

bot.command("help", (ctx) => ctx.reply("Я умею хранить заметки."));

Добавьте его выше bot.on("message:text", ...) — grammY берёт первый подходящий.

Добавить библиотеку. Новая библиотека → npm install имя (она попадёт в package.json). Ставить библиотеки из кода нельзя — только через этот файл.

Сохранять данные. Только в папку /data — она переживает перезапуски и передеплои. Остальная файловая система бота только для чтения: файл, записанный рядом с кодом, вызовет ошибку.

Секреты (ключи API, пароли) — не в код, а в «Переменные окружения» в карточке бота на botdepo. В коде читайте их через os.getenv("ИМЯ") / process.env.ИМЯ.

Пишете с ИИ

В AGENTS.md описаны ограничения платформы — Cursor, Claude Code и другие ассистенты читают его сами. Если пишете в чате (ChatGPT и т.п.), вставьте содержимое AGENTS.md в начало разговора.

Запустить у себя на компьютере

npm install
BOT_TOKEN=ваш_токен npm start   # Windows: set BOT_TOKEN=ваш_токен && npm start

Локально данные сохраняются в папку data/ рядом с кодом. Не запускайте бота одновременно у себя и на botdepo с одним токеном — Telegram и MAX отдают сообщения только одной копии, вторая получит ошибку Conflict.

Если что-то не работает

Логи и подсказки по ошибкам — в карточке бота на botdepo. Разбор частых ошибок — в документации.