🎯 О чём этот конспект: Пошаговое руководство по развертыванию Hermes Agent — мощного AI-агента, который работает локально на вашем Mac, но управляется через Telegram. В видео разбирается процесс установки, подключения мессенджеров, создание нескольких агентов с разными «душами» (персоналиями) и глубокая оптимизация конфигов для экономии токенов.

👤 Кому будет полезно: Вайбкодерам и разработчикам, которые хотят иметь персонального AI-ассистента с доступом к локальным файлам и терминалу, доступного с любого устройства через Telegram.

✨ Что получите: Полностью настроенную систему локального AI-агента, который умеет выполнять сложные workflow (транскрибация, поиск, кодинг), имеет веб-дашборд для аналитики и работает по модели «pay-as-you-go» без риска блокировок.

1. Быстрая установка и инициализация Hermes Agent

Контекст: Hermes Agent — это альтернатива Claude Code и OpenCoder, которая позволяет запускать AI-агента локально. Основное преимущество — гибкость в выборе провайдеров (OpenAI, Anthropic, OpenRouter) и возможность миграции навыков (skills) и MCP-инструментов из OpenClaude. Автор рекомендует использовать подписку OpenAI CodeX, так как она наиболее стабильна при работе через сторонние инструменты.

Тайминг: [01:02]

Выгода: Быстрый старт локального агента без сложной настройки окружения.

Как применить:

• Шаг 1: Установка — Терминал — Скопируйте и выполните команду установки с официального сайта:

curl -fsSL https://hermes.sh/install.sh | bash

• Шаг 2: Первичная настройка — Терминал — Выберите Recommended setup. При вопросе о миграции из OpenClaude выберите No (для чистой установки).
• Шаг 3: Выбор провайдера — Терминал — Выберите OpenAI (или OpenRouter/Anthropic). Введите API ключ или авторизуйтесь через браузер.
• Шаг 4: Выбор модели — Терминал — Выберите актуальную модель (например, gpt-4o или gpt-4-turbo).
• Шаг 5: Запуск — Терминал — Просто введите команду для начала чата:

hermes

Результат: Работающий AI-агент в терминале, готовый к выполнению команд и ответам на вопросы.

2. Подключение Telegram: превращаем агента в личного помощника

Контекст: Главная «фишка» Hermes — возможность управления локальным компьютером через Telegram. Агент работает как шлюз (gateway): вы пишете боту в Telegram, а он выполняет команды на вашем Mac (например, проверяет директории, пишет код или запускает скрипты).

Тайминг: [03:41], [04:48]

Выгода: Управление рабочими процессами и AI-агентом с телефона из любой точки мира.

Как применить:

• Шаг 1: Создание бота — Telegram — Найдите @BotFather, создайте нового бота (/newbot) и скопируйте API Token.
• Шаг 2: Получение User ID — Telegram — Найдите @userinfobot, нажмите Start и скопируйте ваш числовой ID (это нужно для безопасности, чтобы только вы могли управлять агентом).
• Шаг 3: Настройка шлюза — Терминал — Запустите команду конфигурации:

hermes setup gateway

• Шаг 4: Ввод данных — Терминал — Выберите Telegram, вставьте Token бота и ваш User ID. На вопрос об установке как фонового сервиса (launch service) ответьте Yes.
• Шаг 5: Проверка — Telegram — Напишите боту hi или /new. Если бот не отвечает, перезапустите шлюз:

hermes gateway restart

Результат: Ваш локальный Mac теперь управляется через приватного Telegram-бота.

3. Использование веб-дашборда для аналитики и управления

Контекст: Hermes предоставляет графический интерфейс для мониторинга работы агента. Это критически важно для контроля расходов (токенов) и отладки сложных цепочек команд.

Тайминг: [06:33], [07:17]

Выгода: Визуальный контроль за потреблением токенов, историей сессий и логами в реальном времени.

Как применить:

• Шаг 1: Запуск дашборда — Терминал — Выполните команду:

hermes dashboard

• Шаг 2: Анализ сессий — Браузер — Вкладка Sessions позволяет искать старые переписки по ключевым словам.
• Шаг 3: Контроль токенов — Браузер — Вкладка Analytics показывает ежедневное потребление. Автор отмечает, что входные токены (Input) часто составляют основную часть затрат.
• Шаг 4: Мониторинг логов — Браузер — Вкладка Logs полезна для отладки, если агент ведет себя странно или не может выполнить команду.

Результат: Полная прозрачность работы AI-системы.

4. Создание нескольких агентов с разными «душами» (Soul Files)

Контекст: Вы можете создать специализированных агентов для разных задач: один для написания кода, другой для анализа YouTube-видео, третий для планирования задач. Каждый агент имеет свой Soul File — системный промпт, определяющий его поведение и стиль общения.

Тайминг: [09:23], [10:11]

Выгода: Повышение качества ответов за счет узкой специализации промптов.

Как применить:

• Шаг 1: Создание профиля — Дашборд — Перейдите в Profiles, введите имя нового агента и нажмите Create.
• Шаг 2: Настройка личности — Дашборд — Нажмите на созданного агента. В поле Soul (личность) вставьте системный промпт.
• Шаг 3: Генерация промпта — ChatGPT/Claude — Используйте AI для создания идеальной «души». Пример промпта для генерации:

Создай файл личности (soul file) для Hermes AI агента. 
Этот агент — эксперт-разработчик. Он должен отвечать кратко, 
использовать буллет-поинты и выделять жирным ключевые концепции.

• Шаг 4: Активация — Терминал — Скопируйте команду активации профиля из дашборда и выполните её в терминале для настройки Telegram-бота под этого конкретного агента.

Результат: У вас есть несколько независимых ботов в Telegram, каждый из которых настроен под свою задачу.

5. Глубокая оптимизация конфига для экономии токенов

Контекст: По умолчанию агенты могут уходить в бесконечные циклы или перечитывать огромные файлы, что быстро сжигает баланс API. Автор делится своими настройками YAML-конфига, которые ограничивают «самодеятельность» AI и экономят деньги.

Тайминг: [12:16], [12:50]

Выгода: Снижение затрат на API до 40% и предотвращение бесконечных циклов размышлений.

Как применить:

• Шаг 1: Редактирование конфига — Дашборд — Перейдите в Config -> YAML.
• Шаг 2: Ограничение итераций — Измените maxTurns с 90 до 60. Этого достаточно для фикса багов, но не даст агенту бесконечно «тупить».
• Шаг 3: Ограничение чтения файлов — Установите fileReadMaxCharacters на 50,000. Это заставит AI использовать инструменты поиска (grep), а не читать весь файл целиком.
• Шаг 4: Настройка кэширования — Измените время жизни кэша контекста с 5 минут до 1 часа (1h). Это предотвратит повторную обработку длинных промптов, если вы отошли на перерыв.
• Шаг 5: Аварийный тормоз — Включите emergencyBrake, чтобы агент останавливался, если обнаружит, что делает одно и то же действие по кругу.

Результат: Более умное и экономное использование ресурсов LLM.

FAQ

В: Что делать, если бот в Telegram перестал отвечать? О: Чаще всего помогает команда в терминале hermes gateway restart. Это перезапускает службу связи между вашим компьютером и серверами Telegram.

В: Можно ли использовать Hermes на Windows или Linux? О: В видео показана установка на Mac, но Hermes поддерживает Linux. Для Windows рекомендуется использовать WSL2. Также автор упомянул возможность установки на VPS для работы 24/7.

В: Как агент получает доступ к моим локальным файлам? О: Агент работает от имени вашего пользователя. Вы можете спросить его pwd, чтобы узнать текущую директорию, и попросить перейти в папку проекта. Он может читать, писать и запускать файлы через терминал.

В: Можно ли подключить другие мессенджеры? О: Да, Hermes поддерживает Discord, Slack, WhatsApp (через шлюзы), Email и даже WeChat. Настройка аналогична Telegram через hermes setup gateway.

В: Зачем менять время кэширования на 1 час? О: По умолчанию кэш живет 5 минут. Если вы отправили агенту большой контекст (код проекта), а потом отошли попить кофе, через 5 минут кэш очистится. Следующий ваш вопрос заставит модель заново перерабатывать весь проект, что увеличит расход токенов. 1 час — оптимальный баланс.

Ресурсы и ссылки

• Hermes Agent — Официальный сайт проекта с документацией — https://hermes.sh
• OpenAI API — Провайдер моделей (рекомендуется CodeX подписка) — https://platform.openai.com
• OpenRouter — Альтернативный провайдер с доступом к сотням моделей — https://openrouter.ai
• BotFather — Бот для создания Telegram-ботов — https://t.me/botfather
• User Info Bot — Бот для получения вашего Telegram ID — https://t.me/userinfobot

Конспект создан на основе видео «How to Run Hermes AI Agent Locally & Connect to Telegram» канала Eric Tech. Все права на оригинальный материал принадлежат авторам. Источник: https://youtu.be/BWprePrNwWU