2026 Руководство по установке Hermes Agent: от одной строки curl до Telegram Gateway 7x24 на macOS, Linux и Mac в облаке (2026)

1. Для кого это руководство по установке

Если вы читали нашу статью о трехслойной памяти, вы уже знаете, зачем Hermes нужен постоянно работающий хост. Эта страница объясняет как: команды из репозитория Hermes Agent Nous Research до рабочего моста в Telegram. Вы устанавливаете официальным скриптом, запускаете hermes doctor, пока предупреждения не исчезнут, завершаете hermes setup, фиксируете модели через hermes model, создаете бота в BotFather, затем hermes gateway setup и hermes gateway install, чтобы сообщения приходили, пока вы спите. Покрыты macOS (launchd), Linux VPS (systemd) и Mac-узлы в облаке по SSH — без обязательного Mac mini в собственности. Для TCO после установки см. сравнение Pi vs VPS vs Mac mini.

Порядок шагов линейный: после каждого этапа есть видимый результат (версия, зеленый doctor, ответ в CLI, ответ в Telegram, служба после reboot). Так вы не настраиваете все сразу и не гадаете, виновата модель, Gateway или хост.

2. Типичные проблемы до curl

1. Установка прошла, Gateway нет. Нет API-ключей, неверный terminal.backend или конфликт портов с другими агентами — Telegram молчит, хотя hermes --version работает.
2. Токен Telegram на спящем ноутбуке. BotFather выдает токен за секунды; long polling или webhooks требуют процесса без suspend — MacBook и WSL2 под Windows ломают это каждый день.
3. Linux VPS «работает», но ломает macOS-процессы. Hermes поддерживает семь terminal backend и 20+ каналов на Linux, но Skills с Xcode, Keychain или уведомлениями Apple тянут к нативному macOS или арендованному Mac.

Многие команды тратят полдня на отладку при «зеленом» установщике — Gateway, маршрутизация моделей и uptime 24/7 это три разные задачи. Руководство разделяет их на измеримые шаги с приемочными тестами.

3. Сравнение: MacBook vs Pi vs VPS vs аренда Mac mini

Таблица выбирает где выполнять runbook ниже — а не стоит ли ставить Hermes. Большинство продакшен-мостов Telegram сидят на выделенном Linux VPS с systemd или арендованном Mac mini M4 — оба остаются онлайн без ноутбука в дороге.

4. Справочные цифры (2026)

Цифры для обоснования железа:

• Охват установщика: официальный install.sh для macOS, Linux и WSL2; один процесс Gateway подключает 20+ каналов по документации Nous.
• Модели: OpenRouter — 300+ моделей; локальные Ollama / LM Studio при достаточной RAM — планируйте минимум 16 ГБ на Apple Silicon для 8B–13B плюс overhead Gateway.
• Terminal backend: семь режимов — большинство пользователей только Telegram остаются на local, пока не нужен sandbox.

Для накопления Skills шифруйте бэкапы ~/.hermes: документы Skill переживают reboot, контекст сессии в RAM — нет.

5. Runbook установки в семь шагов

Шаг 1 — Выбор хоста и базовых пакетов

На macOS установите Xcode Command Line Tools (xcode-select --install). На Ubuntu/Debian VPS — curl, git, build-essential. Создайте пользователя Unix hermes без продакшен-ключей подписи. Проверьте исходящий HTTPS и для webhooks Telegram — стабильный публичный IP или reverse tunnel.

Шаг 2 — Установка в одну строку upstream

curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
exec $SHELL
hermes --version

Перезапустите shell для PATH. На арендованном Mac в облаке ставьте по SSH как локально — отдельной «облачной» редакции нет.

Шаг 3 — Doctor, затем интерактивный setup

hermes doctor
hermes doctor --fix   # проверьте diff перед принятием
hermes setup

hermes doctor находит отсутствующие бинарники Node, незаданные API-ключи и конфликты порта Gateway. hermes setup ведет по путям в ~/.hermes. Ключи провайдеров лучше через переменные окружения, не plaintext в конфиге.

Шаг 4 — Фиксация моделей

hermes model list
hermes model set default openrouter/anthropic/claude-sonnet-4
hermes config set inference.ollama.base_url http://127.0.0.1:11434

Быстрая модель для классификации, тяжелая для многошагового reasoning. Смесь local + cloud держит Telegram отзывчивым без взрыва счета API.

Шаг 5 — Telegram через BotFather

В Telegram откройте @BotFather, /newbot, скопируйте HTTP API token, ограничьте чаты. Сохраните токен, затем:

export TELEGRAM_BOT_TOKEN="123456:ABC..."
hermes gateway setup

Следуйте подсказкам сопряжения. Webhook требует HTTPS; long polling все равно требует постоянного процесса.

Шаг 6 — Установка службы Gateway

hermes gateway install
hermes gateway status

На macOS обычно LaunchAgent; на Linux — user unit systemd. Проверьте имя службы перед выходом из SSH.

Шаг 7 — Приемочные smoke-тесты

hermes gateway restart
hermes cron add "0 7 * * *" "Send heartbeat: Gateway alive"

Перезагрузите хост. Если Telegram отвечает и cron срабатывает — у вас настоящий 7x24. Зашифруйте бэкап ~/.hermes перед обновлением ОС.

6. launchd vs systemd для Gateway 7x24

macOS (launchd): LaunchAgent в ~/Library/LaunchAgents/ с KeepAlive и логами в ~/Library/Logs/hermes/. После правки конфига:

launchctl kickstart -k gui/$(id -u)/com.nousresearch.hermes.gateway
launchctl print gui/$(id -u)/com.nousresearch.hermes.gateway | grep state

Linux (systemd): включите linger для hermes (loginctl enable-linger hermes), затем systemctl --user enable --now hermes-gateway.service. Проверка: systemctl --user status hermes-gateway. systemd отличен на VPS; Keychain и уведомления Apple часто требуют отдельный Mac-узел.

7. Таблица ошибок

8. FAQ

Установка на WSL2? Да для экспериментов; сон Windows ломает Telegram 7x24, если Gateway не на другом хосте. Reboot удаляет Skills? Документы Skill на диске остаются; контекст RAM пропадает — бэкап ~/.hermes перед миграцией. Обязателен Telegram? Нет — hermes gateway setup поддерживает Slack, Discord и др.; Telegram — самый быстрый smoke-тест.

Перед продакшеном зафиксируйте версию hermes --version в runbook команды: после hermes update снова запускайте hermes doctor и smoke-тест Telegram — так вы отделите регрессию установщика от сетевых сбоев.

9. Заключение

MacBook хватит на шаги 1–5 за послеобеденное время, но крышка и домашний ISP делают его плохим долгосрочным хостом Telegram. Pi экономит, но не хватает RAM. VPS за пять долларов онлайн, но добавляет systemd и без нативного macOS. После curl | bash, зеленого doctor и BotFather схема одна: hermes gateway install на железе без suspend — для большинства launchd на Mac mini M4, свой или арендованный.

Аренда Mac Apple Silicon у VPSMAC дает предсказуемый месячный бюджет, SSH, опциональный Screen Sharing и wipe при возврате. Те же команды, что на настольном mini; меняется только место shell. Это кратчайший путь от curl в одну строку к агенту в Telegram в 3 ночи — без привязки ежедневного ноутбука к uptime Gateway.