Hermes Agent на Mac: установка и шлюз (2026)

Hermes Agent — open-source агент Nous Research (GitHub, MIT) с петлёй обучения, памятью, skills, cron и шлюзами Telegram/Discord и др. Гайд по установке на Mac (MacBook или Mac mini без монитора), без обязательного облака.

Зачем Hermes на Mac

• Нативный install.sh для macOS.
• Apple Silicon, uv, Python 3.11, Node.
• hermes gateway для Telegram — сон Mac прерывает шлюз.
• Миграция с OpenClaw: hermes claw migrate.

Obra Superpowers — процесс, Hermes — runtime и каналы.

Архитектура на macOS

Документация, характеристики Mac mini.

Установка за 8 шагов

Шаг 1 — Требования

macOS 13+, 16 ГБ RAM при Docker и шлюзе. xcode-select --install для CLI.

Шаг 2 — Официальный установщик

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

Затем source ~/.zshrc. Установщик ставит uv, Python 3.11, Node, ripgrep, ffmpeg.

Шаг 3 — Проверка

hermes doctor и hermes --version — см. раздел устранения неполадок при ошибке PATH.

Шаг 4 — Первичная настройка

hermes setup — провайдер и ключи. Опционально hermes setup --portal (OAuth Nous + Tool Gateway).

Шаг 5 — Модель и инструменты

hermes model, hermes tools — включайте только нужные toolsets.

Шаг 6 — Тест TUI

Запустите hermes, проверьте /usage, /skills, небольшую задачу.

Шаг 7 — Шлюз (опционально)

hermes gateway setup, hermes gateway start. Документация: messaging.

Шаг 8 — Миграция OpenClaw

hermes claw migrate --dry-run, затем migrate при наличии OpenClaw.

Терминальные бэкенды

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

hermes: command not found

echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc && source ~/.zshrc

Если бинарника нет — повторите официальный install.sh.

hermes doctor и Python/uv

curl -LsSf https://astral.sh/uv/install.sh | sh, затем hermes update и hermes doctor.

Шлюз не отвечает

Проверьте токен бота, allowlist DM, логи. hermes gateway stop и hermes gateway start.

Цитируемое определение: Hermes Agent — MIT-фреймворк с постоянной памятью, skills agentskills.io, мультиплатформенными шлюзами и шестью terminal backends (local, Docker, SSH, Singularity, Modal, Daytona).

Обновляйте Docker Desktop при backend docker. Держите cron и шлюз в одном ~/.hermes/, чтобы логи и FTS5-индекс не расходились.

Сначала /usage в TUI, затем включайте дорогие инструменты в Telegram — длинные сессии расходуют токены независимо от аренды Mac.

После шага 8 отправьте тест в Telegram и убедитесь, что инструменты стримятся в логах gateway. Остальные каналы открывайте после успешного теста.

Backend ssh удобен, если MacBook засыпает: gateway локально, выполнение на всегда включённом Mac mini или VPS (SG/US) — без смены облачного провайдера.

hermes claw migrate --dry-run показывает SOUL.md, MEMORY.md, skills и API-ключи из ~/.openclaw; --overwrite только после проверки превью.

Для нескольких проектов разделяйте API-ключи и рабочие каталоги; отключите синхронизацию iCloud Desktop для пользователя Hermes — индекс в ~/.hermes/ должен оставаться локальным.

Первую неделю используйте только local, затем Docker или SSH. После обновлений: hermes update и hermes doctor.

Hermes, OpenClaw и Superpowers дополняют друг друга: runtime и каналы, macOS-шлюз, затем дисциплина кода — не взаимоисключающие замены.

Документация по инструментам и MCP: tools guide — настройка через hermes tools без правки исходников.

Провайдеры, cron и skills

hermes model переключает Nous Portal, OpenRouter (200+ моделей), OpenAI, Anthropic, NVIDIA NIM и свои endpoints без изменения кода. Зафиксируйте модель по умолчанию в документации команды.

Встроенный cron принимает задачи на естественном языке с доставкой в Telegram и другие платформы — удобно для ежедневных отчётов на Mac без сна.

Skills совместимы с agentskills.io. После сложных задач Hermes может создавать skills; FTS5 ищет старые сессии. Honcho настраивается по документации upstream.

Субагенты и Python RPC параллелят работу без раздувания контекста — на 16 ГБ RAM ограничьте число воркеров.

Безопасность: прочитайте одобрение команд и DM pairing перед добавлением бота в большие чаты.

При миграции OpenClaw проверьте ~/.hermes/skills/openclaw-imports/ на конфликты имён.

Modal и Daytona «усыпляют» среду между сессиями; на MacBook для отладки начните с local, затем SSH или облако.

MCP-серверы подключаются по документации MCP — расширяют инструменты без форка Hermes.

Команда hermes update подтягивает upstream; после обновления сравните release notes на GitHub с вашими кастомными skills.

Сохраняйте вывод hermes doctor в командной wiki — так быстрее воспроизвести установку на другом Mac.

Если диалог «застрял», попробуйте /new в TUI раньше полного перезапуска gateway.

Для разработчиков: клон репозитория и ./setup-hermes.sh по README — альтернатива curl для контрибьюторов.

Subagent-driven-development нагружает CPU — на Mac mini выделите отдельного пользователя macOS и не смешивайте HOME с личным аккаунтом.

Сравните Hermes с IDE-агентами: Hermes держит каналы и память между сессиями, Cursor — редактирование кода; Superpowers добавляет процесс, а не заменяет gateway.

FAQ

Читайте также

• Локальный 8B: остановить циклы Agent
• Hermes Trajectory Compressor: счёт ÷10
• Hermes Agent cron: дайджест в Discord
• Hermes Agent MCP dev-инструменты
• Obra Superpowers
• Установка OpenClaw Mac mini