English version | Русская версия
Умный ИИ-ассистент для Telegram-канала и группы обсуждений. Бот читает посты, учитывает контекст треда, анализирует ссылки, отвечает на вопросы подписчиков и может оставлять первый комментарий под новым постом.
По умолчанию проект настроен на облачную модель Gemini. OpenAI и локальная Ollama-модель остаются поддерживаемыми альтернативами.
- Нативное форматирование (Telegram Bot API 10.2): бот поддерживает отправку Rich Messages (нативные таблицы, списки, LaTeX-формулы) через конвертацию Markdown в HTML с помощью библиотеки
marked. Реализована полноценная поддержка математического рендеринга (tg-mathиtg-math-block) и авто-откат (fallback) для старых клиентов Telegram. - Приватные ответы в группах (Ephemeral Replies): бот умеет отвечать пользователям в комментариях группы приватными сообщениями (эфемерными), которые видны только автору вопроса и самому боту. Это помогает избежать захламления секции комментариев диалогами с ИИ.
- Cloud-first LLM: рекомендуемый режим через Gemini API, без локальной установки модели.
- OpenAI-compatible режим: можно переключиться на OpenAI API или совместимый endpoint.
- Локальный режим: Ollama сохранена как optional/legacy-вариант для запуска на своем железе.
- Контекст постов: бот кэширует новые посты канала и отвечает с учетом содержания публикации.
- Чтение ссылок: если в посте или вопросе есть URL, бот загружает страницу и использует ее текст в ответе.
- Режим первого комментария: бот может автоматически оставлять короткий комментарий под новым постом.
- Публикация постов (через ЛС): владелец может отправлять боту в ЛС команду
/post <текст в формате Markdown>(с опциональным прикреплением фото) для мгновенной публикации красивых Rich-постов в канал. Медиа сохраняется вpublic/mediaсайта на Vercel и публикуется по постоянному URL. - Публикация постов из ссылок: владелец может просто прислать ссылку (с опциональным фото/видео) в ЛС боту. Бот автоматически скачает содержимое страницы, сгенерирует интересный структурированный пост с помощью ИИ, прикрепит ссылку как источник и опубликует его. Также доступна явная команда
/postlink <url>. - Команды владельца:
/post,/postlink,/ephemeral,/status,/usage,/on,/off,/chatid. - Фокус и антиспам: отвечает только на вопросы, обращения и полезные запросы, игнорируя шум.
Нужен Node.js 22+.
npm installСоздайте локальный конфиг:
cp .env.example .envЗаполните обязательные значения:
TELEGRAM_BOT_TOKEN=your_telegram_bot_token
BOT_USERNAME=your_bot_username
ALLOWED_CHAT_IDS=-1001234567890
ALLOW_ALL_CHATS=false
OWNER_USER_IDS=123456789
CHANNEL_CHAT_ID=-1001234567890
LLM_PROVIDER=gemini
GEMINI_API_KEY=your_gemini_api_key
GEMINI_MODEL=gemini-3.6-flashГде:
TELEGRAM_BOT_TOKEN- токен от @BotFather.BOT_USERNAME- username бота без@.ALLOWED_CHAT_IDS- ID разрешенных групп или каналов, через запятую.ALLOW_ALL_CHATS- открытый режим для всех чатов. По умолчанию выключен.OWNER_USER_IDS- Telegram ID владельцев, через запятую.CHANNEL_CHAT_ID- ID канала для публикации через/post(начинается с-100).LLM_PROVIDER- один изgemini,openai,ollama.
- В
@BotFatherоткройтеBot Settings->Group Privacyи выключите privacy mode. - Добавьте бота в группу обсуждений канала.
- Дайте боту права, нужные для чтения сообщений и отправки ответов.
- Запустите:
npm startУ бота есть удобная веб-панель управления (Telegram Web App / Mini App), которая позволяет настраивать параметры ИИ, смотреть статистику использования токенов и создавать/публиковать посты во вкладке «Постинг».
Запустите файл start.bat в корневой папке проекта. Он автоматически откроет консоли и запустит:
- Локальный веб-сервер бота (
npm startна порту3001или указанном вPORTв.env). - Туннель
ngrokна ваш выделенный домен (или бесплатный случайный домен).
- Установите ngrok и добавьте ваш токен авторизации:
ngrok config add-authtoken <ВАШ_ТОКЕН>
- Запустите бота:
npm start
- Запустите туннель для порта бота (по умолчанию
3001):ngrok http --domain=your-domain.ngrok-free.app 3001
- Скопируйте полученную ссылку и привяжите её в Telegram:
- Откройте @BotFather ->
/mybots-> выберите вашего бота -> Bot Settings -> Menu Button -> Configure menu button. - Отправьте @BotFather полученную ссылку, добавив в конец
/app(например,https://your-domain.ngrok-free.app/app).
- Откройте @BotFather ->
Tip
Чтобы войти в админку напрямую через обычный веб-браузер без Telegram-авторизации, добавьте в ваш файл .env параметр:
BYPASS_INIT_DATA_AUTH=trueLLM_PROVIDER=gemini
GEMINI_API_KEY=your_gemini_api_key
GEMINI_MODEL=gemini-3.6-flash
GEMINI_BASE_URL=https://generativelanguage.googleapis.com/v1beta
LLM_TIMEOUT_MS=30000Этот режим подходит для обычного запуска: не требует GPU, быстрее стартует и проще разворачивается на сервере.
LLM_PROVIDER=openai
OPENAI_API_KEY=your_api_key
OPENAI_MODEL=gpt-4o-mini # Варианты: gpt-4o, o3-mini, grok-3-mini, grok-3, deepseek/deepseek-r1:free
OPENAI_BASE_URL=https://api.openai.com/v1
LLM_TIMEOUT_MS=30000Поддерживаются любые эндпоинты, совместимые со спецификацией OpenAI /chat/completions:
- OpenAI:
gpt-4o-mini(быстрая),gpt-4o(флагман),o3-mini(рассуждения). - xAI Grok:
grok-3-mini,grok-3(укажитеOPENAI_BASE_URL=https://api.x.ai/v1). - OpenRouter:
deepseek/deepseek-r1:free,meta-llama/llama-3.3-70b-instruct:free(укажитеOPENAI_BASE_URL=https://openrouter.ai/api/v1).
Локальный режим сохранен для тех, кому важны приватность и запуск без внешнего LLM API.
ollama pull qwen2.5:3b-instructLLM_PROVIDER=ollama
OLLAMA_MODEL=qwen2.5:3b-instruct # Альтернативы: llama3.2:3b, deepseek-r1:1.5b
OLLAMA_BASE_URL=http://127.0.0.1:11434
OLLAMA_NUM_CTX=4096
OLLAMA_NUM_PREDICT=200
LLM_TIMEOUT_MS=120000Для Ollama нужен установленный локальный сервер Ollama. Качество и скорость зависят от модели и железа.
- В
.envзаменитеLLM_PROVIDER=ollamaнаLLM_PROVIDER=gemini. - Добавьте
GEMINI_API_KEY. - Установите
GEMINI_MODEL=gemini-3.6-flash. - Уменьшите
LLM_TIMEOUT_MSдо30000, если раньше стояло120000. - Перезапустите бота.
Ollama-переменные можно оставить в .env: они не используются, пока LLM_PROVIDER не равен ollama.
/post <текст>- опубликовать пост в канале (отправляется в ЛС боту, поддерживает Markdown и прикрепление одного фото)./postlink <url>- автоматически сгенерировать и опубликовать пост по содержимому ссылки. Также работает, если просто отправить ссылку без команды./ephemeral <on/off>- включить или выключить режим приватных (эфемерных) ответов в группах. При вызове без параметров показывает текущий статус./chatid- показать ID текущего чата и треда./status- показать активный режим, модель и статистику./usage- показать счетчики запросов и токенов./on- включить автоответы./off- выключить автоответы.
Команды выполняются только для пользователей из OWNER_USER_IDS.
Основной промпт лежит в prompts/assistant.md. Через него можно изменить тон, стиль и правила ответа без правки кода.
Дополнительные параметры:
CHANNEL_ABOUT- краткое описание канала для контекста.AUTO_REPLY_ENABLED- включение автоответов при старте.MAX_REPLY_CHARS- максимальная длина ответа.THREAD_COOLDOWN_MS- пауза между ответами в одном треде.RECENT_MESSAGES_LIMIT- сколько последних сообщений учитывать.URL_FETCH_TIMEOUT_MS- таймаут загрузки страниц по ссылкам.WEBSITE_REPO_PATH- путь к репозиторию сайта на Vercel (напримерportfolio-clone).MEDIA_PUBLIC_BASE_URL- публичный URL медиа, напримерhttps://alevoldon.com/media.MEDIA_AUTO_DEPLOY- автоматически коммитить и пушить новые медиа в репозиторий сайта (true/false).LOG_LEVEL- уровень логов:error,warn,info,debug.
npm run check
npm testДля сайта:
cd website
npm run buildcp .env.example .env
# заполните .env
docker compose up -d --buildПапка data/ монтируется как volume — состояние бота и кэш постов сохраняются между перезапусками.
На VPS с Node.js 22+:
npm ci --omit=dev
npm startДля фонового запуска используйте systemd, pm2 или аналог. При остановке бот сохраняет data/state.json.
В репозитории настроен GitHub Actions (.github/workflows/ci.yml): синтаксическая проверка, unit-тесты и сборка лендинга.