2026 Hermes Agent: install runbook — macOS / Linux / WSL2, Telegram Gateway 7×24, triage

Шесть install-ловушек: почему «только README» часто не взлетает

К концу мая 2026 Nous Research выкатил Hermes v0.15.2 — параллельно pip install hermes-agent и классический curl | bash. Хайп есть, friction в первый час на реальной машине тоже. Прогоните checklist до переустановки и до issue в upstream.

1. PATH не перезагружен: installer дописывает hermes в ~/.zshrc/~/.bashrc. Без source или нового tab — ложный hermes: command not found при успешном install.
2. System Python vs venv: python3 -m hermes мимо venv → missing dotenv и прочее. Канонический бинарь: ~/.hermes/hermes-agent/venv/bin/hermes.
3. Только CLI, без «мозга»: REPL открывается, сразу API key not set — пропущены hermes setup / hermes model.
4. Gateway ≠ CLI: Telegram требует long-running hermes gateway. Разовый hermes чат на телефон не пробросит.
5. Group Privacy в Telegram: дефолт бота — только slash в группах. Без BotFather кажется, что «бот мёртв».
6. Half-migration v0.14→v0.15: поля конфига сдвинулись. Сначала hermes config check && hermes config migrate, потом копать Missing config after update.

One-liner про OpenClaw: силён в multi-channel Gateway и npm/Compose-опсах. Hermes — MEMORY.md/USER.md, post-task Skill capture, MCP. На одном Mac — разные ~/.hermes и ~/.openclaw; здесь только install lane. Концепт и железо — в статье про persistent memory; кривая Skills — в 30-дневном отчёте.

Для команды заранее разведите три вопроса: baseline OS принимает installer? LLM provider одобрен security? Gateway переживёт ночь и выходные? Этот runbook закрывает первые два за одну сессию; третий — почему у MACCOME рядом лежат hosting-матрицы.

Security спрашивает «куда стучится Hermes кроме LLM». Фактически: API модели, Telegram long-poll/webhook, ваши MCP endpoints, GitHub при обновлении Skills. Зафиксируйте в change ticket. ~/.hermes/.env — prod secrets, не export в shell «на один раз».

Environment: что реально нужно на диске

Официальный installer тянет Python 3.11 (uv), Node 22, ripgrep, ffmpeg на full path. От вас: рабочий git, HTTPS до GitHub raw и LLM vendor. Headless Linux без browser automation — флаг --skip-browser, минус вес Camoufox.

Remote Mac = local shell: SSH, те же команды, Gateway под launchd/systemd после smoke. Для cloud-routed моделей RTT до region API важнее бренда CPU; UMA выручает, когда browser Skills и несколько Gateway делят один box.

WSL2: держите дерево на ext4 внутри Linux, не на /mnt/c — иначе file watchers и SQLite WAL на DrvFS ломаются. На ночной Gateway test отключите sleep Windows; половина «багов Linux» — хост усыпил WSL. Corporate proxy режет raw GitHub — mirror install.sh или pip install hermes-agent из internal PyPI.

8-step runbook: от одной команды до Telegram online

Одинаково на macOS, Linux, WSL2. Не скипайте gate — hermes doctor дешевле, чем час дебага «почему снова не то».

1. Install: официальный script (bash ниже). OK: Hermes Agent installed at ~/.hermes (или эквивалент в свежих билдах).
2. Reload shell: source ~/.zshrc / source ~/.bashrc или новый tab.
3. Health: hermes doctor (~12 checks). hermes --version → v0.15.x на stable.
4. Models: hermes setup для первого раза; иначе hermes model или hermes config set OPENROUTER_API_KEY sk-or-xxxx в ~/.hermes/.env.
5. Smoke: hermes, лёгкая задача (list cwd) — tool loop жив.
6. Telegram bot: @BotFather → /newbot, token в vault; @userinfobot → numeric user ID.
7. Gateway config: hermes gateway setup + Telegram, или env TELEGRAM_BOT_TOKEN + TELEGRAM_ALLOWED_USERS.
8. Daemonize: debug — hermes gateway; prod — hermes gateway install && hermes gateway start (launchd/systemd).

Шаг 8 — переход «installed» → «production». Foreground Gateway умирает с обрывом SSH без tmux; user-level service на macOS переживает logout при корректном install; на Linux сервере — --system + sudo.

LLM provider в 2026

Cloud routing на каждый день — чаще всего OpenRouter для multi-model экспериментов. Enterprise на Claude — Anthropic API/OAuth в hermes model. Zero-config trial — Nous Portal (hermes setup --portal). Privacy — Ollama base URL в том же wizard. v0.15: Grok + x_search; включайте в hermes tools только нужное, чтобы не раздувать context.

Telegram ops: токены не в git; leak → regenerate в BotFather. TELEGRAM_ALLOWED_USERS — только numeric ID, не @handle. Сначала DM, потом группы — иначе отлаживаете два unknown одновременно.

Hard metrics: version, stars, Skill compounding

• GitHub stars (срез июнь 2026): ~174 720, MIT — сверяйте tag в Releases (stable v0.15.2 / 2026.5.29.2).
• Footprint: ~1.5 GB с дефолтным Skills registry; RSS Gateway часто ~4.2 GB с browser automation — на Apple Silicon UMA мягче.
• Skill compounding (30-day post): Skills 3→19 за 30 дней, ~−38% tokens на repeat task classes — только при 7×24 uptime хоста.

Stars — про hype, не про ваш SLO. Операционно смотрите quota диска, RSS Gateway и растут ли Skills/sessions, пока вы offline. Gateway uptime <90% в первый месяц — экономию токенов считайте гипотезой.

12 типовых ошибок (triage table)

Держите под рукой в первую неделю support. Нет match — снимите hermes doctor + Gateway logs до GitHub issue (v0.15.x ещё двигается).

Platform matrix: ноутбук, VPS, аренда Mac Mini M4

Install green — бинарь бежит. Telegram prod + Skill compounding — хост не падает. Ниже тот же framing, что MACCOME даёт, когда спрашивают «хватит ли личного MacBook» — на POC после обеда часто да, на месяц Gateway traffic — редко.

MacBook отлично закрывает шаги 1–5. Плохо, когда шаг 8 должен пережить travel, sleep и OS updates без «открой терминал». x86 VPS даёт uptime, но может не иметь macOS-native curl | bash и Camoufox Skill path, который вы уже валидировали на Apple Silicon. Raspberry Pi — boot Gateway можно, I/O и thermal на long agent tasks — боль. Аренда Mac Mini M4 — пересечение: реальный macOS, DC power, launchd 1:1 с этим runbook.

FinOps сравнивает rent vs buy Mini. В spreadsheet — электричество, static IP, физический риск, ваши ops-часы, не только MSRP. Rent = OpEx, который можно обрубить, если эксперимент не взлетел.

Итог: install — только вход; uptime решает, станет ли агент дешевле

По восьми шагам большинство получает первый CLI + ответ Gateway в Telegram за 30–60 минут, если API keys уже одобрены security. Дальше ломается не «install снова», а ops: sleep ноутбука, rotate token без restart Gateway, RAM starvation под browser Skills.

Три альтернативы, три слабых места. (a) Ноутбук не держит 7×24. (b) Малый x86 VPS без macOS-native install path и Camoufox workflow. (c) Свой Mini — Capex, домашний uplink и physical security на вас.

Если Hermes уже снимает рутину и нужны предсказуемый monthly, SSH handoff за минуты и tarball ~/.hermes/ перед сменой хоста — выделенный Mac Mini M4 MACCOME обычно чище для prod: настоящий Apple Silicon, native launchd, те же команды без rewrite paths. Архитектура: статья про MEMORY.md и SessionDB; кривая Skills: 30-day report; регион — на странице цен аренды Mac Mini, когда uptime важнее вашего travel schedule.