Два AI-агента на Hermes в Telegram: как настроить бота и исполнителя

Что нужно до установки

В конце у вас будет один бот в Telegram: вы пишете ему, он отвечает и при необходимости поручает отдельное задание временному помощнику. Второй Telegram-бот для этого не нужен. Эта инструкция рассчитана на человека, который прежде не открывал серверную консоль.

Подготовьте:

1. Telegram на телефоне и доступ к своему аккаунту.
2. VPS — удалённый компьютер, который работает без вашего ноутбука. Выбирайте сервер за рубежом, в стране, где ваш выбранный поставщик AI-модели разрешает доступ. Я рекомендую Hostinger; подойдёт и другой провайдер VPS. Иностранный IP сам по себе не гарантирует доступ: поставщик модели проверяет не только IP, но и свои правила для аккаунта, оплаты и региона. Уточните правила у поставщика до покупки VPS.
3. ОС сервера: Linux, например Ubuntu Server на тарифе VPS (не обычный веб-хостинг). У провайдера найдите вариант с доступом по SSH. Hermes поддерживает Linux; в этой статье команды вводятся именно на Linux-сервере, не в Telegram и не в поисковой строке браузера. Точных «минимальных» RAM/CPU/диска здесь нет: официальная инструкция установки не даёт универсального минимума для всех инструментов и моделей. Если будете запускать модель на самом сервере, требования к ресурсам будут другими; ниже мы используем удалённую модель.
4. Доступ к AI-модели: выберите поставщика и способ входа, который предлагается в мастере Hermes. У некоторых нужен оплачиваемый API-ключ, у других — вход через браузер или подписка. Деньги за VPS и за модель могут списываться отдельно. Секретный ключ вводите только в мастер на своём сервере, не в статью и не в публичный чат.

1. Купите сервер и запишите данные для входа

1. Откройте сайт выбранного VPS-провайдера и зарегистрируйтесь. В Hostinger перейдите по ссылке выше, выберите VPS, а не «Web Hosting», и пройдите покупку в панели провайдера. Названия кнопок и цена могут меняться.
2. При создании VPS выберите Linux / Ubuntu Server, регион, который подходит правилам выбранной модели, и способ входа SSH. Если панель предлагает создать пароль администратора, задайте длинный уникальный пароль и сохраните его в менеджере паролей. Не публикуйте его.
3. Дождитесь, пока панель покажет, что VPS запущен. Откройте карточку сервера и найдите IP-адрес (цифры с точками), имя пользователя для SSH (часто root, но смотрите именно вашу панель) и пароль. Иногда пароль приходит в письме или задаётся при создании. Не путайте пароль сервера с ключом AI-модели и токеном Telegram-бота.
4. Если провайдер выдаёт SSH-ключ вместо пароля, не пытайтесь использовать пример с паролем: откройте инструкцию провайдера по подключению с этим ключом либо выберите предлагаемый им вход через браузерную консоль. Не отправляйте ключ никому.

2. Откройте терминал и войдите на VPS

SSH — защищённое соединение, через которое вы печатаете команды на удалённом сервере. Терминал — окно для этих команд.

1. На Windows нажмите «Пуск», наберите PowerShell и откройте его. На macOS откройте приложение Терминал через поиск Spotlight. На Linux откройте Терминал из меню приложений. Это окно находится на вашем компьютере.
2. Скопируйте следующую строку. Прежде чем нажимать Enter, замените USER на имя пользователя из панели VPS и IP на IP сервера. Например, если провайдер написал root и 203.0.113.10, строка станет ssh root@203.0.113.10. Примерный IP не используйте для реального входа.

ssh USER@IP

3. Вставьте получившуюся строку в окно PowerShell/Терминала, нажмите Enter. Для вставки обычно работают Ctrl+V (Windows), Cmd+V (Mac) или Ctrl+Shift+V (терминал Linux); если нет — щёлкните правой кнопкой и выберите «Вставить».
4. При первом подключении может появиться вопрос про подлинность узла и слово yes/no. Сверьте IP с панелью провайдера, введите yes, нажмите Enter. Если показан отпечаток ключа сервера, для строгой проверки сравните его с данными провайдера; при неожиданном изменении отпечатка остановитесь, не соглашайтесь автоматически.
5. При запросе password: введите пароль сервера и нажмите Enter. Пока вы его вводите, на экране ничего не появляется — это нормально. После входа увидите строку приглашения вроде root@...:~# или user@...:~$. Теперь следующие команды выполняются на VPS. Если ваш провайдер дал браузерную консоль, открывайте её в панели VPS: после входа она заменяет SSH-окно.

Дальше правило одно: копируйте только содержимое блока с командой, вставляйте в строку приглашения сервера и нажимайте Enter; дожидайтесь результата перед следующей командой. Тексты сообщений для Telegram, напротив, вставляйте в чат Telegram.

3. Установите Hermes на сервере

Работайте под тем же пользователем, который затем будет запускать бота. Не добавляйте sudo к командам ниже: установщик сам сообщит, если ему понадобится доступ для системной библиотеки. Установщик может сразу открыть мастер настройки; пройдите его, а в следующих шагах проверьте модель и Telegram отдельно.

1. Скопируйте одну строку в терминал VPS и нажмите Enter:

curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash

2. Подождите завершения загрузки и установки. На экране будут строки о шагах установки и, возможно, вопросы мастера. Если мастер спросит поставщика модели и способ входа, выберите свой вариант; ключ или код входа вводите там, по подсказкам мастера. Если спросит о Telegram, можете настроить его позже в шаге 5. Не копируйте пароли, токены и полный вывод установки в публичные чаты.
3. Если после установки команда hermes не находится, закройте SSH-окно, откройте его снова и подключитесь командой из шага 2. Либо на VPS введите:

source ~/.bashrc

4. Проверьте, что команда доступна:

hermes --version

Ожидайте номер версии Hermes, а не command not found. Если видите ошибку, вернитесь к выводу установщика и официальному разделу установки.

4. Настройте модель и проверьте ответ без Telegram

1. В терминале VPS введите:

hermes setup

Если мастер уже запустился при установке и вы его закончили, повторять полную настройку не обязательно: можно сразу перейти к hermes doctor ниже. Если запускаете hermes setup, выбирайте модель и способ авторизации по подсказкам на экране. Для этой инструкции удобнее обычная полная настройка, а не Blank Slate: в минимальном режиме инструменты делегирования выключены. Если ошиблись с моделью, позже выполните hermes model и выберите её заново. Не вводите ключ модели в команду из статьи.

2. Проверьте конфигурацию:

hermes doctor

Прочитайте ошибки, если они есть. doctor проверяет настройку, но не доказывает, что модель уже отвечает. Для настоящей проверки запустите чат:

hermes

3. Когда увидите приглашение написать сообщение Hermes, напечатайте: Ответь одним предложением: сколько дней в неделе? и нажмите Enter. Вы должны увидеть осмысленный ответ. Если пришла ошибка входа, оплаты, лимита или недоступного региона — исправьте её у поставщика модели и повторите тест до настройки Telegram.
4. Выйдите из чата командой /exit в поле сообщения Hermes (или сочетанием Ctrl+C), чтобы вернуться к строке команд VPS.

5. Создайте Telegram-бота и узнайте свой ID

Здесь действия происходят в приложении Telegram, не в терминале.

1. Через поиск Telegram найдите @BotFather и проверьте точное имя. Откройте чат, нажмите «Начать» или отправьте /start.
2. Отправьте ему /newbot. На вопрос о имени напишите любое понятное имя, например «Мой помощник». На вопрос о username придумайте уникальное латинское имя, которое заканчивается на bot. Если имя занято, придумайте другое.
3. BotFather пришлёт токен — длинную секретную строку с двоеточием. Сохраните его приватно. Не вставляйте токен в текст сообщения своему боту, эту статью, скриншот, GitHub или чужой чат. Пока не закрывайте диалог: токен понадобится в мастере на VPS.
4. Через поиск Telegram откройте @userinfobot, нажмите «Начать». Он пришлёт ваш числовой User ID, например 123456789. Запишите именно цифры. Ваше имя вида @nickname — не этот ID. Если не хотите пользоваться сторонним ботом для ID, смотрите альтернативы в официальной инструкции Telegram для Hermes.

6. Подключите Telegram-бота

1. Вернитесь в терминал сервера. Если окно уже закрыто, снова войдите на сервер, как в шаге 2.
2. Скопируйте команду, вставьте в терминал сервера и нажмите Enter:

hermes gateway setup

3. В меню выберите Telegram. Когда увидите запрос bot token, скопируйте секретную строку из чата с BotFather и вставьте в поле мастера на сервере. В поле allowed user IDs вставьте цифры вашего ID, которые прислал @userinfobot. Сохраните настройки. Остальные мессенджеры пока не нужны.
4. Чтобы бот работал после закрытия терминала, установите и запустите фоновую службу одной командой на сервере:

hermes gateway install --start-now

Если мастер уже установил и запустил службу, повторно устанавливать её не нужно. Посмотрите состояние:

hermes gateway status

5. В Telegram откройте личный чат со своим ботом по имени из BotFather. Нажмите «Начать», отправьте Привет! Ответь одним предложением. Бот должен ответить. Затем закройте окно терминала и отправьте ещё одно сообщение: если ответ есть, бот продолжает работать без открытого терминала.

Если после закрытия терминала бот замолчал, войдите на сервер снова и выполните hermes gateway status. На некоторых Linux-серверах пользовательскую службу нужно дополнительно настроить на работу после выхода из учётной записи; здесь лучше следовать сообщению установщика или инструкции вашего VPS-провайдера, а не копировать неизвестные команды с правами администратора.

7. Поручите первому боту задачу временному второму агенту

Агент — программа, которая читает ваше задание и пользуется доступными ей инструментами. Делегирование — первый агент отдаёт одну небольшую задачу временному помощнику (delegate_task), получает его результат и отвечает в том же чате. Этот помощник — не второй Telegram-бот и не отдельный постоянный аккаунт.

1. В чате с работающим ботом Telegram отправьте:

Поручи временному подагенту через delegate_task одну задачу: придумать три понятных названия для заметки «Как ухаживать за комнатным растением». Передай ему эту тему и попроси вернуть ровно три варианта. Сам выбери лучший и объясни выбор одним предложением. Напиши, удалось ли действительно вызвать delegate_task; не выдавай обычный ответ за делегирование.

2. Дождитесь ответа. Успех — бот сообщает результат работы подагента и указывает, что воспользовался delegate_task (если интерфейс показывает действия инструментов, можно проверить вызов там). Если бот просто придумал названия сам или сообщил, что инструмента нет, делегирование не проверено. Вернитесь в терминал VPS, откройте настройку инструментов:

hermes tools

3. В интерфейсе инструментов найдите Telegram и delegation / delegate_task, включите его для Telegram, сохраните выбор. Если он вообще отсутствует, повторите настройку hermes setup без режима Blank Slate, затем проверьте список инструментов снова. После изменения инструментов отправьте боту новое сообщение с тем же заданием. В разных версиях состав меню может отличаться; не подменяйте проверку уверенным ответом модели.

У подагента нет полной истории вашего чата: передавайте задачу и нужные факты в одном сообщении. Он наследует доступные первому агенту инструменты, но не получает новых прав сам по себе. Делегированная работа временная: не рассчитывайте, что она переживёт остановку процесса или будет работать неделями.

Если что-то пошло не так

• Permission denied при SSH — проверьте в панели VPS пользователя и пароль; при входе с ключом нужен способ подключения из инструкции провайдера. Пароль при вводе не отображается.
• Connection timed out или SSH не подключается — проверьте, запущен ли VPS, правильно ли скопирован IP, разрешён ли SSH в панели/правилах сети провайдера. Не открывайте лишние порты «на всякий случай».
• curl: command not found / установщик остановился — проверьте требования официальной установки: нужны curl, Git, tar и утилита SHA-256. Если установщик просит системную библиотеку или права администратора, следуйте его конкретному сообщению или обратитесь в поддержку VPS. Не выполняйте случайные команды с sudo из чужих комментариев.
• hermes: command not found — переподключитесь по SSH либо выполните source ~/.bashrc на VPS; проверьте, что установка завершилась без ошибок.
• Hermes в терминале не отвечает — сначала hermes doctor, затем проверьте выбранную модель, разрешённую страну, авторизацию, баланс/лимит у её поставщика. Смена страны сервера не гарантирует решения.
• Бот молчит — откройте личный чат и отправьте /start; на сервере проверьте hermes gateway status. Проверьте токен в hermes gateway setup и цифры своего ID. Для просмотра ошибок используйте hermes logs errors; перед передачей кому-либо уберите из вывода токены и личные данные.
• Бот пишет unauthorized — в списке разрешённых ID в hermes gateway setup должен быть ваш числовой Telegram User ID, не username бота и не @nickname.
• delegate_task недоступен — проверьте hermes tools именно для Telegram и не используйте Blank Slate без включения делегирования. Попросить модель «представить, что она делегировала» — не проверка.
• После закрытия окна бот замолчал — войдите на сервер снова, выполните hermes gateway status и сверьте шаг 6.

Необязательно: второй постоянный бот

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

Если первый бот уже проверен, создайте у BotFather ещё одного бота через /newbot, сохраните его новый токен. На том же VPS введите по очереди:

hermes profile create research

hermes -p research setup

Во втором мастере отдельно выберите модель и способ входа; токен или ключ модели вводите только туда. Затем:

hermes -p research gateway setup

Здесь укажите новый токен второго бота и тот же ваш числовой ID для доступа. Не вставляйте токен первого бота. Для проверки состояния:

hermes -p research gateway status

Способ запуска второго профиля зависит от версии Hermes: одни установки обслуживают профили одной общей службой, другие предлагают отдельную службу. Сначала напишите второму боту Привет в личном чате. Если он отвечает, больше ничего запускать не нужно. Если не отвечает и hermes -p research gateway status показывает остановленную отдельную службу, введите на VPS по одной строке:

hermes -p research gateway install

hermes -p research gateway start

Проверьте hermes -p research gateway status и напишите второму боту снова. Если статус говорит, что профиль уже обслуживает общая служба, не создавайте вторую поверх неё: сверяйтесь с официальной инструкцией по профилям. Не запускайте две копии шлюза и не используйте токен первого бота. Два отдельных чата сами по себе не заставляют ботов разговаривать друг с другом: это отдельная задача, а для первого опыта достаточно делегирования из шага 8.