Запускаем ИИ-агента для Telegram на Antigravity CLI
Мир ИИ-инструментов меняется быстро: Google официально переводит пользователей с привычного Gemini CLI на новую платформу Antigravity 2.0. Это не просто смена названия, а переход на более мощную архитектуру агентов с расширенными возможностями планирования, работы с файлами и внешними сервисами. Для тех, кто использовал ИИ-помощников в терминале или создавал на их базе Telegram-ботов, наступил момент миграции.
Запуск автономного ИИ-агента — это технический процесс, который требует понимания того, как части системы общаются друг с другом. В этом руководстве мы пройдем по официальному пути установки Antigravity CLI, разберем процесс авторизации на удаленном сервере и подготовим «фундамент» для вашего будущего Telegram-бота.
Зачем выносить агента на сервер?
Хотя Antigravity CLI можно запустить и на обычном ноутбуке, для работы Telegram-бота лучше использовать VDS или VPS (Virtual Dedicated/Private Server). Это ваш личный удаленный компьютер в дата-центре, который включен 24/7.
Если запустить агента локально, бот перестанет отвечать, как только вы закроете крышку ноутбука или пропадет интернет. Сервер же обеспечивает стабильность: ваш ИИ-помощник всегда на связи, готов обрабатывать сообщения и выполнять задачи по расписанию. Подключение к такому серверу обычно происходит через SSH (Secure Shell) — защищенный протокол, который открывает текстовое окно терминала удаленной машины на вашем экране. Именно в этом текстовом интерфейсе, называемом CLI (Command Line Interface), и живет наш агент.
Шаг 1. Официальная установка Antigravity CLI
Для установки Antigravity CLI на сервер или локальный компьютер Google предоставляет официальные скрипты. Вам не нужно скачивать архивы вручную — достаточно запустить в терминале команду, соответствующую вашей операционной системе.
Для macOS и Linux (включая удаленные VDS на Ubuntu): Введите в терминале:
curl -fsSL https://antigravity.google/cli/install.sh | bash
Для Windows (PowerShell):
irm https://antigravity.google/cli/install.ps1 | iex
Для Windows (классическая командная строка CMD):
curl -fsSL https://antigravity.google/cli/install.cmd -o install.cmd && install.cmd && del install.cmd
После завершения установки закройте терминал и откройте его снова, чтобы система «увидела» новую команду agy. Официальные инструкции и системные требования (например, для Linux нужна библиотека glibc версии 2.28 и выше) можно найти на странице загрузки Antigravity.
Шаг 2. Авторизация в SSH-контексте
Самый тонкий момент при работе с сервером — авторизация. На обычном компьютере Antigravity CLI просто открывает окно браузера для входа в Google-аккаунт. Но на сервере (VDS) браузера нет.
В этом случае CLI понимает, что работает в SSH-сессии, и действует иначе:
- Вы запускаете команду
agy. - Программа печатает в терминале специальную ссылку (URL) для авторизации.
- Вы копируете эту ссылку и открываете её в браузере на своём основном компьютере.
- Входите в свой Google-аккаунт, подтверждаете доступ и получаете секретный код авторизации.
- Копируете этот код, возвращаетесь в терминал сервера и вставляете его в запрос программы.
Теперь ваш агент авторизован. Он может использовать ваши лимиты, видеть ваши настройки и работать от вашего имени. Подробнее о первом запуске можно прочитать в официальном руководстве Getting Started.
Шаг 3. Миграция с Gemini CLI
Если у вас уже были настроенные агенты в Gemini CLI, вам не нужно переписывать промпты с нуля. Antigravity CLI умеет подхватывать старое окружение.
Для автоматического переноса плагинов используйте команду:
agy plugin import gemini
Она найдет установленные расширения Gemini CLI и конвертирует их в новый формат плагинов Antigravity. Важно помнить, что Antigravity CLI поддерживает большинство функций предшественника, но не гарантирует 100% совпадение всех настроек — например, кастомные темы оформления могут не перенестись.
Также новый агент автоматически загрузит ваши глобальные инструкции из файла ~/.gemini/GEMINI.md и навыки (skills) из папки ~/.gemini/skills/. Если вы работаете в конкретной папке проекта, убедитесь, что там лежат файлы GEMINI.md и AGENTS.md — агент прочитает их, чтобы понять контекст именно этой задачи.
Шаг 4. Регистрация бота в Telegram
Чтобы ваш ИИ-агент «обрел лицо» в мессенджере, нужно создать аккаунт бота через официальный сервис Telegram — BotFather. Это специальный бот, который управляет всеми остальными ботами.
Как создать бота:
- Найдите в Telegram аккаунт
@BotFather. - Отправьте команду
/newbot. - Придумайте имя для бота (например, «Мой ИИ Помощник»).
- Выберите уникальный
username, который обязательно должен заканчиваться наbot(например,my_agent_2026_bot). - В ответ BotFather пришлет вам API Token.
Внимание: Безопасность токена! API-токен — это секретный пароль. Любой, кто его знает, может управлять вашим ботом. Никогда не публикуйте его в открытых чатах, не вставляйте в текстовые файлы, которые могут попасть в интернет, и не передавайте посторонним. Сохраните его в надежном месте — он понадобится для связи сервера с Telegram. Общие правила работы с ботами описаны в официальном FAQ Telegram.
Шаг 5. Как связать CLI и Telegram (Архитектура «Моста»)
Здесь важно прояснить технический момент: Antigravity CLI сам по себе не является Telegram-ботом. Это программа-интерфейс для работы с ИИ-агентом. Чтобы сообщения из Telegram попадали в «мозг» агента, нужен backend-мост — промежуточный программный слой, который вы реализуете или настраиваете отдельно под свои задачи.
Как это работает на уровне логики:
- Пользователь пишет сообщение вашему боту в Telegram.
- Telegram через свои серверы передает это сообщение на ваш VDS (используя Webhook или Long Polling).
- Ваша программа-мост (backend) принимает входящее сообщение, обрабатывает его и передает запрос агенту Antigravity, запущенному в контексте вашего проекта.
- Агент обдумывает ответ, выполняет нужные действия с файлами и выдает результат.
- Мост забирает этот ответ и отправляет его обратно пользователю в Telegram через Telegram Bot API.
Google Antigravity официально не предоставляет «готового моста» или специальной команды для моментального подключения Telegram прямо в консоли. Официальная документация подтверждает только правила работы Telegram Bot API и процедуру настройки Antigravity CLI. Реализация связки — это всегда проектная часть, которую нужно внедрять или аудировать самостоятельно. Если вы используете готовые шаблоны от сообщества, всегда проверяйте, как именно они работают с вашим API-токеном и данными.
Проверка и управление
Когда все настроено, управление агентом происходит через систему слэш-команд прямо в терминале или через интерфейс вашего бота.
Основные команды Antigravity CLI:
/configили/settings— открыть панель настроек./skills— посмотреть список доступных навыков./mcp— управление серверами протокола MCP (Model Context Protocol), которые позволяют агенту подключаться к внешним базам данных или инструментам./logout— безопасный выход из аккаунта.
Помните, что ИИ-агенты в Antigravity CLI — это не просто чат-боты. Они могут редактировать файлы в вашей рабочей директории, выполнять команды и анализировать структуру целых проектов. Это мощный инструмент автоматизации, который при правильной настройке на сервере превращается в круглосуточного цифрового сотрудника, доступного вам через обычный чат в Telegram.
Следите за официальными обновлениями в документации Antigravity, так как платформа активно развивается и список доступных плагинов постоянно пополняется.