Hermes нужен как «операционная система» для AI-агента — это слой, который связывает между собой модель, Telegram, память, рабочую папку, инструменты и правила безопасности. В гайде эту связку часто называют словом gateway — это просто внутренняя «прослойка» Hermes, которая принимает ваши сообщения из Telegram, передаёт их модели и возвращает ответ.

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

То есть Codex/Claude Code помогают установить агента на сервер, а Hermes — место, где агент дальше живёт.

Hermes не "лучше всех во всём" — он лучше именно для сценария: личный AI-помощник на вашем сервере, который отвечает в Telegram, помнит вас и постепенно учится под ваши задачи.

Чтобы не запутаться в названиях: Codex и Claude Code — это ИИ-инструменты, которые помогают установить Hermes. OpenClaw — другая открытая платформа для личного агента, посложнее. Hermes — то, что в итоге будет жить на вашем сервере и общаться с вами в Telegram.

Рекомендуемый сервер:
Ubuntu 22.04 LTS или 24.04 LTS;
2 CPU;
4 GB RAM;
30–40 GB SSD;
root-доступ;
сервер лучше брать не в РФ.

Для участников из РФ обычно проще:
Timeweb Cloud;
AdminVPS;
любой другой VPS, где можно получить чистую Ubuntu и root-пароль.

После покупки сервера вам нужны:
IP сервера;
пользователь root;
пароль root.

Ничего вручную на сервере заранее настраивать не нужно. Вся установка пойдёт через Codex/Claude Code.

Как зарегистрироваться у VPS-провайдера, купить чистый Ubuntu-сервер, выбрать тариф, найти IP и root-пароль.

VPS-сервер
IP;
root-пароль;
Ubuntu 22.04/24.04.

Доступ к OpenAI Codex
аккаунт OpenAI / ChatGPT;
подписка или доступ, где работает Codex;
возможность пройти device-code авторизацию.

Telegram-бот
создаётся через @BotFather;
нужен Bot API token;
нужен ваш Telegram user ID.

Доступ к Codex / Claude
Для установки вам нужен ИИ-оператор, который умеет работать с файлами и терминалом. Например:
Codex CLI;
Claude Code;
другой ИИ-агент, который может читать архив, подключаться к серверу и выполнять установку.
Обычный чат без доступа к вашему компьютеру и терминалу сам не сможет зайти на сервер. Он может объяснить, но не сделает установку за вас.

Дальше Codex/Claude будет вести установку сам. В процессе он может попросить подтверждения на несколько действий.

Ваша задача — не писать команды вручную, а дать ИИ-оператору архив и понятное задание.
Приложите архив к чату/сессии Codex или Claude и отправьте промпт ниже.

Ты работаешь как DevOps-оператор. Твоя задача — установить Hermes Agent на чистый VPS без Docker, подключить Telegram и подготовить нейтрального персонального ассистента. Что сначала спросить у пользователя Попроси только эти данные: IP или домен VPS; root password от VPS; Telegram bot token от BotFather; Telegram allowed users: numeric Telegram user IDs, несколько можно через запятую. Не проси SSH user, SSH port, имя системного пользователя и workspace, если пользователь сам не хочет их менять. Используй defaults: root, 22, hermes, /srv/hermes/workspace. Что нужно сделать Прочитай AGENTS.md в этом архиве. Проверь структуру архива. Запусти установку через scripts/local_deploy_via_ssh.sh. Установи Hermes нативно, без Docker. Создай пользователя hermes, рабочую папку /srv/hermes/workspace, .env, SOUL.md, AGENTS.md. Создай systemd-сервис hermes-gateway.service, но не пытайся обходить OAuth. После bootstrap скажи пользователю простыми словами: Сейчас я настрою доступ по SSH-ключу. Это нужно, чтобы входить на сервер без пароля: так безопаснее, пароль не нужно передавать каждый раз, и после проверки ключа можно отключить вход по root-паролю. Подтверждаете? После подтверждения создай отдельный SSH-ключ для этого VPS, установи public key на сервер и проверь вход по ключу. Если SSH-ключ работает, предложи: SSH-ключ работает. Усилим защиту на сервере? После подтверждения включи базовую защиту: ufw, fail2ban, unattended-upgrades, запрет password login, PermitRootLogin prohibit-password. Не меняй SSH-порт. Для Codex/ChatGPT OAuth запусти интерактивно: ssh -i PATH_TO_KEY -p 22 root@SERVER_HOST 'sudo hermes-oauth' В этот момент покажи пользователю device-code/ссылку и дай пройти авторизацию в браузере. После OAuth запусти: ssh -i PATH_TO_KEY -p 22 root@SERVER_HOST 'sudo systemctl daemon-reload && sudo systemctl enable --now hermes-gateway.service && sudo hermes-healthcheck' Не печатай Telegram token и root password в логах. Не включай GATEWAY_ALLOW_ALL_USERS=true. Не запускай gateway от root. Критерии результата В конце дай короткий отчет: где установлен Hermes; какой пользователь запускает сервис; где workspace; статус hermes-gateway.service; где лежит локальный SSH-ключ; включена ли базовая защита; какие команды использовать для логов; что написать боту в Telegram для проверки.

Codex/Claude Code сделает следующие вещи:

1. Подключится к VPS
Он использует IP и root password, чтобы зайти на чистый сервер и подготовить систему.

2. Установит Hermes
Архив установит Hermes прямо на сервере, под отдельным пользователем hermes.

3. Создаст личного ассистента
Его базовая роль:
Помогать пользователю разбирать задачи, делать планы, готовить документы, писать черновики, структурировать информацию и фиксировать повторяемые процессы.

4. Настроит Telegram
ИИ-оператор добавит token от BotFather и ваш Telegram user ID в allowlist.
Это нужно, чтобы бот не отвечал посторонним людям.

5. Настроит SSH-ключ и защиту
Архив предложит создать отдельный SSH-ключ для доступа к серверу. Это нормально и правильно.
Простыми словами: после этого для входа на сервер будет нужен не только пароль, а ключ. Так безопаснее.
После проверки ключа ИИ-оператор может предложить усилить защиту сервера:
включить firewall;
включить защиту от перебора паролей;
включить автоматические security updates;
отключить вход по паролю.
Подтверждайте это только после того, как ИИ-оператор явно проверил, что вход по SSH-ключу работает.

ВАЖНО: ChatGPT/Codex OAuth — это не то же самое, что OpenAI API key. Если вы используете API key, расходы идут по API. В этой сборке основной сценарий — OAuth через Codex/ChatGPT.

Затем раздел "Безопасность" и включить переключатель "Включить авторизацию кода устройства для Codex"

На одном из этапов Hermes попросит подключить модель. Для этой сборки используем путь:

OpenAI Codex → ChatGPT OAuth / device code

Это не полностью автоматизируется. Вам нужно будет:
Получить от ИИ-оператора ссылку и одноразовый код.
Открыть ссылку в браузере.
Войти в свой ChatGPT/OpenAI аккаунт.
Подтвердить авторизацию.
Вернуться к ИИ-оператору и продолжить установку.

Это нормальный этап. OAuth специально устроен так, чтобы человек подтвердил доступ вручную.

ВНИМАНИЕ: Если OpenAI пишет, что нужно включить device-code authorization для Codex, откройте настройки безопасности ChatGPT, включите device-code authorization и попросите Codex дать новый код. Лучше сделать это заранее, до того как будете создавать агента

По шагам со скринами:

Там, где иконка вашего профиля на сайте chatgpt нажмите на нее и нажмите «Настройки»

Введите

/sethome

Это служебная команда Hermes в Telegram.
Смысл /sethome: сделать этот Telegram-чат “домашним каналом” для Hermes.
Если ты введёшь здесь: /sethome то Hermes запомнит: результаты фоновых задач, cron-напоминаний и cross-platform сообщений надо присылать именно в этот чат.

Что это даёт:
cron-задачи: например “каждый день в 9:00 присылай план дня” — будут приходить сюда;
фоновые задачи: если запустится долгая задача и она завершится позже — результат придёт в этот чат;
сообщения между платформами: если Hermes подключён к нескольким каналам, он будет знать, куда слать ответы “по умолчанию”;
домашний Telegram-чат: можно будет писать “отправь в Telegram”, и Hermes поймёт, что это сюда.

Что изменится:
этот чат станет дефолтным адресом доставки;
это не даёт доступ другим людям;
это не публикует твои сообщения;
это не запускает никаких задач само по себе.
Если ты хочешь пользоваться напоминаниями, расписаниями и фоновыми задачами — лучше ввести /sethome.

Если не хочешь, можно игнорировать. Тогда обычный чат со мной продолжит работать, но некоторые функции доставки могут ругаться, что “home channel не задан”.

Затем обычное сообщение:
Кто ты и какая у тебя роль? Ответь коротко.

Если всё работает, бот должен ответить как нейтральный персональный ассистент.

Ещё несколько тестов:

Разбей задачу “навести порядок в личных задачах” на 10 конкретных шагов.

Создай короткий чек-лист подготовки к важному дню.

Что тебе стоит знать обо мне, чтобы помогать лучше? Задай 7 вопросов.

Первый ответ может идти дольше обычного. Это нормально: gateway, модель и сессия могут прогреваться.

Поздравляю! Ты создал своего ИИ-агента на базе Hermes с мозгами от ChatGPT. Далее будет информация про архитектуру и внутреннее устройство агента, чтобы в дальнейшем вы понимали, как улучшать/изменять агента.

После установки откройте личный чат с вашим Telegram-ботом.

Сначала отправьте:
/status

Потом:
/new

Также появится сообщение:

У агента есть несколько уровней контекста.

1. SOUL.md — “каким быть”
Это базовая личность агента: стиль, тон, общие правила.
Например:
Пиши по делу. Сначала результат, потом пояснение. Если данных не хватает — скажи, чего именно не хватает.

2. AGENTS.md — “как работать в этом workspace”
Это правила конкретной рабочей папки. Там можно описать:
какие задачи агент решает;
какие файлы можно менять;
какие процессы важны;
что нельзя делать без подтверждения.

3. MEMORY.md — “что агент узнал о среде”
Например:
Рабочая папка агента находится на сервере. Telegram-доступ ограничен разрешёнными user ID.

4. USER.md — “что агент знает о вас”
Например:
Пользователь любит короткие ответы, чек-листы и конкретные следующие шаги. Пользователь живет в Москве.

Главное правило: не надо превращать память в мусорку. Сохраняйте только то, что реально помогает агенту работать лучше.

Хорошая память:
Пользователь ведёт 3 проекта: личный бренд, Telegram-канал и запуск продукта. Предпочитает короткие планы на 3–7 пунктов.

Плохая память:
Пользователь сегодня спросил про задачи.

После установки не нужно сразу подключать 10 интеграций. Сначала сделайте агента полезным в базовых задачах.

Отправьте ему такой запрос:
Помоги настроить тебя под меня. Сначала задай мне 10 вопросов: 1. чем я занимаюсь; 2. какие проекты сейчас важны; 3. какие задачи я хочу тебе делегировать; 4. как мне удобнее получать ответы; 5. что нельзя делать без моего подтверждения. После вопросов предложи: - что сохранить в USER.md; - что сохранить в MEMORY.md; - какие правила добавить в AGENTS.md; - какие 3 первых сценария автоматизировать.

Потом можно постепенно добавлять роли.

Например:
Хочу, чтобы ты стал моим помощником по планированию недели. Сначала предложи правила работы, потом шаблон еженедельного обзора.

Хочу, чтобы ты помогал с текстами. Сначала задай вопросы про мой стиль, аудиторию и запрещённые формулировки.

Хочу, чтобы ты был моим researcher-ассистентом. Объясни, какие правила проверки фактов тебе нужны.

Несколько рабочих сценариев:
Разбери мои задачи ниже и предложи приоритеты на сегодня.

Сделай план недели по моим проектам. Сначала задай уточняющие вопросы.

Преврати этот хаотичный текст в структурированный документ.

Подготовь черновик сообщения клиенту: спокойно, коротко, без давления.

Составь чек-лист запуска маленького проекта на 7 дней.

Скажи, какие факты из этого сообщения стоит сохранить в память, а какие не нужно.


Базовые правила безопасности

AI-агент на сервере — это не игрушка. У него может быть доступ к файлам, настройкам и внешним сервисам.

Минимальные правила:

• Не открывайте бота всем. Доступ должен быть только по вашим Telegram user ID.
• Не публикуйте Telegram token. Token от BotFather — это ключ к управлению ботом.
• Не передавайте root password в публичные чаты. Используйте только доверенную приватную сессию Codex/Claude.
• Не включайте режим “делай всё без подтверждения”. Для рискованных действий агент должен спрашивать разрешение.
• Не подключайте сразу все интеграции. Чем больше доступов, тем выше риск ошибок.
• Сначала тестируйте чтение, потом запись. Например: сначала “покажи задачи”, потом “создай задачу”.
• Просите агента объяснять план перед изменениями. Особенно если он работает с файлами, сервером или внешними сервисами.
• Хорошая привычка: если агент предлагает что-то изменить, просите его сначала написать план в 3–5 пунктов.

Сначала объясни, что ты собираешься сделать. Ничего не меняй без моего подтверждения.

Шаг 1. Личная настройка
Научите агента вашим проектам, стилю и правилам.
Задай мне вопросы, чтобы понять мой стиль работы, проекты, цели и ограничения. Потом предложи, что добавить в память.

Шаг 2. Один повторяемый сценарий
Например:
план дня;
план недели;
разбор входящих задач;
подготовка сообщений;
выжимка из длинных текстов;
чек-листы перед важными событиями.

Шаг 3. Одна интеграция
Только после базовой настройки можно подключать внешние сервисы:
Notion;
Todoist;
Google Calendar;
GitHub;
Google Docs / Sheets.
Правило: одна интеграция за раз. Подключили → протестировали → понял, что агент работает правильно → только потом добавили следующую.

Шаг 4. Отдельные роли
Когда база работает, можно создавать специализированные режимы:
researcher;
копирайтер;
project manager;
помощник по личным задачам;
ассистент по документам;
технический помощник.
Однако не спешите! Сильный агент получается не от количества ролей, а от понятных правил и хорошего контекста.

Частые вопросы

• Можно ли установить без Codex/Claude?

Можно, но этот гайд сделан не для ручной установки. Для участников клуба проще и безопаснее идти через ИИ-оператора: он читает архив, подключается к VPS и выполняет настройку.

• Почему без Docker?

В этой сборке выбран нативный вариант: Hermes ставится прямо на сервер под отдельным пользователем. Так меньше слоёв, проще отлаживать gateway и OAuth, и новичку не нужно понимать Docker.

• Можно ли дать доступ нескольким людям?

Да, но лучше начинать только с одного Telegram user ID. Когда всё работает, можно добавить ещё ID в allowlist.

• Можно ли подключить его к бизнесу?

Да. Но сначала настройте личную базу: стиль, память, правила, тестовые сценарии. Потом подключайте бизнес-контекст, документы и интеграции.

• Нужно ли каждый раз запускать агента заново?

Нет. После установки gateway работает как постоянный сервис на сервере. Если сервер перезагрузится, сервис должен подняться снова.

• Почему агент иногда ошибается?

Потому что это не “магический сотрудник”, а система из модели, памяти, правил и инструментов. Чем яснее вы задаёте роль, контекст и ограничения, тем лучше результат.

Мини-чек-лист установки

Перед началом:
Куплен чистый VPS.
Есть IP и root password.
Создан Telegram-бот через BotFather.
Сохранён Telegram bot token.
Получен numeric Telegram user ID.
Есть архив airoom-hermes-vds-native-codex-kit.zip.
Есть доступ к Codex/Claude как ИИ-оператору.
Готов ChatGPT/OpenAI аккаунт для Codex OAuth.

После установки:
Codex/Claude сообщил, что Hermes установлен.
OAuth пройден.
Gateway запущен.
Включён Telegram allowlist.
Бот отвечает на /status.
Бот отвечает на обычное сообщение.
SSH-ключ настроен.
Базовая защита сервера включена или запланирована.

Главное
Hermes — это не просто ещё один чат. Это база для личного AI-агента, который живёт на вашем сервере, общается через Telegram, хранит контекст и постепенно превращается в помощника под ваши процессы.

Правильный путь такой:
1. Поставить базу. 2. Проверить Telegram. 3. Добавить личный контекст. 4. Настроить 1–2 полезных сценария. 5. Только потом подключать интеграции и роли.

Не пытайтесь сразу собрать идеального агента. Сначала сделайте простого, стабильного и полезного ассистента. Потом улучшайте его маленькими шагами.