Свой AI-агент 24/7
в Telegram (Hermes)

Что получим. Автономный AI-агент Hermes (open-source от Nous Research), который живёт на твоём сервере, а общаешься ты с ним в Telegram — с телефона, откуда угодно. Мозг — Codex по подписке ChatGPT (или китайские Qwen/Kimi, см. ниже). Ноут можно закрыть: агент работает на сервере, а не у тебя на машине.

Это продолжение гайда 1: сервер за рубежом у тебя уже есть (или закажи по нему — шаги те же). Нет сервера и не хочется? — есть Часть 2, ставим прямо на свой комп.

🤖 Лень делать руками? Наш бот @hermes_notabag_bot делает весь этот сетап под ключ внутри Телеги: от тебя — только войти в OpenAI и ответить на вопросы про свой бизнес. На выходе — готовый персональный агент. Гайд ниже — для тех, кто хочет сам и бесплатно.

Что понадобится

• 🖥️ Сервер из гайда 1 — подходит любой оттуда (не в РФ, от 2 ГБ RAM). Нет сервера и не хочется? — ставим прямо на свой комп.
• 🔑 Подписка ChatGPT (Plus достаточно) — мозг подключим через Codex CLI по подписке. ⚠️ Не по API-ключу: там оплата за каждый токен, у активного агента это в разы дороже фиксированной подписки.
• 🤖 Telegram bot-токен — сделаем по ходу в @BotFather, это 1 минута.

Шаг 1. Заходим на сервер

Открой Терминал (Mac) или PowerShell (Windows) и подключись — одна команда:

$ ssh root@IP-СЕРВЕРА
Пароль root (из письма хостера):
❯ ••••••••← вводишь ты
при вводе пароль не виден — это норма, просто вставь и Enter

Увидел приглашение root@...:~# — ты на сервере. Всё, дальше просто вставляешь команды по шагам.

💡 Про «мощность» думать не надо. Сервер из гайда 1 уже подходит — ничего проверять и крутить не нужно. Единственный редкий край: если взял совсем слабый 1 ГБ-бокс и позже агент будет падать по памяти — добавь подкачку (swap) одной командой:

Копировать

fallocate -l 3G /swapfile && chmod 600 /swapfile && mkswap /swapfile && swapon /swapfile && echo '/swapfile none swap sw 0 0' >> /etc/fstab

Шаг 2. Ставим Hermes — одна команда

Установщик сам притащит весь рантайм (uv, Python 3.11, Node.js, ripgrep, ffmpeg) и самого агента:

$ curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash
⏳ несколько минут на слабом CPU — не прерывай
Starting setup wizard...

🐛 Установка падает на uv с ошибкой curl: (35) … SSL_ERROR_SYSCALL … astral.sh? Баннер Hermes уже нарисовался, а потом обрыв — установщик качает вспомогательную тулзу uv с домена astral.sh, и его часто сбрасывает (особенно на своём Маке из РФ без VPN — это ровно тот случай, когда нужен туннель из гайда 1). Чиним:

1. Включи VPN из гайда 1 и просто повтори команду — обрыв часто разовый, со вторым заходом проходит.

2. Если astral.sh всё равно не открывается — поставь uv руками и положи туда, где его ждёт установщик (тогда он пропустит эту закачку):

ты@macbook: ~Копировать команды

$ brew install uv
$ mkdir -p ~/.hermes/bin && ln -sf "$(which uv)" ~/.hermes/bin/uv
$ curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash
Managed uv found ✓

На VPS (не-РФ) такое почти не встречается — если да, повтори команду или поставь uv из GitHub-релиза astral-sh/uv.

В конце запустится визард первичной настройки. Самый важный выбор:

How would you like to set up Hermes?
  1. Quick Setup (Nous Portal) — free OAuth login, no API keys...
  2. Full setup — configure every provider, tool & option yourself (bring your own keys)
  3. Blank Slate — everything off except the bare minimum...
❯ 2← вводишь ты

Выбираем Full setup — bring your own keys: мы подключаем свою подписку, а не Nous Portal.

Дальше визард спросит провайдера. В списке OpenAI будет два пути — Codex CLI и direct OpenAI API:

Select provider:
  OpenAI — Codex CLI or direct OpenAI API
❯ Codex CLI (via ChatGPT subscription)← вводишь ты

Выбирай Codex CLI — вход по подписке ChatGPT. Визард даст ссылку и код устройства: открой ссылку в браузере на своём компе, войди в аккаунт ChatGPT и введи код. Остальные секции визарда (терминал, тулзы) можно прощёлкать Enter'ом — дефолты норм.

🔴 Не подключай OpenAI по API-ключу. API тарифицируется за каждый токен, а агент жжёт их тысячами на любую задачу — счёт легко улетает в десятки долларов в день. Подписка ChatGPT — фиксированная цена, и Codex работает в её лимитах. API-путь оставь на случай, когда точно знаешь, зачем он тебе.

Не хочешь OpenAI? Китайские модели — Qwen / Kimi

В том же списке провайдеров есть достойные альтернативы без OpenAI:

• Qwen (Alibaba) — путь Qwen CLI OAuth: бесплатный вход через аккаунт qwen.ai, платить не надо вообще (есть дневные лимиты запросов). Для старта — самый дешёвый вариант из всех.
• Kimi (Moonshot) — Kimi Coding Plan: дешёвая подписка уровня «пара долларов», модели kimi-k2/k3 хорошо держат агентские задачи.

Выбираются в этом же визарде, а переключиться можно в любой момент командой hermes model.

💡 Формулировки в визарде от версии к версии слегка меняются — но смысл выбора тот же: «свои ключи», провайдер по подписке, не по API.

Шаг 3. Проверка — doctor

$ hermes doctor --fix
✓ OpenAI Codex auth (logged in)
$ hermes config | head -40
model:
  default: gpt-5.5
  provider: openai-codex

provider: openai-codex — это и есть мозг-Codex. --fix заодно чинит симлинк hermes в PATH, если что-то не так.

⚡ Залипло на ошибке или хочешь разбираться в таких сетапах сам? В комьюнити letsvibecode обучающий бот и люди, которые это уже прошли.

Шаг 4. Создаём бота в Telegram

1. Открой @BotFather → команда /newbot → придумай имя и юзернейм (кончается на bot).
2. BotFather выдаст токен вида 123456789:AAE3... — скопируй его.
3. Узнай свой Telegram ID: напиши боту @userinfobot, он ответит числом.

⚠️ Токен — это пароль от бота. Не вставляй его в голую командную строку (останется в истории bash) — только в промпт визарда на следующем шаге. Засветил — отзови через /revoke у BotFather и получи новый.

Шаг 5. Подключаем Telegram-шлюз

$ hermes gateway setup
Which platform would you like to set up?
❯ Telegram← вводишь ты
Bot token:
❯ 123456789:AAE3...   (токен от @BotFather)← вводишь ты
Allowed user IDs:
❯ 987654321   (твой ID от @userinfobot — только ты сможешь юзать бота)← вводишь ты
Home channel:
❯ Y   (твой же ID)← вводишь ты
Start the gateway now?
❯ Y← вводишь ты
Start the gateway automatically on login/boot as a systemd service?
❯ Y← вводишь ты

На VPS под root визард поставит системный systemd-сервис hermes-gateway — бот будет жить 24/7 и сам подниматься после ребута сервера.

$ systemctl is-active hermes-gateway
active

Шаг 6. 🐛 Если бот молчит — грабля с python-telegram-bot

На части сборок визард не доставляет библиотеку Telegram, и бот молча не отвечает. Смотрим логи:

$ journalctl -u hermes-gateway -n 20 --no-pager
Telegram: python-telegram-bot not installed

Есть такая строка — чиним. ⚠️ Venv у Hermes создан через uv, в нём нет pip — поэтому сначала ставим pip через get-pip, потом библиотеку:

$ curl -sS https://bootstrap.pypa.io/get-pip.py -o /tmp/get-pip.py && /usr/local/lib/hermes-agent/venv/bin/python /tmp/get-pip.py && /usr/local/lib/hermes-agent/venv/bin/python -m pip install python-telegram-bot
Successfully installed python-telegram-bot-...
$ systemctl restart hermes-gateway

💡 Если ставил не под root, venv лежит в ~/.hermes/hermes-agent/venv — подставь этот путь.

Шаг 7. Проверяем в Телеге

1. Открой своего бота → Start.
2. Напиши: привет, ты живой? — должен ответить (мозг gpt-5.5/Codex).

Не отвечает — снова в логи: journalctl -u hermes-gateway -n 30 --no-pager. Варнинга про telegram быть не должно, твой ID должен быть в allowed users.

✅ Готово: Hermes живёт на VPS 24/7, пишешь ему с телефона. Дальше — Часть 3: рассказываем боту про бизнес, добавляем в группы и настраиваем поведение прямо из Телеги.

Вариант без сервера: агент живёт прямо на твоём компе. Минус честный — работает, пока комп включён и не спит. Закрыл ноут — бот замолчал. Для «попробовать» и дневной работы — отлично; для 24/7 — Часть 1, VPS.

⚠️ Из России нужен включённый VPN из гайда 1 (OpenAI режет российские IP). Проверь до установки: ip.me должен показывать не-РФ страну — и держи туннель включённым, пока пользуешься агентом. С китайскими Qwen/Kimi (Часть 1) таких проблем меньше.

Mac (и Linux)

Открой Терминал и запусти ту же команду, что и на сервере:

$ curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash
Starting setup wizard...
How would you like to set up Hermes?
❯ 2   (Full setup — bring your own keys)← вводишь ты

Дальше всё ровно как в Части 1, шаги 2–5: провайдер OpenAI → Codex CLI по подписке ChatGPT (не API!) → hermes doctor --fix → бот у BotFather → hermes gateway setup. Разница одна: на Mac визард предложит автозапуск не через systemd, а как launchd-сервис — тоже отвечай Y, шлюз будет подниматься при входе в систему.

Поболтать с агентом можно и без Telegram, прямо в терминале:

$ hermes
Hermes › привет! чем займёмся?

Windows

Открой PowerShell (обычный, админ не нужен) и запусти:

$ iex (irm https://hermes-agent.nousresearch.com/install.ps1)
установщик сам притащит uv, Python 3.11, Node.js, ripgrep, ffmpeg и портативный Git
Starting setup wizard...

Дальше — тот же визард и те же шаги, что в Части 1: Full setup → OpenAI → hermes gateway setup → Telegram. Автозапуск шлюза на Windows визард оформит через Scheduled Task — соглашайся.

💡 Есть WSL2? Можно ставить и внутри WSL той же bash-командой, что на Mac. Но учти: фоновые сервисы в WSL не переживают его перезапуск — тогда держи шлюз в переднем плане (hermes gateway run) или через tmux.

Что дальше

• Бот отвечает, пока комп не заснул. На Mac запрети сон при закрытой крышке (Настройки → Батарея) или используй caffeinate, если нужен «почти 24/7».
• Надоело держать комп включённым — перенеси агента на VPS по Части 1: та же установка, те же ответы визарду.
• Хочешь прокачаться в вайб-кодинге системно — комьюнити letsvibecode, обучающий бот внутри.
• Фишки, группа в Телеге и шпаргалка команд — в Части 3.

Первым делом — расскажи боту про свой бизнес

Пустой агент — бесполезный агент. Сразу после запуска отправь ему сообщение-брифинг и попроси запомнить:

«Запомни: я — [кто ты], у меня [бизнес/проект такой-то]. Клиенты — [кто]. Продукты и цены: [...]. Пишем в стиле [...]. Чего не делаем: [...]»

У Hermes есть долгая память — он сохранит это и будет опираться в каждом ответе. Дополняй по ходу: «запомни, с этим клиентом договорились о…». Чем больше контекста скормишь в первые дни, тем меньше будешь повторяться потом.

Для жёсткой «прошивки» характера и правил есть файл ~/.hermes/SOUL.md на сервере — что написано там, бот считает своей личностью и инструкциями. Открой и отредактируй под себя:

$ nano ~/.hermes/SOUL.md

Бот в группе: тема = подпроект

Добавлять агента в рабочие чаты — самая сильная фишка. Как делать правильно:

1. В @BotFather: /mybots → твой бот → Bot Settings → Allow Groups → ON.

2. Структура. Заведи супергруппу с темами (в настройках группы включи «Темы»/Topics) и держи структуру одна тема = один подпроект: «Маркетинг», «Клиент X», «Сайт», «Бухгалтерия»… У каждой темы — свой отдельный контекст диалога: бот не смешивает обсуждение клиента X с задачами по сайту, а ты всегда знаешь, где что искать.

3. Отвечать на всё или только по @упоминанию? Это настраивается в BotFather → Bot Settings → Group Privacy:

• Privacy ON (по умолчанию) — Telegram показывает боту только @меншены, реплаи на его сообщения и команды. Бот отвечает только когда позвали — режим «эксперт в углу». 👍 Рекомендую для чатов с людьми.
• Privacy OFF — бот видит все сообщения группы и может участвовать в любом разговоре — режим «полноценный участник». Для личной группы «я + бот» — самое то.

⚠️ Менял Group Privacy, когда бот уже сидел в группе? Удали его из группы и добавь заново — иначе настройка не подхватится.

4. Тонкая настройка на стороне Hermes (если Privacy OFF, но хочется отвечать всё-таки по меншену):

$ cat >> ~/.hermes/config.yaml <<'EOF'
 
platforms:
  telegram:
    require_mention: true
    guest_mode: true
EOF
$ systemctl restart hermes-gateway

• require_mention: true — даже видя всё, бот отвечает только на @меншен, реплай или команду.
• guest_mode: true — можно дёрнуть бота @меншеном из группы, которую ты не вносил в белый список чатов.

Настройка на лету — прямо из Телеги

Не нужно лезть на сервер по каждому чиху: у бота есть меню команд (кнопка «/» в поле ввода):

• /model — сменить модель/провайдера прямо из чата (например, перескочить с Codex на Qwen).
• /new — начать новый диалог с чистым контекстом (память при этом остаётся).
• /stop — остановить текущую задачу, если бот увлёкся.
• /status — что бот сейчас делает и какая модель активна.
• /usage — расход лимитов за сессию.
• /help — полный список команд.

Из терминала то же самое и глубже: hermes model (модель), hermes config edit (весь конфиг ~/.hermes/config.yaml), hermes gateway setup (перенастроить Telegram).

Не хочется возиться? Сетап под ключ — @hermes_notabag_bot

Всё, что описано в трёх частях, наш бот @hermes_notabag_bot делает сам, внутри Телеги: поднимает сервер, ставит Hermes, подключает мозг и сам собирает брифинг о твоём бизнесе — от тебя только вход в OpenAI и ответы на вопросы. Получаешь готового персонального агента, как из этого гайда, но без единой команды в терминале.

Шпаргалка

На минимальном Debian ты и так root — sudo не нужен. На Mac команды systemctl заменяются на hermes gateway status / restart.

Грабли, которые мы поймали (чтобы ты не наступил)

1. OpenAI по API-ключу — деньги в трубу. Агент жжёт токены тысячами; подключай Codex по подписке ChatGPT (или бесплатный Qwen OAuth) — Часть 1, Шаг 2.
2. 1 ГБ RAM мало — Hermes+Codex уходят в OOM. Минимум 2 ГБ или swap (Часть 1, Шаг 1).
3. Из РФ без VPN не заведётся — на своём компе держи туннель из гайда 1 включённым: OpenAI режет российские IP.
4. Установка падает на uv (SSL_ERROR_SYSCALL … astral.sh) — домен astral.sh режется (Мак из РФ без VPN). Включи VPN и повтори; либо brew install uv + симлинк в ~/.hermes/bin/uv (Часть 1, Шаг 2).
5. uv-venv без pip — внутри venv Hermes нет pip/ensurepip; библиотеки доставлять через get-pip (Часть 1, Шаг 6).
6. Бот молчит после установки — почти всегда это либо не доставленный python-telegram-bot (лечится там же), либо твой ID не попал в Allowed users.
7. Шлюз должен быть сервисом — соглашайся на автозапуск в визарде, иначе бот умрёт, как только закроешь SSH-сессию.
8. Токен бота не светить в bash — только в промпт визарда. Засветил — /revoke у BotFather.