2026: лучшие практики долгосрочного обслуживания Hermes Agent — обновление, логи, резервное копирование и полное руководство по восстановлению

2. Типичные боли

1. Ограничение: без присмотра ≠ без обслуживания. Циклы macOS, Homebrew/pip и релизов Hermes не совпадают; hermes update без приёмки оставляет шлюз или cron в полуобновлённом состоянии.
2. Скрытая стоимость: PATH и окружение launchd. git и node работают в интерактивной оболочке, а шлюз под launchd не находит бинарники — в логах только размытые ошибки инструментов.
3. Стабильность и аудит: без бэкапа нет точки отката. Конфиг размазан по ~/.hermes/config.yaml, .env, skills и session DB; ключи только в чате рвут цепочку при ротации.

3. Что бэкапить (чек-лист перед обновлением)

Каталог данных по умолчанию — HERMES_HOME (обычно ~/.hermes). Пути уточняйте через hermes config path и hermes config env-path; у каждого профиля свой home.

Рекомендуемые команды: ежедневный быстрый снимок hermes backup --quick --label "pre-upgrade"; перед крупными изменениями hermes backup -o ~/hermes-backups/$(date +%F).zip. Восстановление — hermes import. Примечание: официальный бэкап не включает git-репозиторий кода Hermes (откат git vs pip различается).

4. Обновление без поломки окружения: ритм, матрицы и runbook из 7 шагов

4.1 Ритм обновлений: macOS, зависимости и Hermes

Не считайте автообновление безопасным по умолчанию. И git pull, и pip install --upgrade требуют цепочки: бэкап → обновление → минимальная приёмка задачи → сохранить zip для отката. Задайте update.backup: true в config.yaml или разово выполните hermes update --backup.

4.2 Runbook обновления и приёмки — 7 шагов

1. Baseline: запишите hermes version, hermes dump и hermes gateway status в тикет.
2. Бэкап: hermes backup --quick --label "pre-$(date +%Y%m%d)" или полный zip.
3. Предпроверка: hermes update --check; hermes doctor --fix для автоисправимых пунктов.
4. Обновление: в окне обслуживания hermes update --backup (git install тянет код и deps; pip — с PyPI).
5. Минимальная приёмка: hermes chat -q "reply OK"; при шлюзе — реальное сообщение из Telegram/Discord.
6. Тест перезапуска: hermes gateway restart; опционально reboot Mac для проверки автозапуска launchd.
7. Откат при сбое: hermes import <backup.zip>, или config/.env + hermes gateway restart; downgrade pip/git по способу установки.

5. Логи и health-check

5.1 Расположение логов и команды

Каталог по умолчанию: ~/.hermes/logs/ (для нестандартных профилей — соответствующий HERMES_HOME/logs/).

• agent.log — вызовы API, dispatch инструментов, жизненный цикл сессий (INFO+)
• errors.log — WARNING и выше; первая остановка при разборе
• gateway.log — подключения мессенджеров и webhooks

hermes logs list
hermes logs errors --since 30m -n 100
hermes logs gateway -f
hermes logs --level ERROR --since 2h --component tools

Фреймворк ротирует agent.log (например в agent.log.1). Архивируйте *.log.* старше 30 дней ежемесячно; ограничивайте checkpoint shadow repos через hermes checkpoints prune --max-size-mb 500.

5.2 Пороги health-check (ориентиры)

Ежедневные проверки можно скриптовать: hermes doctor + hermes logs errors --since 24h + df -h. Для внешних алертов направляйте ERROR в свой log pipeline (JSONL sidecar или hermes debug share --local для ручной выгрузки).

6. Перезагрузка, обрыв сети, сон и drill восстановления

После сна/пробуждения Mac сначала проверьте hermes gateway status; если не running — hermes gateway start (сценарий launchd install). После восстановления сети убедитесь, что gateway.log показывает reconnect.

Квартальный drill (добавьте в календарь):

1. Полный hermes backup во внешний каталог
2. Reboot Mac → подождать 3 мин → hermes status --deep
3. Тестовое сообщение из мессенджера + hermes cron tick (если есть cron)
4. Зафиксировать RTO: время от boot до доступности шлюза (цель < 5 мин, зависит от модели и login items)

На удалённых физических Mac (узлы ZoneMac) дополнительно проверьте: SSH доступен, тот же пользователь, что у launchd, PATH включает git/node — та же причина, что и проблемы PATH в устранении неполадок OpenClaw Gateway и launchd.

7. Секреты и ревизия прав

• API-ключи (OpenRouter, Anthropic и др.): ротация каждые 90 дней; hermes auth add/remove, не plaintext в skills.
• OAuth (Codex, Anthropic, Copilot): hermes auth status <provider>; при истечении — re-OAuth, не правки .env.
• Права инструментов: ежемесячно hermes tools list; отключайте неиспользуемые terminal/browser/MCP.
• Pairing и webhooks: hermes pairing list; чистите лишние подписки.

8. Календарь обслуживания (вставьте в Напоминания)

Цифры для внутренней wiki

• Каталог логов по умолчанию: ~/.hermes/logs/, ротация agent.log.1+
• Размер quick backup: от нескольких МБ до сотен МБ (зависит от сессий и skills); полный бэкап — резерв диска ≥ 2× HERMES_HOME
• Polling health шлюза в prod: status каждые 30–60 с; < 5 строк ERROR/ч как стартовый порог
• Лимит checkpoint repo: prune --max-size-mb 500 (подстройте под диск)

FAQ

В: Чем отличается откат при brew vs pip?

О: pip может переустановить предыдущий wheel; git install — git checkout на известный commit и reinstall deps. В обоих случаях откат пользовательских данных — через hermes import; не понижайте бинарник без восстановления конфига.

В: Как бэкапить несколько профилей?

О: hermes -p <name> backup для каждого HERMES_HOME профиля; после update с несколькими шлюзами — hermes gateway restart --all.