Разработчикам, которые в 2026 повторяют установку Hermes Agent и застревают на PATH, API Key или «молчащем» Telegram, здесь воспроизводимый маршрут: официальный curl в одну строку, hermes setup для модели, hermes gateway с Telegram и launchd/systemd 24/7 на macOS, Linux и облачном Mac KVMNODE. Пять типовых сбоев, таблица четырёх платформ, шесть шагов и таблица ошибок. Перекрёстно: трёхслойная память, отчёт за 30 дней.
01

Что такое Hermes Agent в 2026 и чем он отличается от OpenClaw?

Hermes Agent — MIT-агент Nous Research (2026): долгоживущий процесс, после успешных задач пишет Skill в ~/.hermes/skills/, повторные запросы того же класса потребляют меньше токенов. Это не разовый чат в браузере, а инженер на вашей машине — принимает команды из Telegram, в фоне выполняет shell, поиск, правки репозитория.

Сравнение с OpenClaw: у OpenClaw сильны каналы сообщений и workspace-файлы, экосистема вокруг CLI openclaw; Hermes делает акцент на Closed Learning Loop, трёхслойной памяти (сессия / MEMORY.md / USER.md) и расширениях MCP. LangGraph и CrewAI — многоагентная оркестрация; Hermes ближе к персональному или малой команде resident-ассистенту с входом через один официальный скрипт, без предварительного Python-графа состояний.

Статья про память и «зачем 24/7» — в отдельном материале; здесь только установка, конфигурация, ответы в Telegram, демон. Охват: локальный macOS, Linux VPS/WSL2, прод на облачном Mac.

01

PATH не обновлён: после install сразу hermes → command not found, хотя бинарь уже на диске.

02

Нет API Key: пропущены hermes setup / hermes model — первый диалог падает с API key not set.

03

Сон ноутбука: Gateway умирает при закрытии крышки, Telegram копит сообщения, Skill растут, но кривая «умения» плоская.

04

Group Privacy в Telegram: бот по умолчанию слушает только /; без отключения в BotFather кажется, что «сломался».

05

Headless без флагов: на Linux без --skip-browser или с системным Python — частые ModuleNotFoundError.

Дальше — выбор плоскости развёртывания, затем шесть командных шагов до production Gateway.

02

Где ставить Hermes Agent: MacBook, VPS или аренда Mac Mini?

Официальный install.sh лучше всего проверен на macOS и Linux: ставит uv, Python 3.11, Node.js 22, ripgrep, ffmpeg; репозиторий — ~/.hermes/hermes-agent/. Режим только API + Gateway укладывается в 4 ГБ RAM; локальные модели и browser Skill — от 16 ГБ, на M4 с UMA комфортнее 24 ГБ.

ПлоскостьДоступность 24/7Полнота официального путиНакопление SkillМесячные затраты
Личный MacBookсон ≈60% uptimeвысокая (macOS)частые обрывы¥0 железо + риск
Raspberry Pi 4B 8GB≈88%Linux, без Metalузкое I/Oразовая покупка
x86 VPS 4GB≈99.5%Linux, без Camoufox и др.стабильнее Piпо счётчику
Аренда Mac Mini M4SLA ЦОД, ≈100%максимум (launchd + UMA)непрерывноефикс. OpEx, возврат

На практике команды сначала ставят Hermes на рабочий MacBook, проходят hermes doctor и Telegram-тест, затем переносят ~/.hermes/ на арендованный M4, когда Skill-библиотека и SQLite сессий начинают расти быстрее, чем ноутбук держит Gateway без сна. VPS с 4 ГБ RAM подходит для чистого API-оркестратора без Camoufox; если в roadmap есть скриншоты, автоматизация Safari или локальный Hermes-3 через Metal, Linux-образ экономит CapEx, но срезает половину официальных Skills из реестра Nous. Аренда Mac Mini M4 в KVMNODE даёт тот же install.sh, что в документации GitHub: SSH, ключи в ~/.hermes/.env, launchd для hermes-gateway — без правок путей под «экзотический» хостинг.

Гайд по install решает «запустилось»; выбор платформы — «сколько часов в сутки и копятся ли Skill». Для production Telegram-бота разумна выделенная macOS-нода с фиксированным OpEx и возможностью вернуть железо после 30-дневного PoC.

03

Установка одной командой: curl, doctor, setup

Рекомендуемая строка (macOS / Linux / WSL2 / Termux):

shell
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
source ~/.zshrc
hermes doctor
hermes --version

Скрипт: проверяет и ставит uv; через uv — Python 3.11 без sudo; Node.js 22, ripgrep, ffmpeg; клонирует репозиторий; добавляет hermes в PATH; подтягивает реестр Skills. Успех обычно помечается ✅ Hermes Agent installed at ~/.hermes.

На сервере без GUI отключите браузерный стек:

shell
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash -s -- --skip-browser

hermes doctor проверяет Python, Node, ripgrep, ffmpeg, PATH, ключи API и ещё десяток пунктов. Модель — мастер или точечно:

shell
hermes setup
hermes model
hermes config set OPENROUTER_API_KEY sk-or-xxxx
hermes

Секреты — в ~/.hermes/.env. Поддерживаются Nous Portal, OpenRouter, Anthropic, OpenAI, GitHub Copilot, Ollama и др. Сначала проверьте диалог в CLI, затем поднимайте Gateway.

Совет: после апгрейда при Missing config выполните hermes config check && hermes config migrate. Не запускайте системный Python — используйте ~/.hermes/hermes-agent/venv/bin/hermes.

04

Шесть шагов: Telegram и режим 24/7

01

Бот: в Telegram @BotFather, /newbot, сохраните Token; @userinfobot — ваш числовой ID.

02

Мастер Gateway: hermes gateway setup, канал Telegram, Token и TELEGRAM_ALLOWED_USERS.

03

Пробный запуск: hermes gateway, сообщение боту с телефона — должен ответить.

04

Демон: macOS hermes gateway install && hermes gateway start; Linux — sudo hermes gateway install --system.

05

Группа (опционально): в BotFather отключите Group Privacy, удалите и снова добавьте бота; иначе в группе только /.

06

Облачный Mac: для 24/7 и macOS Skill — оформить заказ на выделенный M4, те же команды по SSH; перед возвратом — архив ~/.hermes/.

shell
hermes gateway setup
hermes gateway install
hermes gateway start
hermes gateway status
journalctl -u hermes-gateway -f

Перед hermes gateway install зафиксируйте версию: hermes --version и вывод hermes gateway status в заметку — при апгрейде v0.15-candidate проще откатить plist. На macOS проверьте launchctl list | grep hermes; на Linux — systemctl status hermes-gateway и хвост journalctl. Если бот отвечает в личке, но молчит в группе, почти всегда виноват Group Privacy, а не firewall: KVMNODE-инстансы по умолчанию не блокируют исходящий HTTPS к api.telegram.org.

При переносе в облако см. чеклист миграции за 30 дней: остановите gateway, tar -czf hermes-backup.tgz ~/.hermes/, scp на новый Mac, снова curl install, распакуйте поверх свежего дерева, перезапустите hermes gateway setup только если меняли Token или whitelist. Слой памяти и cron описан в статье про трёхслойную память — install не заменяет 24/7, но без корректного Gateway миграция бессмысленна.

05

Параметры среды, Skill и типовые ошибки

Три ориентира: ① install тянет Python 3.11 + Node 22, на диск ~1.5 ГБ с кэшем Skills, под локальные модели — 20 ГБ SSD+. ② при попадании в Skill те же задачи дают ~38% меньше токенов (нужен хост 24/7). ③ стабильная ветка июня 2026 — v0.14.x; после v0.15-candidate — hermes config migrate.

ОшибкаПричинаДействие
command not foundPATHsource ~/.zshrc
API key not setмодельhermes model
тишина в группеPrivacyBotFather → Privacy off, перепригласить
нет dotenvсистемный Pythonvenv hermes

MacBook с крышкой — install есть, Gateway нет; дешёвый Linux VPS — Telegram ок, без macOS browser automation и Metal; Raspberry Pi — SQLite и длинные сессии упираются в I/O и swap. После стабилизации v0.14.x имеет смысл завести простой health-check: раз в сутки hermes doctor из cron и алерт, если Gateway не в состоянии running — иначе Skill копятся на диске, а Telegram-мост мёртв часами.

Аренда Mac Mini M4 в KVMNODE — launchd, UMA, SSH как на локальной машине, месячный OpEx для 30-дневной проверки перед покупкой железа. Типовой сценарий: день 1 — curl и Telegram на ноутбуке; день 3–7 — рост ~/.hermes/skills/; день 10 — перенос архива на выделенный M4, hermes gateway start без смены Bot Token; день 30 — сравнение счёта API и объёма Skill с таблицей из отчёта за 30 дней. Тарифы и RAM-матрица: цены аренды; сеть, регионы и SSH-ключи: центр помощи; оформление инстанса: заказ.