Hermes Agent macOS: установка, настройка, gateway и launchd (2026)

Hermes Agent — агент с лицензией MIT от Nous Research с петлёй самоулучшения: создаёт skills из опыта, сохраняет память периодическими nudge, ищет прошлые сессии через FTS5 и моделирует контекст пользователя через Honcho. На macOS устанавливается как нативный CLI плюс опциональный gateway сообщений—Telegram, Discord, Slack, WhatsApp, Signal и Email—из одного процесса hermes gateway.

Это руководство по настройке macOS на Apple Silicon или Intel—установка, первая конфигурация, подключение gateway и поддержание gateway через launchd. Предполагается macOS 15+ на машине под вашим контролем (MacBook, Mac mini, Mac Studio или удалённый Mac по SSH). Если агенты уже в облаке, см. отдельный Руководство Hermes Mac mini M4 для headless-хостов; команды ниже одинаковы на любом Mac.

Что нужно перед установкой

Установщик подтянет при отсутствии uv, Python 3.11, Node.js, ripgrep и ffmpeg. Проверьте затем hermes doctor.

Как устроен Hermes на macOS

После установки состояние в ~/.hermes/:

~/.hermes/
├── config.toml          # провайдеры, инструменты, терминальный backend, настройки gateway
├── skills/              # пользовательские и автосозданные skills
│   └── openclaw-imports/   # после hermes claw migrate
├── memory/              # курируемые файлы памяти
└── logs/                # логи gateway и CLI (пути в upstream-документации)

Бинарник hermes — симлинк на ~/.local/bin/hermes. Три интерфейса важны в работе:

1. CLI (hermes) — интерактивный TUI; slash-команды (/model, /skills, /compress, /new).
2. Gateway (hermes gateway) — связывает платформы сообщений с тем же циклом агента.
3. Терминальные backend — где выполняются shell/файловые tools: local (по умолчанию на macOS), Docker, SSH, Singularity, Modal или Daytona.

Маршрутизация моделей не привязана к провайдеру: hermes model переключает Nous Portal, OpenRouter (200+ моделей), OpenAI, Anthropic и BYO-эндпоинты без изменения кода.

Пошаговая настройка macOS

1. Установить Hermes

Проверьте скрипт установки в организации перед pipe в shell. Upstream one-liner:

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

hermes doctor должен показать успешные проверки uv, Python 3.11, Node, ripgrep и ffmpeg. Исправьте отмеченные зависимости и повторите.

2. Первичная настройка

Полный мастер или Portal OAuth:

hermes setup              # интерактивно: провайдер, инструменты, подсказки gateway
# ИЛИ
hermes setup --portal     # Nous Portal OAuth + Tool Gateway (поиск, изображения, браузер, TTS)

Мастер обнаружит ~/.openclaw и предложит миграцию—при чистой установке пропустите.

3. Выбор модели и tools

hermes model              # выбрать provider:model (напр. openrouter:anthropic/claude-sonnet-4)
hermes tools              # включить/выключить наборы инструментов (40+ upstream)
hermes config set KEY VALUE   # тонкие переопределения

Подтвердите короткой CLI-сессией:

hermes
# в TUI: вопрос, /usage, выход Ctrl+D или /quit

4. Миграция из OpenClaw (опционально)

Если есть рабочее пространство OpenClaw:

hermes claw migrate --dry-run
hermes claw migrate

Обычно импортируются persona SOUL.md, записи MEMORY.md / USER.md, пользовательские skills, allowlist команд, настройки сообщений и разрешённые API-ключи в ~/.hermes/. Пресеты: hermes claw migrate --help.

5. Настройка gateway сообщений

hermes gateway setup      # токены платформ, DM-пейринг, разрешённые пользователи
hermes gateway start      # тест на переднем плане

Проверьте из Telegram (или вашей платформы): отправьте /new, затем prompt. Если бот онлайн, но молчит, используйте /status со стороны сообщений—часто pairing или allowlist (upstream Security).

6. Постоянный gateway через launchd

Foreground hermes gateway start останавливается при выходе. Для постоянно включённого Mac (настольный Mac mini, студийная машина или удалённый хост) создайте пользовательский LaunchAgent. Пример скелета plist—пути после which hermes:

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
  <key>Label</key><string>com.hermes.gateway</string>
  <key>ProgramArguments</key>
  <array>
    <string>/Users/YOU/.local/bin/hermes</string>
    <string>gateway</string>
    <string>start</string>
  </array>
  <key>RunAtLoad</key><true/>
  <key>KeepAlive</key><true/>
  <key>StandardOutPath</key><string>/Users/YOU/.hermes/logs/gateway.stdout.log</string>
  <key>StandardErrorPath</key><string>/Users/YOU/.hermes/logs/gateway.stderr.log</string>
</dict>
</plist>

Загрузка:

mkdir -p ~/.hermes/logs
launchctl bootstrap gui/$(id -u) ~/Library/LaunchAgents/com.hermes.gateway.plist
launchctl kickstart -k gui/$(id -u)/com.hermes.gateway

Токены Telegram/Discord — в dict EnvironmentVariables plist или env-файле при загрузке—не оставляйте только в export SSH-сессии.

7. Включить cron-подобную автоматизацию (опционально)

В Hermes встроен cron-планировщик с доставкой на платформы сообщений. Задачи на естественном языке через CLI или config по документации cron upstream. На macOS cron требует постоянно работающий процесс gateway (или CLI)—ещё одна причина использовать launchd на Mac без сна.

8. Резервная копия ~/.hermes/

tar -czf hermes-backup-$(date +%Y%m%d).tar.gz -C ~ .hermes

Skills и память сложнее восстановить, чем логи чата. Снимок перед крупными обновлениями:

hermes update
hermes doctor

Устранение неполадок

hermes doctor падает на Python или uv

Симптом: Doctor сообщает об отсутствии uv или неверной версии Python.

Решение: Повторите скрипт установки. Hermes ожидает Python 3.11 через uv. На macOS с Homebrew: brew install ripgrep ffmpeg node, затем снова hermes doctor.

Gateway запускается, боты не отвечают

Симптом: hermes gateway start пишет "running"; DM зависают без ошибки в чате.

Решение: Завершите DM pairing и allowlist в hermes gateway setup. Перезапустите gateway после смены токенов. При launchd убедитесь, что env сохранились в plist—launchctl print gui/$(id -u)/com.hermes.gateway покажет окружение.

CLI tools с ошибками прав

Симптом: Файловые или shell tools падают на путях macOS вне workspace.

Решение: Проверьте одобрение команд в config (upstream Security). Для путей на весь диск macOS TCC может запросить доступ к файлам/папкам—разрешите на машине, где работает backend local.

Когда нужен всегда включённый Mac

Спящий MacBook приостанавливает доставку gateway и cron. Команды, которые общаются в Telegram, пока агент на другом хосте, часто выделяют небольшой always-on Mac—настольный Mac mini или хостинг macOS—с launchd для hermes gateway. Шаги этого гайда не меняются; отличаются только политика сна и доступность сети. Для SSH-backend (CLI на ноутбуке, tools на удалённом Mac) укажите терминальный backend в config.toml по upstream Tools.

После установки запустите руководство по делегированию subagent Hermes —1 босс, 3 worker через delegate_task.

руководство Hermes Gateway multi-device — Telegram на телефоне и Discord на ПК.

FAQ

Hermes заменяет OpenClaw или OpenHuman?

Нет—разные дизайны. Hermes делает упор на skills + memory nudges + встроенный cron; OpenClaw — автоматизация gateway-first; OpenHuman — память на рабочем столе с OAuth auto-fetch. Данные OpenClaw переносятся в Hermes через hermes claw migrate. Сравнительные runbook — в Руководство Hermes Mac mini M4 и Руководство по установке OpenClaw macOS.

Нужен ли Nous Portal?

Нет. Portal (hermes setup --portal) объединяет модели и Tool Gateway в одном OAuth. Можно указать ключи OpenRouter, OpenAI или Anthropic и включать tools по отдельности.

Где хранится config на macOS?

Основное дерево: ~/.hermes/ с config.toml, skills, memory и logs. Бинарник hermes в ~/.local/bin/hermes. Используйте подкоманды hermes config, а не слепое редактирование—значения мастера соответствуют документированным ключам.

Hermes работает на Apple Silicon Mac mini?

Да—скрипт установки поддерживает macOS на Apple Silicon. Gateway и local backend нативно; Rosetta не нужен для Python-стека от uv.

Как обновить Hermes?

hermes update
hermes doctor

После обновления перезапустите gateway под launchd: launchctl kickstart -k gui/$(id -u)/com.hermes.gateway.

Related reading

• Прогноз GPT-5.6: Codex open source для эффективности агентов