Гермес — ИИ-агент, который живёт на твоём сервере и отвечает тебе в Telegram. Пишешь ему как человеку, он отвечает. Думает он моделью GPT по твоей подписке ChatGPT, поэтому за API отдельно платить не нужно.
Ставится всё одной программой для Windows. Вписал адрес сервера и пароль, отметил Telegram, вошёл в ChatGPT, и агент уже отвечает. Командами Linux пользоваться не нужно.
Что понадобится
Сервера ещё нет? Как арендовать его на Hetzner, по шагам расписано в гайде «Собственный VPN для Claude».
Если VPN у тебя уже стоит, ставь Гермес на тот же сервер. Установщик не трогает на сервере ничего чужого: сайты, VPN, файрвол, порты и другие службы остаются как были.
Часть 1
Ставим агента
Шаг 1. Разреши в ChatGPT вход по коду
На сервере нет браузера, поэтому агент входит в ChatGPT по коду. Ссылку ты откроешь у себя на компьютере и введёшь там код, который покажет установщик.
Такой вход надо один раз разрешить. Открой ChatGPT в браузере, зайди в настройки, раздел безопасности, и включи вход по коду устройства (device code). Если аккаунт рабочий (Business, Enterprise, Edu), это включает администратор твоей команды.
Шаг 2. Создай бота в Telegram
- Открой @BotFather и нажми «Start».
- Отправь
/newbot. - Напиши имя бота. Его увидят собеседники, например «Мой помощник».
- Напиши короткое имя латиницей. Оно должно заканчиваться на
bot, напримерmy_helper_bot. - BotFather пришлёт токен, длинную строку вида
1234567890:AAH.... Скопируй её.
Ещё пригодится твой числовой ID в Telegram, его покажет @userinfobot. С ним агент ответит тебе сразу. Можно и без него: тогда разрешишь себя в виджете после первого сообщения, это шаг 5.
Шаг 3. Запусти установщик
Скачать установщик для WindowsHermesAgent-Setup-0.1.0.exe, 292 КБ.
Запусти файл. Если Windows покажет синее окно «Windows защитила ваш компьютер», нажми «Подробнее», а потом «Выполнить в любом случае».
Сервер

- В «Адрес сервера» впиши IP-адрес из письма хостинга.
- «Пользователь» оставь
root. - Выбери «Пароль» и вставь пароль root из того же письма.
- Нажми «Установить».
Если входишь на сервер ключом SSH, выбери «Ключ SSH» и укажи файл ключа. Пароль установщик нигде не сохраняет. Он кладёт на сервер ключ твоего компьютера, и дальше виджет входит этим ключом.
Установка

Установщик проверяет систему, ставит Гермес и запускает его службу. Дольше всего идёт «Ставлю Гермес», это несколько минут. Окно в это время не зависло. Подробности видно по кнопке «Журнал».
Если на сервере уже стоит Гермес, поставленный раньше по-другому, установщик спросит, что с ним делать. «Убрать и продолжить» сложит данные старого агента в архив на сервере и удалит его. «Отмена» остановит установку, старый агент останется как был.
Каналы

Отметь Telegram, под ним появятся два поля:
- Telegram bot token: токен от BotFather.
- Allowed Telegram user IDs: твой числовой ID. Можно оставить пустым.
Поля на английском, потому что их названия приходят от самого Гермеса. Нажми «Далее».
Вход в ChatGPT

- Страница OpenAI откроется в браузере сама. Если не открылась, нажми «Открыть».
- Войди в свой аккаунт ChatGPT.
- Нажми «Копировать» рядом с кодом, вставь код на странице OpenAI и подтверди.
Окно само перейдёт дальше, когда вход закончится. На вход есть 15 минут. Не успел, нажми «Повторить». Если OpenAI пишет, что вход по коду выключен, вернись к шагу 1.
Готово

Установщик сам отправил агенту проверочное сообщение и показывает его ответ. Все галочки зелёные, значит всё работает.
Галочка «Виджет при входе в Windows» запускает виджет вместе с Windows. Нажми «Готово», и откроется виджет. Его значок остаётся в трее рядом с часами.
Шаг 4. Напиши агенту
Открой Telegram, найди бота по короткому имени, например @my_helper_bot, нажми «Start» и напиши «Привет, что ты умеешь?». Если ты вписал свой ID при установке, агент ответит сразу.
Шаг 5. Пусти себя к агенту
Если поле ID осталось пустым, бот пока никого не знает. На первое сообщение он ответит коротким кодом, а в виджете появится запрос.

Щёлкни по значку в трее, чтобы открыть виджет. В запросе будет имя, ID и мессенджер. Нажми «Разрешить», проверь, что это ты, и нажми «Разрешить» ещё раз. Потом напиши боту снова.
Так же пускаешь других людей: пусть напишут боту, а ты разрешишь их в виджете. Незнакомцев без разрешения бот не обслуживает. Запрос живёт час, потом человеку надо написать заново.
Часть 2
Виджет и мессенджеры
Виджет
Виджет — стеклянное окошко на рабочем столе. Оно показывает, как дела у агента, и даёт им управлять. Лежит под окнами программ и работать не мешает. Двигается за любое свободное место, размер меняется за край.
В шапке три кнопки: ⟳ проверяет всё сразу, — сворачивает виджет в полоску у края экрана, … открывает меню. Меню открывается и правым щелчком по виджету.

Точка на значке в трее сразу говорит, всё ли в порядке:
Наведи мышь на значок, и подсказка коротко назовёт причину. Статусы виджет обновляет сам: раз в минуту, пока он на экране, и раз в пять минут, пока спрятан в трей.
Что умеют кнопки
- Каналы: включить, выключить или поменять мессенджеры.
- Модель: выбрать модель GPT.
- Перезапуск: перезапустить агента, если он завис.
- Журнал: последние записи агента. Пароли и токены туда не попадают.
- Войти заново: войти в ChatGPT ещё раз, например в другой аккаунт.
- Обновить: поставить свежую версию Гермеса. Настройки, каналы и вход в ChatGPT сохранятся. Пока идёт обновление, обычно несколько минут, агент не отвечает.


У WhatsApp нет полей, его привязывают QR-кодом, как WhatsApp Web. Отметь WhatsApp в «Каналах» и выбери режим:
- Отдельный номер: у агента свой номер, люди пишут на него. Нужна вторая SIM-карта или виртуальный номер, на котором ещё нет WhatsApp. Так надёжнее и меньше риск блокировки.
- Свой номер: агент сидит в твоём WhatsApp, и ты пишешь ему в чат с самим собой. Подходит, чтобы попробовать, но писать агенту сможешь только ты.


Нажми «Сохранить», появится QR-код. На телефоне с нужным номером открой WhatsApp, зайди в настройки, «Связанные устройства», «Привязка устройства», и наведи камеру на код. Код обновляется примерно раз в 20 секунд, это нормально. Когда привязка пройдёт, окно напишет «WhatsApp подключён».
Если отвязал устройство или сменил телефон, открой «Каналы», под WhatsApp отметь «Привязать заново» и нажми «Сохранить». Если аккаунт WhatsApp защищён ключом доступа (passkey), привязка может не пройти. Тогда бери отдельный номер без ключа.
Discord
- Открой Discord Developer Portal и нажми «New Application».
- Слева «Bot». Включи Message Content Intent и Server Members Intent и сохрани. Без Message Content Intent бот не подключится.
- Там же нажми «Reset Token» и скопируй токен.
- Слева «Installation»: отметь
botиapplications.commands, открой ссылку приглашения и добавь бота на свой сервер Discord. - Свой ID: в настройках Discord, «Расширенные», включи «Режим разработчика». Потом правый щелчок по своему имени, «Копировать ID пользователя».
В «Каналах» отметь Discord, вставь токен в Discord bot token, а ID в Allowed Discord user IDs.
Slack, Signal и остальные
Slack сложнее остальных: нужно создать приложение и получить два токена, xoxb-… и xapp-…. Пошагово это есть в документации Гермеса.
Signal работает только с отдельной программой signal-cli на сервере. Установщик её не ставит, это работа для тех, кто уверенно чувствует себя в консоли сервера. Если не хочется, выбери другой мессенджер.
Mattermost, Matrix, почта и другие подключаются как Telegram: отметь канал и заполни поля. Что значит каждое поле, написано на странице мессенджеров в документации Гермеса.
Mac вместо сервера
Агента можно поставить на Mac, который всегда включён.
- На Mac: «Системные настройки», «Основные», «Общий доступ», включи «Удалённый вход».
- В установщике в «Пользователь» впиши имя своей учётной записи Mac, не root. Учётная запись должна быть администратором.
- В «Пароль» впиши пароль этой учётной записи.
Агент работает, пока ты вошёл в систему, и Mac не должен засыпать. Запрети автоматический сон в «Аккумуляторе» или «Энергосбережении».
Часть 3
Если что-то не так
Если установка не прошла, окно покажет, на каком шаге и почему.

«Назад» вернёт к окну «Сервер»: поправь адрес или пароль и нажми «Установить» снова. Установку можно запускать сколько угодно раз, настройки и вход в ChatGPT сохраняются.
Частые ошибки
- «Сервер не принял пароль.» Скопируй пароль из письма хостинга и вставь через Ctrl+V.
- «Сервер просит сменить временный пароль.» Зайди в консоль сервера в панели хостинга, смени пароль и впиши новый.
- «Сервер не отвечает.» или «Нет связи с сервером.» Проверь адрес и что сервер включён в панели хостинга.
- «Эта система не поддерживается…» На сервере другая система. Переустанови её в панели хостинга на Ubuntu 24.04 и запусти установку ещё раз. На сервере при этом ничего не изменено.
- «Для нужных программ apt обновит или удалит уже стоящие пакеты…» Установщик сам систему не обновляет, чтобы не перезапустить чужие службы. Обнови её (
apt upgrade) в удобное время и запусти установку снова. - «Служба агента запускается и сразу падает.» Причина в последних строках «Журнала». Запусти установку ещё раз: она исправляет установку и сохраняет настройки.
- «В Windows нет ssh.exe.» Включи клиент OpenSSH: «Параметры», «Система», «Дополнительные компоненты», добавь «Клиент OpenSSH».
Агент не отвечает
Открой виджет. Если в строке Telegram ошибка «Unauthorized», токен неверный: впиши новый в «Каналах». Если строка зелёная, а ответа нет, загляни в запросы доступа. В строке ChatGPT «нет входа» — нажми «Войти». «Лимит подписки» — агент снова ответит, когда лимит ChatGPT обновится.
«Ключ сервера изменился»
Это значит, что сервер отвечает не тем ключом, который твой компьютер запомнил при установке. Нормально это только в одном случае: ты точно знаешь, что систему на сервере переустанавливали.
Если никто ничего не переустанавливал, не жми «Забыть сервер» и не вводи пароль. Подменённый сервер мог бы так получить твой пароль. Напиши в поддержку хостинга.
Если систему переустанавливали, нажми «Забыть сервер». Установщик покажет новый отпечаток ключа. Сравни его с тем, что выдаст консоль сервера в панели хостинга на команду ssh-keygen -lf /etc/ssh/ssh_host_ed25519_key.pub. Совпадают — нажимай «Забыть» и ставь заново. Не совпадают — жми «Отмена» и пароль не вводи.
Как удалить агента

Меню, «Удалить с сервера». Виджет остановит агента, удалит Гермес с настройками, каналами и входом в ChatGPT, уберёт ключ твоего компьютера и свои файлы. Всё остальное на сервере остаётся как было. Если удаление оборвалось, нажми ещё раз: оно продолжится с того места, где остановилось.

