Установка Hermes Agent 2026:
macOS одной командой, Telegram и Gateway 24/7

В 2026 году Nous Research открыла Hermes Agent как долгоживущий процесс на вашем железе: память между сессиями, автоматическое накопление Skill и более двадцати шлюзов сообщений, включая Telegram. Многие застревают в первый день: сломанные зависимости, неверные API-ключи или бот в Telegram, который не отвечает.

Гайд для разработчиков, которым нужна чистая установка на macOS, Linux или WSL2 без ручной сборки Python и Node. Ниже — матрица выбора хоста, официальный установщик и шесть шагов от hermes doctor до hermes gateway start. После прочтения будет ясно, оставлять ли ~/.hermes/ на ноутбуке или переносить на постоянно включённый Mac mini.

01 Боли до установки: Hermes — не тот же путь, что OpenClaw

У Hermes и OpenClaw есть Gateway, но дефолты разные. OpenClaw опирается на control plane с плагинами; Hermes делает ставку на трёхслойную память, эволюцию Skill и MCP. Официальный установщик подтягивает Python 3.11, Node.js 22, ripgrep и ffmpeg в ~/.hermes/hermes-agent/venv, чтобы не бороться с системным Python.

  • Дрейф зависимостей: ручной pip часто даёт ModuleNotFoundError: dotenv, потому что shell всё ещё вызывает системный Python.
  • Sleep рвёт Gateway: MacBook подходит для POC; продакшену нужен хост без suspend во время cron и messaging.
  • Пробелы Linux VPS: режим Gateway только с API на x86 VPS работает, но часть macOS browser automation на Linux без допработы не повторяется.
  • Приватность групп Telegram: боты в группах игнорируют обычные сообщения, пока в BotFather не отключён Group Privacy и бот не приглашён снова.
  • Миграция конфига: после обновлений запускайте hermes config check при Missing config after update.

Установка часто укладывается в двадцать минут; uptime и стратегия бэкапа ~/.hermes/ определяют долгосрочную ценность.

Команды и поведение — по официальной документации Nous Research; после каждого релиза снова открывайте ссылки ниже.

Installation | Hermes Agent

NousResearch/hermes-agent на GitHub

02 Требования и матрица хостов: где разумнее крутить продакшен

Установщик поддерживает macOS 12+, Ubuntu 20.04+, WSL2 и Termux. Нативный PowerShell в Windows — ранняя бета; сегодня безопаснее WSL2 и Linux-скрипт.

Сравнение хостов Hermes Agent (практика 2026)
Хост Доступность 24/7 Трение установки Сложный процент Skill Главный минус
MacBook ломается при sleep низкое только POC обновления, крышка
Raspberry Pi 4B 8 ГБ хорошо, но IO среднее лёгкий Gateway ок длинные job — timeout
x86 Linux VPS высокая среднее (--skip-browser) API-режим стабилен нет нативной macOS toolchain
Аренда bare metal Mac mini M4 SLA дата-центра низкое по SSH launchd + UMA уместны регион и срок аренды

Официальные минимумы: около 4 ГБ RAM для Gateway и облачных API; 16 ГБ unified memory при локальных моделях или тяжёлой browser automation. Заложите 1,5 ГБ диска под базовую установку и больше под кэш Skills; в продакшене разумно 20 ГБ SSD запаса.

03 Установка одной командой и проверка здоровья на macOS и Linux

На целевом хосте в терминале (как в официальном README; после релизов проверяйте путь скрипта на ветке main репозитория):

install.sh 
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
Headless-сервер:
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash -s -- --skip-browser
source ~/.zshrc
hermes doctor
hermes --version

Установщик обычно ставит uv, фиксирует Python 3.11, ставит Node.js 22, клонирует репозиторий в ~/.hermes/hermes-agent/ и добавляет CLI hermes в PATH. При успехе появится сообщение вроде installed at ~/.hermes.

hermes doctor проверяет Python, Node, ripgrep, ffmpeg, PATH и API-ключи. Исправьте каждый провал до hermes setup, чтобы не тащить ошибки в Gateway.

Настройка канала Telegram — в официальном Messaging-гайде.

Telegram | Hermes Agent User Guide

04 Шесть шагов: модель, первый чат, Telegram и постоянный Gateway

  1. Настроить LLM: hermes setup или hermes model для OpenRouter, Anthropic, OpenAI, Ollama и др. Ключи в ~/.hermes/.env или через hermes config set OPENROUTER_API_KEY sk-or-xxxx.
  2. Дымовой тест CLI: запустите hermes с проверяемой задачей, например подсчёт файлов в текущей директории.
  3. Создать Telegram-бота: @BotFather и /newbot; числовой User ID — у @userinfobot.
  4. Подключить Gateway: hermes gateway setup, выберите Telegram, вставьте token и разрешённые user ID или задайте TELEGRAM_BOT_TOKEN и TELEGRAM_ALLOWED_USERS.
  5. Тест на переднем плане: hermes gateway в foreground, напишите боту с телефона; в группах отключите privacy бота и пригласите снова.
  6. Демон: на macOS hermes gateway install и hermes gateway start (launchd); на Linux — документированный systemd с --system при необходимости.
gateway.env 
hermes setup
hermes gateway setup
hermes gateway install
hermes gateway start
hermes gateway status

На bare metal Mac CALMVPS: выберите объём RAM M4 и регион на странице цен, зайдите по SSH, выполните те же команды, что локально, и перед сменой хоста заархивируйте весь каталог ~/.hermes/.

05 Справочные параметры, типичные ошибки и когда выигрывает CALMVPS

  • Стек установщика: uv, Python 3.11, Node.js 22, ripgrep, ffmpeg по Installation; после обновлений — hermes --version.
  • Каталог состояния: ~/.hermes/ хранит env, skills, memories и состояние Gateway; миграция требует полного бэкапа каталога, а не только экспорта чатов.
  • Профиль M4: в дата-центрах часто около 4–6 Вт в idle и 15–25 Вт под типичной нагрузкой Agent; сверяйте со своим счётчиком.
Частые ошибки установки и Gateway
Симптом Типичная причина Действие
hermes: command not found PATH не обновлён source ~/.zshrc или новый терминал
API key not set LLM не настроен hermes model или правка ~/.hermes/.env
группа молчит режим privacy бота отключить Group Privacy, пригласить бота снова
Missing config after update изменилась схема config hermes config check и migrate

Hermes на ноутбуке, который каждый день закрывают, рвёт непрерывность Gateway и ритм Skill. На дешёвом зарубежном VPS нет macOS toolchain и растёт задержка Telegram. На Raspberry Pi длинные задачи упираются в IO.

Для Telegram 24/7, daemons через launchd и быстрого увеличения RAM помесячная аренда bare metal Mac mini M4 CALMVPS обычно лучший продакшен-дефолт: выделенный Apple Silicon, выдача по SSH, гибкие месячные сроки. Модели и тарифы — на странице цен CALMVPS; оформить заказ — аренда Mac mini M4.