Как запустить Hermes Agent 24/7 на выделенном Mac mini

1. Почему стоит запускать Hermes Agent на Mac mini?

Hermes Agent создан для непрерывной работы: он хранит постоянную память, выполняет задачи по расписанию через встроенный cron и совершенствует собственные навыки между разговорами. Ничего из этого не работает на ноутбуке, который уходит в сон, или на общем VPS, который перезагружается. Выделенный Mac mini от MyRemoteMac даёт вам Apple Silicon (Tier 1 для Hermes), полный root-доступ по SSH и VNC, включённый 1 Gbps и фиксированную месячную цену, с возможностью запустить локальную модель Ollama на той же машине, чтобы инференс не стоил ни цента за токен.

2. Требования

Официальный установщик намеренно сделан лёгким. Вам не нужны Homebrew, Python или Node.js: Hermes сам загружает закреплённую версию uv и Python 3.14, а Node.js понадобится позже только при включении моста WhatsApp. Вот что действительно нужно:

• Выделенный Mac mini от MyRemoteMac, M4 от $85/мес или M6 от $149/мес. Оба на Apple Silicon, платформа Tier 1 для Hermes.
• SSH-доступ к Mac mini (предоставляется вместе с подпиской MyRemoteMac)
• git и curl на Mac (а также tar и утилита SHA-256, всё это предустановлено в macOS, git ставится вместе с Xcode Command Line Tools). Установщик прерывается с ошибкой только при отсутствии git или curl.
• Провайдер LLM: ключ API (Anthropic, OpenRouter, OpenAI и 25+ других), подписка Nous Portal или локальная модель Ollama. Модель должна поддерживать контекст не менее 64 000 токенов и вызов инструментов (tool calling).
• Аккаунт в Telegram, Discord или WhatsApp (Telegram настраивается быстрее всего)

3. Шаг 1: Подключение по SSH и запуск установщика

Подключитесь к Mac mini по SSH с учётными данными из панели управления MyRemoteMac. Установщику нужны git и curl (а также tar и утилита SHA-256, всё предустановлено в macOS), остальное он делает сам: клонирует исходный код в ~/.hermes/hermes-agent, загружает закреплённую версию uv с проверкой SHA-256, разворачивает Python 3.14, устанавливает зависимости, создаёт ~/.hermes/config.yaml и ~/.hermes/.env (chmod 600) и запускает интерактивную настройку.

Подключение по SSH и проверка требований

# Connect to your Mac mini
ssh admin@your-server-ip

# Confirm Apple Silicon (Tier 1 platform for Hermes Agent)
uname -m
# arm64

# The installer requires only git and curl: both ship with macOS
git --version && curl --version

Запуск официального установщика одной командой

Это та же команда, что опубликована в официальном README и на странице установки. Не используйте Homebrew: brew install hermes-agent указан в официальной документации как неподдерживаемый способ. Если вы выполняете установку скриптом по SSH, добавьте --non-interactive (псевдоним --skip-setup) и затем запустите мастер настройки самостоятельно.

# Official one-line installer (Linux / macOS / WSL2)
curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash

# What it does:
# - clones the source into ~/.hermes/hermes-agent
# - downloads a pinned, sha256-verified uv and provisions Python 3.14
# - creates ~/.hermes/config.yaml and ~/.hermes/.env (chmod 600)
# - launches the interactive setup wizard

# Scripting over SSH? Skip the wizard and run it later with `hermes model`:
curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash -s -- --non-interactive

Перезагрузка оболочки и проверка

Установщик добавляет ~/.local/bin в PATH в файлах ~/.zshrc и ~/.zprofile. Перезагрузите оболочку (или откройте новую SSH-сессию), затем запустите встроенную диагностику:

# Reload the shell so ~/.local/bin/hermes is on PATH
source ~/.zshrc    # or open a new SSH session

# Verify the install
hermes --version

# Built-in diagnostics (add --fix to attempt automatic repairs)
hermes doctor

4. Шаг 2: Настройка провайдера моделей (API или локальная Ollama)

Hermes хранит секреты в ~/.hermes/.env, а всё остальное, в ~/.hermes/config.yaml, и предлагает три официальных способа выбрать модель. Что бы вы ни выбрали, модели нужен контекст не менее 64 000 токенов. Обратите внимание: собственная чат-модель Nous Hermes 4, не то, что нужно циклу агента: документация Nous Portal рекомендует вместо неё передовую модель с поддержкой вызова инструментов.

Вариант A или B: интерактивный мастер или Nous Portal

Мастер проведёт вас через выбор провайдеров, ключи API и OAuth-входы. Nous Portal, это подписка, которая даёт агенту доступ к 300+ моделям через единый OAuth-вход (цены указаны на сайте Nous Portal, а не в документации).

# Option A: interactive wizard (providers, API keys, OAuth logins)
hermes model

# Option B: Nous Portal subscription via OAuth (300+ models)
hermes setup --portal

Вариант C: задать ключ и модель без интерактивного режима

Ключи в формате UPPER_SNAKE, такие как ANTHROPIC_API_KEY, OPENROUTER_API_KEY или OPENAI_API_KEY, записываются в .env; ключи с точками или в нижнем регистре, в config.yaml. Идентификатор модели ниже, пример из официального quickstart; выберите любую актуальную модель вашего провайдера с контекстом 64k+ и поддержкой вызова инструментов.

# Option C: non-interactive, UPPER_SNAKE keys go to ~/.hermes/.env
hermes config set ANTHROPIC_API_KEY sk-ant-YOUR_API_KEY_HERE

# Dotted / lowercase keys go to ~/.hermes/config.yaml
# (model id below is the example from the official quickstart)
hermes config set model anthropic/claude-opus-4.6

# Review the active configuration
hermes config show

Опционально: бесплатная локальная модель через Ollama

Ваш Mac mini может размещать модель самостоятельно. Официальное руководство Hermes по Ollama использует gemma4:31b (около 20 ГБ на диске, 24+ ГБ ОЗУ, вызов инструментов поддерживается), на MyRemoteMac конфигурация с 24 ГБ (Mac mini M4 24 ГБ за $129/мес или M6 24 ГБ за $219/мес) соответствует этому задокументированному минимуму, но оставляет мало запаса для macOS и контекстного окна в 64k, если на Mac mini с 24 ГБ нужен запас, выберите модель поменьше с поддержкой вызова инструментов. Контекстное окно Ollama по умолчанию намного меньше требуемых Hermes 64k, поэтому документация предлагает создать Modelfile с увеличенным num_ctx. Сначала установите Ollama для macOS с ollama.com/download; Ollama также описывает пошаговый вариант через ollama launch hermes.

# 1. Install Ollama for macOS from https://ollama.com/download

# 2. Pull a tool-calling model (~20 GB on disk, 24+ GB RAM)
ollama pull gemma4:31b

# 3. Hermes needs 64k context: build a Modelfile that raises num_ctx
printf 'FROM gemma4:31b\nPARAMETER num_ctx 64000\n' > Modelfile
ollama create gemma4-64k -f Modelfile

# 4. Point Hermes at the local OpenAI-compatible endpoint
hermes setup
# Choose "Custom Endpoint": base URL http://localhost:11434/v1, model gemma4-64k

# Alternative guided path documented by Ollama:
ollama launch hermes

Smoke-тест перед тем, как добавлять что-то ещё

Quickstart говорит прямо: если Hermes не может завершить обычный чат, не добавляйте пока шлюз, cron или навыки. Сначала проведите один чистый разговор:

# Classic CLI chat
hermes

# Or the terminal UI
hermes --tui

5. Шаг 3: Подключение каналов обмена сообщениями

Один процесс шлюза Hermes обслуживает все ваши платформы: официальная документация насчитывает 20+ на одном шлюзе, включая Telegram, Discord, Slack, WhatsApp, Signal, Google Chat, Microsoft Teams, Matrix, Mattermost и мосты iMessage. Ниже, три из них, которые мы сверили с профильными страницами документации. Шлюз по умолчанию всё запрещает (deny-by-default): пока вы не добавите свой ID пользователя в список разрешённых, бот игнорирует всех.

Telegram (рекомендуемый первый канал)

Создайте бота через @BotFather (/newbot выдаст токен) и узнайте свой числовой ID пользователя у @userinfobot, списки разрешённых в Telegram используют числовые ID, а не @username. Затем запустите мастер шлюза, который запишет значения в ~/.hermes/.env. По умолчанию используется long polling, поэтому входящий порт и правило файрвола не нужны.

# 1. In Telegram, open @BotFather, send /newbot and copy the token
# 2. Open @userinfobot to get your numeric user ID

# 3. Run the gateway wizard (writes the values to ~/.hermes/.env)
hermes gateway setup

# Equivalent manual entries in ~/.hermes/.env:
# TELEGRAM_BOT_TOKEN=123456789:ABC...
# TELEGRAM_ALLOWED_USERS=123456789
# Optional: chat that receives scheduled-task results (or send /sethome in a chat)
# TELEGRAM_HOME_CHANNEL=123456789

Discord (опционально)

Создайте приложение на Портале разработчиков Discord, скопируйте токен бота и включите Message Content Intent и Server Members Intent в разделе Privileged Gateway Intents, без Message Content Intent бот получает события с пустым текстом. Пригласите бота с целым числом разрешений 274878286912, затем добавьте свой ID пользователя в список разрешённых.

# In the Discord Developer Portal (https://discord.com/developers/applications):
# 1. New Application > Bot > copy the Bot Token
# 2. Privileged Gateway Intents: enable Message Content Intent + Server Members Intent
# 3. Invite the bot with permission integer 274878286912

hermes gateway setup   # choose Discord

# Equivalent manual entries in ~/.hermes/.env:
# DISCORD_BOT_TOKEN=...
# DISCORD_ALLOWED_USERS=284102345871466496
# DISCORD_REQUIRE_MENTION=true   (default)

WhatsApp (опционально)

WhatsApp использует неофициальный мост (Baileys), которому нужны Node.js v18+ и отдельный номер телефона, привязанный по QR-коду. Официальная документация предупреждает о небольшом риске ограничений аккаунта, а директория сессии даёт полный доступ к аккаунту, никогда не делитесь ею.

# Requires Node.js v18+ on the Mac mini (only needed for WhatsApp)
node --version

# Pair a dedicated phone number via QR code
hermes whatsapp

# ~/.hermes/.env:
# WHATSAPP_ENABLED=true
# WHATSAPP_MODE=bot
# WHATSAPP_ALLOWED_USERS=15551234567   (country code, no +)

# Session is stored in ~/.hermes/platforms/whatsapp/session: never share it
# Meta Business Cloud API alternative: hermes whatsapp-cloud

Проверка шлюза на переднем плане

Запустите шлюз в своей SSH-сессии, отправьте боту сообщение, убедитесь, что он отвечает, затем нажмите Ctrl-C. hermes gateway status показывает состояние сервиса; напишите боту, чтобы проверить цепочку целиком.

# Run the gateway in the foreground
hermes gateway

# Send your bot a message from Telegram / Discord: it should reply.
# Press Ctrl-C to stop (the persistent service is set up in Step 4)

6. Шаг 4: Работа 24/7 через launchd, обновление, миграция

hermes gateway install регистрирует пользовательский LaunchAgent в ~/Library/LaunchAgents/ai.hermes.gateway.plist (метка ai.hermes.gateway), чтобы шлюз запускался при входе в систему (RunAtLoad) и контролировался macOS. Важная деталь из официального FAQ: plist фиксирует полный PATH вашей оболочки на момент установки. Установите Node.js, ffmpeg или Ollama до этого шага, или после повторно выполните hermes gateway install.

Установка и запуск сервиса

# Register the launchd LaunchAgent
# (writes ~/Library/LaunchAgents/ai.hermes.gateway.plist with your current PATH)
hermes gateway install

# Start it now
hermes gateway start

# Service status
hermes gateway status

# Live logs
tail -f ~/.hermes/logs/gateway.log

# Other commands: hermes gateway stop | restart | list
# Foreground run (no launchd): hermes gateway run

Проверка, что launchd контролирует сервис (и один тест с перезагрузкой)

hermes gateway status показывает состояние сервиса; напишите боту, чтобы проверить цепочку целиком, и обратитесь к launchctl напрямую, чтобы убедиться, что процессом действительно владеет launchd. Поскольку пользовательский LaunchAgent загружается только после появления вашей пользовательской сессии, перед тестом с перезагрузкой убедитесь, что для вашего администратора включён автоматический вход (Системные настройки > Пользователи и группы > Автоматический вход), иначе на headless Mac mini шлюз не поднимется. Затем перезагрузитесь один раз (sudo reboot) и снова напишите боту.

# Confirm launchd owns the gateway (state, PID, last exit code)
launchctl print gui/$(id -u)/ai.hermes.gateway

# Check the PATH that was captured in the plist
/usr/libexec/PlistBuddy -c "Print :EnvironmentVariables:PATH" ~/Library/LaunchAgents/ai.hermes.gateway.plist

# LaunchAgents load at login: enable Automatic login first
# (System Settings > Users & Groups > Automatic login)
# Reboot-test once, then message the bot again
sudo reboot

Обновление Hermes Agent

hermes update загружает свежий код в ~/.hermes/hermes-agent, повторно синхронизирует зависимости и перезапускает шлюз в режиме drain-first: он отказывается принимать новые запросы и ждёт завершения текущих чатов, cron-задач и API-операций (по умолчанию до 30 минут), прежде чем перезапуститься. Вывод дублируется в ~/.hermes/logs/update.log. Используйте --check для предварительного просмотра, --backup, чтобы сначала сделать снимок ~/.hermes, и --no-gateway-restart, чтобы отложить перезапуск.

# Preview what would change
hermes update --check

# Update (snapshot ~/.hermes first, drain-first gateway restart)
hermes update --backup

# Adopt any new configuration options
hermes config check && hermes config migrate

# Confirm the running version
hermes --version

Опционально: миграция с OpenClaw на том же Mac

Уже используете OpenClaw по нашему другому руководству? Официальная команда миграции импортирует из ~/.openclaw файл SOUL.md, память и профили пользователей (в ~/.hermes/memories/), навыки (в ~/.hermes/skills/openclaw-imports/) и сначала создаёт точку восстановления pre-migration-*.zip в ~/.hermes/backups/. Секреты по умолчанию не импортируются: явно добавьте --migrate-secrets, чтобы перенести ключи API и токены мессенджеров (Telegram, Discord, Slack, Signal, Matrix, Mattermost). Токен WhatsApp не переносится, переносится только его список разрешённых, и его нужно заново привязать через hermes whatsapp. Всегда начинайте с пробного запуска (dry run).

# Preview the migration from ~/.openclaw
hermes claw migrate --dry-run

# Migrate (writes a pre-migration-*.zip restore point in ~/.hermes/backups/ first)
# --migrate-secrets is required to carry over API keys and messaging tokens
hermes claw migrate --migrate-secrets

# Later, rename leftover OpenClaw directories to .pre-migration/
hermes claw cleanup

7. Устранение распространённых проблем

# Reload the shell profile the installer edited
source ~/.zshrc

# Or call the binary directly
~/.local/bin/hermes --version

# Still broken? Run the diagnostics
~/.local/bin/hermes doctor --fix

# Allowlist resolution order (official security guide):
# per-platform allow-all -> DM-pairing list -> TELEGRAM_ALLOWED_USERS / DISCORD_ALLOWED_USERS
# -> GATEWAY_ALLOWED_USERS -> GATEWAY_ALLOW_ALL_USERS=true -> deny

# Check what is stored (Telegram IDs are numeric, from @userinfobot)
grep TELEGRAM_ALLOWED_USERS ~/.hermes/.env

# Fix it, then watch the gateway in the foreground while you message the bot
hermes config set TELEGRAM_ALLOWED_USERS 123456789
hermes gateway

# Discord only: confirm Message Content Intent is enabled in the Developer Portal

# See the PATH launchd is using
/usr/libexec/PlistBuddy -c "Print :EnvironmentVariables:PATH" ~/Library/LaunchAgents/ai.hermes.gateway.plist

# Re-capture your current shell PATH and reload the service
hermes gateway install
hermes gateway start

# Check the logs
tail -50 ~/.hermes/logs/gateway.log

# Rebuild the model with a 64k context window
printf 'FROM gemma4:31b\nPARAMETER num_ctx 64000\n' > Modelfile
ollama create gemma4-64k -f Modelfile

# Make sure Hermes targets the 64k variant on the local endpoint
hermes setup   # Custom Endpoint: http://localhost:11434/v1, model gemma4-64k

# Note: the model must also support tool calling (gemma4:31b does, per the official guide)

# Is the LaunchAgent registered and running?
launchctl print gui/$(id -u)/ai.hermes.gateway

# Not listed? Re-register and start it (and check Automatic login is on)
hermes gateway install
hermes gateway start
hermes gateway status

# Then reboot-test again
sudo reboot

8. Сравнение стоимости с облачным VPS

Сам Hermes Agent бесплатен (MIT). Вы платите за хост и за использование LLM. Сравнение хостов ниже использует те же цифры по облачным VPS, что и наше руководство по OpenClaw; использование API LLM в обеих колонках тарифицируется провайдером отдельно и одинаково на любом хосте, если только вы не запускаете локальную модель Ollama на Mac mini, и тогда инференс стоит $0.

Допущения: цены на VPS, те же диапазоны, что используются во всех наших руководствах для ИИ-тарифов с GPU, а не котировки конкретного провайдера; цены MyRemoteMac, текущие месячные тарифы в USD (1 Gbps включён). Стоимость подписки Nous Portal в документации Hermes не опубликована, поэтому не учитывается.

9. Hermes Agent против OpenClaw

Оба, персональные ИИ-агенты с открытым исходным кодом (MIT), самостоятельным хостингом и круглосуточной работой, управляемые из ваших мессенджеров; оба устанавливаются одной командой curl, оба запускают долгоживущий шлюз, и оба регистрируют собственный LaunchAgent в launchd (ai.hermes.gateway и ai.openclaw.gateway). Различия, в стеке и в позиционировании. OpenClaw написан на TypeScript под Node.js (26.1+ или 24.16+ через Homebrew), устанавливается через npm и использует собственную команду openclaw gateway install service. Hermes, это Python, разворачиваемый закреплённой версией uv, целиком живёт в ~/.hermes, требует только git и curl (Node.js, только для моста WhatsApp) и использует hermes gateway install. Позиционирование Hermes, самосовершенствование: навыки, создаваемые агентом, постоянная память и SOUL.md, встроенный cron и семь терминальных бэкендов (local, Docker, SSH, Modal, Daytona, Vercel Sandbox, Singularity). Позиционирование OpenClaw, широта возможностей и более крупное сообщество: на 28 сентября 2026 г. GitHub показывал примерно 391 тыс. звёзд у OpenClaw против 250 тыс. у Hermes.

Если вы уже используете OpenClaw, миграция, первоклассная: hermes claw migrate (см. Шаг 4), это прямая миграция, которая сначала создаёт точку восстановления pre-migration-*.zip в ~/.hermes/backups/. Если вы начинаете с нуля, прочитайте также наше руководство по OpenClaw на Mac mini и выберите харнесс, чей рабочий процесс вам ближе, Mac mini, сервис launchd и вариант с локальной Ollama у обоих одинаковы.

10. FAQ

11. Источники и дополнительные материалы

Каждая команда и каждое требование в этом руководстве были сверены 28 сентября 2026 г. с официальной документацией и репозиторием Hermes Agent (последний релиз v2026.9.24). Hermes выпускает релизы с датой в номере версии и быстро развивается, поэтому актуальный список флагов смотрите на этих страницах:

• Репозиторий Hermes Agent на GitHub (NousResearch/hermes-agent)
• Официальное руководство по установке
• Quickstart (провайдеры, требование к контексту 64k, smoke-тест)
• Поддержка платформ (Tier 1 macOS Apple Silicon, неподдерживаемые способы)
• Обновление Hermes Agent
• Справочник по конфигурации (config.yaml, .env, приоритет)
• Руководство по безопасности (списки разрешённых, approvals, бэкенд Docker)
• Обзор мессенджеров (список платформ, gateway install/start/stop)
• Настройка Telegram
• Настройка Discord
• Настройка WhatsApp
• Справочник команд CLI
• FAQ (PATH в launchd на macOS, gateway.log)
• Руководство по локальной Ollama (gemma4:31b, num_ctx 64000)
• Миграция с OpenClaw
• Интеграция с Nous Portal
• Страница интеграции Ollama (ollama launch hermes)

Похожие руководства