Как установить Hermes Agent: skills, Telegram и MCP

Обычный чат с нейросетью — это диалог: вы пишете, модель отвечает. Агент — это программа, которая может вызывать инструменты, держать сессии, работать из Telegram и подключать внешние сервисы. Hermes как раз про такой контур: один агент, несколько «поверхностей» доступа.

Agent-first vs gateway-first — где экономия времени

В русскоязычных обзорах часто сравнивают Hermes и OpenClaw одной формулой: Hermes оборачивает шлюз вокруг обучающегося агента, а OpenClaw — агента вокруг messaging-шлюза.

На практике это значит:

• Hermes (agent-first) — сначала поднимаете «мозг» и runtime, потом при желании вешаете Telegram/Discord как пульт. Удобно, если вам нужны повторяемые workflows, skills и learning loop.
• OpenClaw (gateway-first) — сильнее ставка на широкий набор каналов и экосистему skills вокруг шлюза. Берите, если критичен охват площадок, а не один «умный» self-hosted агент.

Экономия времени появляется, когда вы не прыгаете между вкладками, а даёте задачу в Telegram и получаете результат от уже настроенного агента с навыками под вашу рутину.

Когда хватит Salebot/n8n, а когда нужен Hermes

Если вам нужен ИИ-агент как «сотрудник с памятью процедур», а не только триггер «если событие — то действие», Hermes ближе. Если нужен чистый no-code конвейер без сервера агента — начните с n8n/Make/Salebot и не усложняйте.

Ниже — главный how-to блок. Повторяйте по шагам и не перескакивайте.

curl / Desktop installer и проверка hermes

Шаг 1. Установите Hermes

1. Desktop: скачайте installer с официального сайта Hermes Agent и установите.
2. Или CLI: выполните install-скрипт для вашей ОС (команды выше).
3. Откройте терминал и введите: hermes.

Признак успеха шага 1: команда hermes находится (нет ошибки «command not found»). Если ставили через bash — не забудьте source ~/.bashrc.

Шаг 2. Запустите setup — введите hermes setup (или сразу hermes setup --portal для пути через Nous Portal).

Шаг 3. Выберите провайдера и модель ≥64K через hermes model или мастер setup. Убедитесь, что у модели контекст не меньше 64K.

Шаг 4. Первый верифицируемый чат — запустите hermes или hermes --tui. Задайте простой вопрос: «Ответь одним предложением: ты на связи?»

Признак успеха: осмысленный короткий ответ, без пустой строки и без ошибки auth.

Шаг 5. Проверьте сессию — выйдите и снова зайдите через hermes --continue (или -c). Список сессий: hermes sessions list.

Признак успеха всего контура: чат отвечает, --continue находит прошлую сессию, hermes doctor не орёт о критичных поломках.

Типичные ошибки новичка на этом этапе

1. Пустые ответы — сломан auth или кривая модель. Фикс: заново hermes model.
2. Модель <64K — агент не стартует или gateway «молчит». Фикс: сменить модель / поднять ctx-size.
3. Сразу полезли в Telegram и skills — пока CLI-чат красный, шлюз только добавит шума. Фикс: сначала зелёный чат.

Режимы setup: Quick, Full, Blank Slate

На свежей установке hermes setup предлагает три режима:

Blank Slate буквально «чистый лист»: агент почти голый. Потом вы сами включаете нужное через hermes tools, hermes skills opt-in --sync, hermes setup agent. Меньше сюрпризов, больше ручных шагов.

Секреты лежат в ~/.hermes/.env, настройки — в ~/.hermes/config.yaml. Не кладите токены в чат и в публичные репозитории.

Провайдер модели и первый верифицируемый ответ

Правило из документации: пока обычный чат не работает — не наращивайте gateway, cron, skills и routing. Это не бюрократия, а страховка от «я час крутил Telegram, а проблема была в ключе модели».

Диагностический минимум:

1. hermes doctor
2. hermes model
3. hermes setup
4. hermes sessions list
5. hermes --continue
6. (позже) hermes gateway status

Когда CLI-чат зелёный, можно вынести Hermes туда, где вы и так сидите — в Telegram.

hermes gateway setup и allowlist

Шаг 1. Создайте бота у @BotFather и сохраните токен.

Шаг 2. Узнайте свой числовой user ID (через @userinfobot или аналог). Username вида @ivan — недостаточно.

Шаг 3. Запустите hermes gateway setup и пройдите интерактивную настройку платформ.

Шаг 4. Пропишите allowlist: переменная TELEGRAM_ALLOWED_USERS или в конфиге telegram.allow_from — только ваши числовые ID.

Шаг 5. Запуск:

• для проверки: hermes gateway (на переднем плане);
• для постоянной работы: hermes gateway install (user service); на Linux system — sudo hermes gateway install --system;
• статус: hermes gateway status.

Опционально: pairing — бот шлёт код в DM, вы подтверждаете через hermes pairing approve telegram ….

Флаг TELEGRAM_ALLOW_ALL_USERS=true включайте только осознанно: чужие пользователи смогут жечь ваши токены модели и запускать команды.

Полезные команды в мессенджере: /new или /reset, /model, /status, /sethome, /reload-mcp, /approve / /deny, / + имя skill.

Почему gateway «молчит» и как проверить доставку

Чеклист, если бот жив, а ответов нет:

1. Токен верный? Один токен = один инстанс.
2. В allowlist именно числовой ID, не username?
3. hermes gateway status показывает running?
4. CLI-чат до этого отвечал? Если нет — чините модель, не Telegram.
5. Нет второго процесса с тем же токеном?

Hermes умеет и другие каналы (Discord, Slack, WhatsApp и др.), но для старта из РФ достаточно Telegram.

Что такое MCP-сервер на пальцах

Без MCP вы снова и снова объясняете агенту, «куда нажать». С MCP — подключаете сервер один раз в конфиге.

Один рабочий MCP: tools per platform без перегруза

В ~/.hermes/config.yaml блок mcp_servers:. Пример из quickstart (GitHub):

mcp_servers:
  github:
    command: npx
    args: ["-y", "@modelcontextprotocol/server-github"]
    env:
      GITHUB_PERSONAL_ACCESS_TOKEN: "ghp_xxx"

Есть и каталог Nous: hermes mcp, hermes mcp catalog, hermes mcp install <name> (в том числе n8n, linear, github). Ключи — в .env. После правок в сессии: /reload-mcp.

Правило новичка: один MCP на первый вечер. Не ставьте пять серверов «на будущее» — сложнее отладить, кто виноват в ошибке.

Продвинутый угол (не обязателен на старте): сам Hermes может выступать MCP-сервером для Cursor/Claude Code и отдавать мост к messaging-платформам.

Дополнительно держите под рукой: hermes doctor → цепочку из раздела про первый чат.

Когда чеклист зелёный, не расползайтесь сразу на десять MCP. Следующий осмысленный шаг — контент-контур:

1. Один skill под ваш формат постов/брифов.
2. Один канал доставки (Telegram).
3. Одна связка с инструментами (MCP filesystem/GitHub или позже n8n).
4. Learning loop с обязательным approve записей skills.

Так вы переходите от «поставил гермес агент» к системе: как создать AI-агента под свои задачи и не утонуть в конфигах. Если нужен следующий уровень — вайбкодинг, автопубликации, связка агентов и обучение автоматизации — это уже контур «Контент-завода» и практики команды Maya / Kovcheg: от одного агента к повторяемому производству контента без ручного хаоса.

Если нужен системный маршрут от одного агента к контент-контуру (Make, автопубликации, вайбкодинг) — смотрите обучение по автоматизации и вайбкодингу на kv-ai.ru: практика под задачи маркетинга и команд, без «магии вместо процесса».