Как подключить HappyCapy к Telegram: полноценный AI-агент в любом чате

Большинство ботов в Telegram отвечают на вопросы. Мост HappyCapy для Telegram запускает claude --print — каждое отправленное вами сообщение запускает полноценную сессию Claude Code с доступом к Bash, файловым операциям, веб-поиску, генерации изображений и более 300 000 Skills. Попросите его собрать данные с веб-сайта, написать Python-скрипт и выполнить его, или сгенерировать видео. И он это сделает. Это не чат-бот. Это агент, который просто живёт в вашем чате Telegram.

---

Почему это отличается от Telegram-бота

Создание Telegram-бота — это проект на выходные. Вы регистрируетесь через BotFather, получаете токен, вызываете Telegram Bot API, передаёте входящие сообщения в LLM API, возвращаете ответ. В результате получается сложная машина автозаполнения. У неё нет файловой системы. Она не может выполнять код. Она не может запускать рабочие процессы. Она не может делать ничего, что LLM API не может сделать за один статичный ответ.

Архитектура HappyCapy отличается на каждом уровне. HappyCapy работает как постоянно включённая Linux-песочница на Fly.io — с root-доступом, Python 3.11, Node.js v24 и постоянным хранилищем файлов. Когда приходит ваше сообщение в Telegram, мост вызывает claude --print, передавая ваше сообщение как входные данные. Этот вызов имеет полный доступ к инструментам: выполнение Bash, чтение и запись файлов, веб-поиск, генерация изображений, генерация видео и вся библиотека из более чем 300 000 Skills. Агент может открыть новую оболочку, запустить скрипт, прочитать результат и отправить его вам обратно — всё в рамках одного и того же обмена сообщениями.

Практический разрыв между этими двумя подходами не постепенный. Обычный Telegram-бот может сказать вам погоду. Telegram-бот HappyCapy может написать код для получения данных о погоде из трёх API, сравнить их, построить график, сохранить его как PNG и отправить вам как изображение — в одном сообщении, без необходимости покидать Telegram.

---

Что вы можете реально делать

Список возможностей не теоретический. Это то, что пользователи делают уже сегодня:

• Попросить бота собрать данные с веб-сайта и вернуть структурированные данные в виде таблицы или JSON
• Попросить его написать Python-скрипт, выполнить его в песочнице и вернуть stdout — без необходимости в IDE
• Сгенерировать изображение с помощью AI по промпту и получить его прямо в чате Telegram
• Запустить любой из более чем 300 000 Skills HappyCapy прямо в середине беседы — генерация PDF, создание таблиц, слайдов PPTX, синтез аудио
• Искать информацию в интернете, читать несколько источников и вернуть синтезированное резюме с цитированием источников
• Создавать и сохранять файлы в постоянном хранилище, а затем получать или обновлять их в последующих сообщениях
• Запускать задачи по расписанию: агент может запускать скрипт каждое утро и отправлять вам результат
• Отслеживать URL или API-эндпоинт и предупреждать вас, когда что-то меняется
• Обрабатывать загруженные документы — вставьте ссылку на CSV, получите анализ обратно
• Выстраивать многошаговые рабочие процессы, которые в противном случае требовали бы переключения между пятью разными инструментами

---

Плюсы

• Всегда включён, ноутбук не требуется. Песочница работает на инфраструктуре Fly.io. Вы можете написать боту с телефона в 2 часа ночи, и он выполнит код на сервере, к которому вам никогда не придётся прикасаться.
• Единый интерфейс для всего. Вместо того чтобы открывать Claude, потом редактор кода, потом браузер, потом инструмент для изображений — одно сообщение в Telegram запускает всё это.
• Контекст сохраняется. История переписки хранится для каждого пользователя. Вы можете сослаться на что-то, что спрашивали три дня назад, без повторного объяснения контекста.
• Полный root-доступ в песочнице. Агент может устанавливать пакеты, писать файлы и выполнять любую Unix-команду. Никаких ограничений, которые бы наложил потребительский чат-бот.
• 300 000+ Skills доступны мгновенно. Любой рабочий процесс, оформленный как Skill HappyCapy, доступен по одному предложению.
• Можно поделиться. Дайте имя пользователя бота коллеге или клиенту. Несколько пользователей могут взаимодействовать одновременно, каждый со своей изолированной историей переписки.
• Доступен бесплатный уровень. Сам мост для Telegram не добавляет никаких дополнительных расходов сверх вашего существующего плана HappyCapy.

---

Реальные случаи использования

Фрилансер-разработчик, оставивший свой ноутбук в офисе. Вы отправили коммит, заметили ошибку в логах развёртывания, и вы уже выходите из дома. С телефона вы пишете боту: «Забери последние логи развёртывания с сервера и скажи мне, на что жалуется строка 847». Через тридцать секунд у вас есть ответ. Вы пишете в ответ: «Напиши патч и открой PR». Готово. Ноутбук не открывался.

Владелец малого бизнеса, ежедневно отслеживающий метрики. Вместо того чтобы каждое утро заходить в пять разных панелей управления, бот запускает дайджест по расписанию. Каждое утро в 8:00: он получает данные о доходах из Stripe, количество посетителей из API аналитики и уровни запасов из Shopify. Он форматирует сводку и отправляет её как сообщение в Telegram ещё до того, как выпита первая чашка кофе. Настройка заняла один разговор с ботом.

Исследователь, которому нужно быстро извлечь данные. Вы читаете статью и хотите сравнить набор данных с тремя другими источниками. Переключение на браузер, переход к каждому источнику, скачивание CSV-файлов и проведение сравнения занимает 20 минут. Сообщение боту с URL-адресами и описанием того, что вам нужно, занимает две минуты. Бот собирает данные, разбирает их, сравнивает и возвращает таблицу.

Родитель, настроивший помощника с домашними заданиями. У детей уже есть учётная запись в Telegram. Бота HappyCapy добавили в семейную группу. Он может объяснять математические задачи шаг за шагом, генерировать диаграммы, писать практические вопросы и проверять ответы — без рекламы, без создания учётной записи и без цикла отвлечения, свойственного потребительскому чат-боту. Родитель хранит у себя админ-токен; дети получают сфокусированный инструмент.

---

Как это настроить

Настройка занимает менее пяти минут, если у вас есть учётная запись HappyCapy. Процесс начинается с Telegram BotFather: напишите @BotFather, выполните /newbot, выберите имя и получите токен бота — строку, похожую на 7384920156:AAF.... Этот токен — всё, что нужно HappyCapy, чтобы знать, куда направлять переписку.

Внутри HappyCapy Telegram skill делает всё остальное. Запустите skill, вставьте токен вашего бота, когда будет предложено, и мост запущен. Skill запускает цикл опроса (polling) в песочнице, который слушает входящие сообщения Telegram и направляет их через claude --print с полным доступом к инструментам. История переписки хранится для каждого идентификатора пользователя Telegram, поэтому каждый человек, пишущий вашему боту, получает свою собственную постоянную сессию.

Полный skill со скриптами настройки, документацией по переменным окружения и настройками ограничения частоты запросов и списков разрешённых пользователей доступен на github.com/ndpvt-web/happycapy-telegram. Если вы хотите глубже понять, почему архитектура агента HappyCapy отличается от типичной настройки чат-бота, прежде чем начать, AI Agent vs Chatbot подробно рассматривает это различие. А если вы думаете о том, чтобы запустить собственную постоянную AI-инфраструктуру вместо того, чтобы полагаться на Fly.io, стоит сначала прочитать разбор Mac Mini as AI Server 2026.

---

Часто задаваемые вопросы

Работает ли бот 24/7 или только когда включён мой компьютер? Он работает 24/7. Песочница живёт на инфраструктуре Fly.io, а не на вашем локальном компьютере. После того как вы развернёте Telegram skill, он остаётся активным, даже если ваш компьютер выключен или не подключён к интернету.

Может ли бот получить доступ к моим файлам и инструментам HappyCapy? Да. Бот работает внутри вашей песочницы HappyCapy, что означает, что у него есть доступ ко всему в этой среде: сохранённым файлам, установленным skills, заданным переменным окружения и любым подключённым интеграциям. Это ваш агент, доступный через другой интерфейс.

Бесплатно ли это использовать? Сам skill для Telegram-моста бесплатен. Ваши расходы определяются вашим планом HappyCapy, который покрывает вычислительные ресурсы песочницы и использование AI-модели. Дополнительной платы за слой интеграции с Telegram не существует.

Как работает история переписки по каждому пользователю? Каждый идентификатор пользователя Telegram получает собственный поток переписки, хранящийся в песочнице. Когда пользователь A отправляет сообщение, бот загружает историю пользователя A и добавляет новый обмен. Сообщения пользователя B полностью изолированы. История сохраняется между сессиями — переписка, которая была неделю назад, всё ещё доступна в контексте, если вы явно её не очистили.

Могу ли я ограничить, кто может использовать бота? Да. Skill поддерживает настройку списка разрешённых пользователей (allowlist). Вы можете указать список идентификаторов или имён пользователей Telegram, которым разрешено взаимодействовать с ботом. Сообщения от пользователей, не входящих в список разрешённых, молча игнорируются или возвращают собственное сообщение об отказе — на ваш выбор.

Что произойдёт, если Telegram ограничит частоту запросов моего бота? Skill обрабатывает ограничение частоты запросов с экспоненциальной задержкой. Если Telegram возвращает ответ 429, мост приостанавливается, ждёт необходимый период повторной попытки и автоматически возобновляет работу. Вы не потеряете сообщения. На практике ограничения частоты запросов срабатывают только при высокой одновременной нагрузке, что настраивается в параметрах skill.

Могут ли несколько людей использовать бота одновременно? Да. Цикл опроса обрабатывает сообщения асинхронно, и сессия каждого пользователя независима. Нет очереди, которая блокировала бы одного пользователя, пока обслуживается другой. При очень высокой нагрузке вы можете масштабировать экземпляр песочницы на Fly.io для обработки большего числа одновременных сессий — документация по skill описывает эту настройку.

---

Заключительные мысли

Интеграция с Telegram — это не функция сама по себе — она устраняет последнюю точку трения между вами и полностью функциональным AI-агентом. Ваша песочница HappyCapy уже выполняет код, генерирует медиаконтент и управляет более чем 300 000 Skills. Мост для Telegram означает, что вы получаете доступ ко всему этому, где бы вы уже ни находились, без переключения контекста. Будь это полезно в 2 часа ночи, когда вы удалённо отлаживаете код, или полезно каждое утро, когда вам нужен структурированный брифинг перед тем, как открыть ноутбук — это один и тот же агент, теперь доступный в каждом кармане.