Установите своего провайдера с помощью hermes model или отредактировав ~/.hermes/.env. См. ссылку Переменные среды для всех ключей поставщика.
Работает ли это в Windows?
Не изначально. Для агента Hermes требуется Unix-подобная среда. В Windows установите WSL2 и запустите Hermes изнутри. Стандартная команда установки отлично работает в WSL2:
Подробные инструкции, поддерживаемые дополнительные возможности и текущие ограничения см. в Руководстве по Termux.
Важное предостережение: полная дополнительная версия .[all] в настоящее время недоступна на Android, поскольку дополнительная версия voice зависит от faster-whisper → ctranslate2, а ctranslate2 не публикует колеса Android. Вместо этого используйте проверенное дополнение .[termux].
Мои данные куда-нибудь отправляются?
Вызовы API передаются только тому поставщику LLM, который вы настроили (например, OpenRouter, ваш локальный экземпляр Ollama). Агент Hermes не собирает телеметрию, данные об использовании или аналитику. Ваши разговоры, память и навыки хранятся локально в ~/.hermes/.
Могу ли я использовать его в автономном режиме/с локальными моделями?
Да. Запустите hermes model, выберите Пользовательская конечная точка и введите URL-адрес вашего сервера:
hermesmodel
# Select: Custom endpoint (enter URL manually)# API base URL: http://localhost:11434/v1# API key: ollama# Model name: qwen3.5:27b# Context length: 32768 ← set this to match your server's actual context window
Hermes сохраняет конечную точку, поставщика и базовый URL-адрес в config.yaml, чтобы он выдержал перезагрузку. Если на вашем локальном сервере загружена ровно одна модель, /model custom автоматически обнаружит ее. Вы также можете установить provider: custom в config.yaml — это первоклассный провайдер, а не псевдоним для чего-либо еще.
Это работает с Ollama, vLLM, сервером llama.cpp, SGLang, LocalAI и другими. Подробности см. в Руководстве по настройке.
:::совет пользователям Олламы
Если вы установили собственный num_ctx в Ollama (например, ollama run --num_ctx 16384), обязательно установите соответствующую длину контекста в Hermes — /api/show Ollama сообщает максимальный контекст модели, а не эффективный num_ctx, который вы настроили.
💡 Tip
Тайм-ауты с локальными моделями
Hermes автоматически определяет локальные конечные точки и уменьшает тайм-ауты потоковой передачи (тайм-аут чтения увеличен со 120 до 1800 с, обнаружение устаревшего потока отключено). Если вы по-прежнему сталкиваетесь с тайм-аутами в очень больших контекстах, установите `HERMES_STREAM_READ_TIMEOUT=1800` в своем `.env`. Подробности см. в [Руководстве по локальному LLM](../guides/local-llm-on-mac.md#timeouts).
Сколько это стоит?
Сам агент Hermes является бесплатным и с открытым исходным кодом (лицензия MIT). Вы платите только за использование LLM API от выбранного вами провайдера. Локальные модели можно запускать совершенно бесплатно.
Могут ли несколько человек использовать один экземпляр?
Да. Шлюз обмена сообщениями позволяет нескольким пользователям взаимодействовать с одним и тем же экземпляром агента Hermes через Telegram, Discord, Slack, WhatsApp или Home Assistant. Доступ контролируется с помощью списков разрешенных (определенные идентификаторы пользователей) и сопряжения DM (доступ к запросу первого пользователя, отправившего сообщение).
В чем разница между памятью и навыками?
Память хранит факты – то, что агент знает о вас, ваших проектах и предпочтениях. Воспоминания извлекаются автоматически в зависимости от их актуальности.
Хранилище навыков. Процедуры — пошаговые инструкции о том, как что-то делать. Навыки вызываются, когда агент сталкивается с аналогичной задачей.
Оба сохраняются между сеансами. Подробности см. в Память и Навыки.
Могу ли я использовать его в своем собственном проекте Python?
Да. Импортируйте класс AIAgent и используйте Hermes программно:
Причина: Ваша оболочка не перезагрузила обновленный PATH.
Решение:
# Reload your shell profilesource~/.bashrc# bashsource~/.zshrc# zsh# Or start a new terminal session
Если это по-прежнему не работает, проверьте место установки:
whichhermes
ls~/.local/bin/hermes
:::совет
Установщик добавляет ~/.local/bin в ваш PATH. Если вы используете нестандартную конфигурацию оболочки, добавьте export PATH="$HOME/.local/bin:$PATH" вручную.
Версия Python слишком старая
Причина: Hermes требует Python 3.11 или более поздней версии.
Решение:
python3--version# Check current version# Install a newer Python
sudoaptinstallpython3.12# Ubuntu/Debian
brewinstallpython@3.12# macOS
Установщик обрабатывает это автоматически — если вы видите эту ошибку во время установки вручную, сначала обновите Python.
Команды терминала говорят node: command not found (или nvm, pyenv, asdf, …)
Причина: Hermes создает снимок среды для каждого сеанса, запуская bash -l один раз при запуске. Оболочка входа в bash читает /etc/profile, ~/.bash_profile и ~/.profile, но не использует исходный код ~/.bashrc — поэтому инструменты, которые там устанавливаются (nvm, asdf, pyenv, cargo, пользовательские PATH экспортируются), остаются невидимый на снимке. Чаще всего это происходит, когда Hermes работает под systemd или в минимальной оболочке, где ничего предварительно не загружает профиль интерактивной оболочки.
Решение: Hermes автоматически использует ~/.bashrc по умолчанию. Если этого недостаточно — например. вы являетесь пользователем zsh, чей PATH находится в ~/.zshrc, или вы инициализируете nvm из отдельного файла — перечислите дополнительные файлы для источника в ~/.hermes/config.yaml:
terminal:shell_init_files:-~/.zshrc# zsh users: pulls zsh-managed PATH into the bash snapshot-~/.nvm/nvm.sh# direct nvm init (works regardless of shell)-/etc/profile.d/cargo.sh# system-wide rc files# When this list is set, the default ~/.bashrc auto-source is NOT added —# include it explicitly if you want both:# - ~/.bashrc# - ~/.zshrc
Отсутствующие файлы автоматически пропускаются. Поиск источников происходит в bash, поэтому файлы, использующие только синтаксис zsh, могут вызывать ошибки — если это вас беспокоит, используйте только часть настройки PATH (например, напрямую nvm.sh nvm), а не весь rc-файл.
Чтобы отключить поведение автоматического источника (только строгая семантика оболочки входа):
terminal:auto_source_bashrc:false
uv: command not found
Причина: Менеджер пакетов uv не установлен или отсутствует в PATH.
Причина: Недостаточно разрешений на запись в каталог установки.
Решение:
# Don't use sudo with the installer — it installs to ~/.local/bin# If you previously installed with sudo, clean up:
sudorm/usr/local/bin/hermes
# Then re-run the standard installer
curl-fsSLhttps://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh|bash
Проблемы с поставщиком и моделью
/model показывает только одного провайдера/невозможно переключать провайдера
Причина:/model (внутри сеанса чата) может переключаться только между провайдерами, которые вы уже настроили. Если вы настроили только OpenRouter, это все, что покажет /model.
Решение: Выйдите из сеанса и используйте hermes model со своего терминала, чтобы добавить новых поставщиков:
# Exit the Hermes chat session first (Ctrl+C or /quit)# Run the full provider setup wizard
hermesmodel
# This lets you: add providers, run OAuth, enter API keys, configure endpoints
После добавления нового провайдера через hermes model начните новый сеанс чата — /model теперь покажет всех настроенных вами провайдеров.
:::совет Краткая справка
| Хотите... | Использование |
|-----------|-----|
| Добавить нового провайдера | hermes model (с терминала) |
| Ввести/изменить ключи API | hermes model (с терминала) |
| Переключить модель в середине сессии | /model <name> (внутренний сеанс) |
| Переключиться на другого настроенного провайдера | /model provider:model (внутренний сеанс) |
API-ключ не работает
Причина: Ключ отсутствует, срок его действия истек, он установлен неправильно или принадлежит не тому поставщику.
Решение:
# Check your configuration
hermesconfigshow
# Re-configure your provider
hermesmodel
# Or set directly
hermesconfigsetOPENROUTER_API_KEYsk-or-v1-xxxxxxxxxxxx
:::предупреждение
Убедитесь, что ключ соответствует поставщику. Ключ OpenAI не будет работать с OpenRouter и наоборот. Проверьте ~/.hermes/.env на наличие конфликтующих записей.
Модель недоступна / модель не найдена
Причина: Идентификатор модели неверен или недоступен у вашего провайдера.
Решение:
# List available models for your provider
hermesmodel
# Set a valid model
hermesconfigsetHERMES_MODELanthropic/claude-opus-4.7
# Or specify per-session
hermeschat--modelopenrouter/meta-llama/llama-3.1-70b-instruct
Ограничение скорости (429 ошибок)
Причина: Вы превысили ограничения скорости вашего провайдера.
Решение. Подождите немного и повторите попытку. Для длительного использования учитывайте:
- Обновление плана вашего провайдера
- Переход на другую модель или поставщика
- Использование hermes chat --provider <alternative> для маршрутизации на другой сервер.
Превышена длина контекста
Причина: Разговор стал слишком длинным для контекстного окна модели, или Hermes обнаружил неправильную длину контекста для вашей модели.
Решение:
# Compress the current session
/compress
# Or start a fresh session
hermeschat
# Use a model with a larger context window
hermeschat--modelopenrouter/google/gemini-3-flash-preview
Если это произойдет при первом длинном разговоре, возможно, у Гермеса неправильная длина контекста для вашей модели. Проверьте, что он обнаружил:
Посмотрите на строку запуска CLI — она показывает длину обнаруженного контекста (например, 📊 Context limit: 128000 tokens). Вы также можете проверить это с помощью /usage во время сеанса.
Чтобы исправить обнаружение контекста, установите его явно:
# In ~/.hermes/config.yamlmodel:default:your-model-namecontext_length:131072# your model's actual context window
Или для пользовательских конечных точек добавьте их для каждой модели:
См. Определение длины контекста, чтобы узнать, как работает автоматическое определение, и обо всех параметрах переопределения.
Проблемы с терминалом
Команда заблокирована как опасная
Причина: Hermes обнаружил потенциально разрушительную команду (например, rm -rf, DROP TABLE). Это функция безопасности.
Решение. При появлении запроса просмотрите команду и введите y, чтобы одобрить ее. Вы также можете:
- Попросите агента использовать более безопасную альтернативу.
- Полный список опасных шаблонов смотрите в Документации по безопасности.
:::совет
Это работает так, как задумано: Гермес никогда молча не запускает деструктивные команды. В запросе на утверждение показано, что именно будет выполнено.
sudo не работает через шлюз обмена сообщениями
Причина: Шлюз обмена сообщениями работает без интерактивного терминала, поэтому sudo не может запросить пароль.
Решение:
- Избегайте sudo в сообщениях — попросите агента найти альтернативы.
- Если вам необходимо использовать sudo, настройте sudo без пароля для определенных команд в /etc/sudoers.
- Или переключитесь на интерфейс терминала для задач администрирования: hermes chat
Серверная часть Docker не подключается
Причина: Демон Docker не запущен или у пользователя отсутствуют разрешения.
Решение:
# Check Docker is running
dockerinfo
# Add your user to the docker group
sudousermod-aGdocker$USER
newgrpdocker
# Verify
dockerrunhello-world
Проблемы с сообщениями
Бот не отвечает на сообщения
Причина: Бот не запущен, не авторизован или вашего пользователя нет в белом списке.
Решение:
# Check if the gateway is running
hermesgatewaystatus
# Start the gateway
hermesgatewaystart
# Check logs for errors
cat~/.hermes/logs/gateway.log|tail-50
Сообщения не доставляются
Причина: проблемы с сетью, срок действия токена бота истек или неправильная конфигурация веб-перехватчика платформы.
Решение:
- Убедитесь, что ваш токен бота действителен с помощью hermes gateway setup.
- Проверьте журналы шлюза: cat ~/.hermes/logs/gateway.log | tail -50.
- Для платформ на основе веб-перехватчиков (Slack, WhatsApp) убедитесь, что ваш сервер общедоступен.
Путаница в белом списке: кто может разговаривать с ботом?
Причина: Режим авторизации определяет, кто получит доступ.
Решение:
Режим
Как это работает
Белый список
Взаимодействовать могут только идентификаторы пользователей, указанные в конфигурации
Сопряжение с DM
Первый пользователь, отправивший сообщение в DM, претендует на эксклюзивный доступ
Открыто
Взаимодействовать может любой желающий (не рекомендуется для производства)
Причина: отсутствуют зависимости, конфликты портов или неправильно настроенные токены.
Решение:
# Install messaging dependencies
pipinstall"hermes-agent[telegram]"# or [discord], [slack], [whatsapp]# Check for port conflicts
lsof-i:8080
# Verify configuration
hermesconfigshow
WSL: шлюз продолжает отключаться или происходит сбой hermes gateway start
Причина: Поддержка systemd в WSL ненадежна. Во многих установках WSL2 systemd не включен, и даже если он включен, службы могут не пережить перезапуск WSL или завершение работы Windows в режиме ожидания.
Решение. Используйте режим переднего плана вместо службы systemd:
Если вы все равно хотите попробовать systemd, убедитесь, что он включен:
Откройте /etc/wsl.conf (создайте его, если он не существует)
Добавьте:
ini
[boot]
systemd=true
Из PowerShell: wsl --shutdown.
Снова откройте терминал WSL.
Проверьте: systemctl is-system-running должно быть указано «работает» или «деградация».
💡 Tip
Автозапуск при загрузке Windows
Для надежного автозапуска используйте планировщик задач Windows для запуска WSL + шлюза при входе в систему:
1. Создайте задачу, выполняющую `wsl -d Ubuntu -- bash -lc 'hermes gateway run'`.
2. Установите срабатывание при входе пользователя в систему.
macOS: Node.js/ffmpeg/другие инструменты, не найденные шлюзом
Причина: службы launchd наследуют минимальный PATH (/usr/bin:/bin:/usr/sbin:/sbin), который не включает Homebrew, nvm, Cargo или другие каталоги инструментов, установленных пользователем. Обычно это нарушает мост WhatsApp (node not found) или транскрипцию голоса (ffmpeg not found).
Решение. Шлюз фиксирует PATH вашей оболочки, когда вы запускаете hermes gateway install. Если вы установили инструменты после настройки шлюза, перезапустите установку, чтобы сохранить обновленный PATH:
hermesgatewayinstall# Re-snapshots your current PATH
hermesgatewaystart# Detects the updated plist and reloads
Вы можете убедиться, что plist имеет правильный PATH:
Причина: Большая модель, удаленный сервер API или сложная системная подсказка со множеством инструментов.
Решение:
- Попробуйте более быструю/меньшую модель: hermes chat --model openrouter/meta-llama/llama-3.1-8b-instruct.
- Уменьшить активные наборы инструментов: hermes chat -t "terminal"
- Проверьте задержку вашей сети у провайдера
- Для локальных моделей убедитесь, что у вас достаточно видеопамяти графического процессора.
Высокое использование токенов
Причина: Длинные разговоры, подробные системные подсказки или многочисленные вызовы инструментов, накапливающие контекст.
Решение:
# Compress the conversation to reduce tokens
/compress
# Check session token usage
/usage
:::совет
Регулярно используйте /compress во время длительных сеансов. Он суммирует историю разговоров и значительно сокращает использование токенов, сохраняя при этом контекст.
Сеанс становится слишком длинным
Причина. В расширенных беседах накапливаются сообщения и выходные данные инструментов, приближаясь к контекстным ограничениям.
Решение:
# Compress current session (preserves key context)
/compress
# Start a new session with a reference to the old one
hermeschat
# Resume a specific session later if needed
hermeschat--continue
Проблемы с MCP
Сервер MCP не подключается
Причина: Двоичный файл сервера не найден, неверный путь к команде или отсутствует среда выполнения.
Решение:
# Ensure MCP dependencies are installed (already included in standard install)cd~/.hermes/hermes-agent&&uvpipinstall-e".[mcp]"# For npm-based servers, ensure Node.js is available
node--version
npx--version
# Test the server manually
npx-y@modelcontextprotocol/server-filesystem/tmp
Причина: Сервер запущен, но обнаружение инструментов не выполнено, инструменты были отфильтрованы конфигурацией или сервер не поддерживает ожидаемые возможности MCP.
Решение:
- Проверьте журналы шлюза/агента на наличие ошибок подключения MCP.
- Убедитесь, что сервер отвечает на метод tools/list RPC.
- Проверьте любые настройки tools.include, tools.exclude, tools.resources, tools.prompts или enabled на этом сервере.
- Помните, что утилиты ресурсов/подсказок регистрируются только тогда, когда сеанс действительно поддерживает эти возможности.
- Используйте /reload-mcp после изменения конфигурации.
# Verify MCP servers are configured
hermesconfigshow|grep-A12mcp_servers
# Restart Hermes or reload MCP after config changes
hermeschat
Причина: Сервер MCP слишком долго отвечает или произошел сбой во время выполнения.
Решение:
- Увеличьте время ожидания в конфигурации вашего сервера MCP, если это поддерживается.
- Проверьте, запущен ли процесс сервера MCP.
- Для удаленных серверов HTTP MCP проверьте сетевое подключение.
:::предупреждение
Если сервер MCP выйдет из строя во время запроса, Hermes сообщит об истечении времени ожидания. Проверьте собственные журналы сервера (а не только журналы Hermes), чтобы определить основную причину.
Профили
Чем профили отличаются от просто настройки HERMES_HOME?
Профили — это управляемый уровень поверх HERMES_HOME. Вы можете вручную задать HERMES_HOME=/some/path перед каждой командой, но профили выполняют всю работу за вас: создают структуру каталогов, генерируют псевдонимы оболочки (hermes-work), отслеживают активный профиль в ~/.hermes/active_profile и автоматически синхронизируют обновления навыков между всеми профилями. Они также интегрируются с функцией завершения табуляции, поэтому вам не нужно запоминать пути.
Могут ли два профиля использовать один и тот же токен бота?
Нет. Каждая платформа обмена сообщениями (Telegram, Discord и т. д.) требует эксклюзивного доступа к токену бота. Если два профиля попытаются использовать один и тот же токен одновременно, второй шлюз не сможет подключиться. Создайте отдельного бота для каждого профиля. Для Telegram обратитесь к @BotFather, чтобы создать дополнительных ботов.
Профили совместно используют память или сеансы?
Нет. Каждый профиль имеет собственное хранилище памяти, базу данных сеансов и каталог навыков. Они полностью изолированы. Если вы хотите создать новый профиль с существующими воспоминаниями и сеансами, используйте hermes profile create newname --clone-all, чтобы скопировать все из текущего профиля.
Что произойдет, если я запущу hermes update?
hermes update извлекает последнюю версию кода и переустанавливает зависимости один раз (не для каждого профиля). Затем он автоматически синхронизирует обновленные навыки со всеми профилями. Вам нужно запустить hermes update только один раз — он охватывает каждый профиль на машине.
Сколько профилей я могу запустить?
Жестких ограничений нет. Каждый профиль — это просто каталог под ~/.hermes/profiles/. Практический предел зависит от вашего дискового пространства и количества одновременных шлюзов, которые может обрабатывать ваша система (каждый шлюз представляет собой облегченный процесс Python). Запускать десятки профилей — это нормально; каждый профиль ожидания не использует ресурсы.
Рабочие процессы и шаблоны
Использование разных моделей для разных задач (рабочие процессы с несколькими моделями)
Сценарий: вы используете GPT-5.4 в качестве ежедневного драйвера, но Gemini или Grok пишут более качественный контент для социальных сетей. Каждый раз переключать модели вручную утомительно.
Решение: настройка делегирования. Hermes может автоматически перенаправлять субагентов в другую модель. Установите это в ~/.hermes/config.yaml:
delegation:model:"google/gemini-3-flash-preview"# subagents use this modelprovider:"openrouter"# provider for subagents
Теперь, когда вы говорите Hermes: «Напишите мне в Твиттере об X», и он порождает субагент delegate_task, этот субагент работает на Gemini вместо вашей основной модели. Ваш основной разговор остается в формате GPT-5.4.
Вы также можете явно указать в своем приглашении: * «Делегируйте задачу по написанию сообщений в социальных сетях о запуске нашего продукта. Используйте субагента для фактического написания». * Агент будет использовать delegate_task, который автоматически подберет конфигурацию делегирования.
Для одноразового переключения модели без делегирования используйте /model в CLI:
/modelgoogle/gemini-3-flash-preview# switch for this session# ... write your content ...
/modelopenai/gpt-5.4# switch back
Дополнительную информацию о том, как работает делегирование, см. в разделе Делегирование субагента.
Запуск нескольких агентов на одном номере WhatsApp (привязка для каждого чата)
Сценарий. В OpenClaw у вас было несколько независимых агентов, привязанных к определенным чатам WhatsApp: один для группы семейного списка покупок, другой для вашего частного чата. Сможет ли Гермес сделать это?
Текущее ограничение: Для каждого профиля Hermes требуется собственный номер/сеанс WhatsApp. Вы не можете привязать несколько профилей к разным чатам на один и тот же номер WhatsApp — мост WhatsApp (Baileys) использует один сеанс с аутентификацией на каждый номер.
Обходной путь:
Используйте один профиль с переключением личности. Создайте разные файлы контекста AGENTS.md или используйте команду /personality, чтобы изменить поведение каждого чата. Агент видит, в каком чате он находится, и может адаптироваться.
Используйте задания cron для специализированных задач. Для отслеживания списка покупок настройте задание cron, которое будет отслеживать определенный чат и управлять списком — отдельный агент не требуется.
Используйте отдельные номера. Если вам нужны по-настоящему независимые агенты, свяжите каждый профиль с собственным номером WhatsApp. Для этого подойдут виртуальные номера из таких сервисов, как Google Voice.
Вместо этого используйте Telegram или Discord. Эти платформы более естественно поддерживают привязку каждого чата — каждая группа Telegram или канал Discord получает свой собственный сеанс, и вы можете запускать несколько токенов бота (по одному на каждый профиль) в одной учетной записи.
Управление тем, что отображается в Telegram (скрытие журналов и рассуждений)
Сценарий. В Telegram вместо окончательных результатов вы видите журналы выполнения шлюза, рассуждения Hermes и сведения о вызовах инструментов.
Решение: Параметр display.tool_progress в config.yaml определяет, насколько часто отображается активность инструмента:
display:tool_progress:"off"# options: off, new, all, verbose
off — Только окончательный ответ. Никаких вызовов инструментов, никаких рассуждений, никаких журналов.
new — Показывает новые вызовы инструментов по мере их возникновения (краткие однострочные сообщения).
all — показывает всю активность инструмента, включая результаты.
verbose — Полная информация, включая аргументы и выходные данные инструмента.
Для платформ обмена сообщениями обычно вам нужны off или new. После редактирования config.yaml перезапустите шлюз, чтобы изменения вступили в силу.
Вы также можете переключить это для каждого сеанса с помощью команды /verbose (если она включена):
display:tool_progress_command:true# enables /verbose in the gateway
Управление навыками в Telegram (ограничение количества команд с косой чертой)
Сценарий: Telegram имеет ограничение в 100 косых команд, и ваши навыки превышают его. Вы хотите отключить ненужные вам навыки в Telegram, но настройки hermes skills config, похоже, не вступили в силу.
Решение. Используйте hermes skills config, чтобы отключить навыки для каждой платформы. Это пишет config.yaml:
skills:disabled:[]# globally disabled skillsplatform_disabled:telegram:[skill-a,skill-b]# disabled only on telegram
После изменения перезапустите шлюз (hermes gateway restart или завершите работу и перезапустите). Командное меню Telegram-бота перестраивается при запуске.
:::совет
Навыки с очень длинными описаниями в меню Telegram сокращаются до 40 символов, чтобы не выходить за пределы размера полезной нагрузки. Если навыки не отображаются, возможно, проблема связана с общим размером полезной нагрузки, а не с ограничением количества команд в 100 — отключение неиспользуемых навыков помогает в обоих случаях.
Сеансы общих потоков (несколько пользователей, один разговор)
Сценарий. У вас есть ветка Telegram или Discord, в которой несколько человек упоминают бота. Вы хотите, чтобы все упоминания в этой теме были частью одного общего разговора, а не отдельных сеансов для каждого пользователя.
Текущее поведение: Hermes создает сеансы с ключом по идентификатору пользователя на большинстве платформ, поэтому каждый человек получает свой собственный контекст разговора. Это сделано для обеспечения конфиденциальности и изоляции контекста.
Обходной путь:
Используйте Slack. Сеансы Slack кодируются потоком, а не пользователем. Несколько пользователей в одной теме ведут один разговор — именно то поведение, которое вы описываете. Это наиболее естественный вариант.
Используйте групповой чат с одним пользователем. Если один человек является назначенным «оператором», который передает вопросы, сеанс остается единым. Другие могут читать вместе.
Используйте канал Discord. Сеансы Discord привязаны к каналу, поэтому все пользователи в одном канале имеют общий контекст. Используйте выделенный канал для общего разговора.
Экспорт Гермеса на другой компьютер
Сценарий: Вы накопили навыки, задания cron и память на одном компьютере и хотите перенести все на новый выделенный компьютер с Linux.
Решение:
Установите агент Hermes на новый компьютер:
bash
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
На исходном компьютере создайте полную резервную копию:
bash
hermes backup
При этом создается архив всего вашего каталога ~/.hermes/ — конфигурации, ключей API, воспоминаний, навыков, сеансов и профилей — сохраненного в вашем домашнем каталоге как ~/hermes-backup-<timestamp>.zip.
Скопируйте zip-архив на новый компьютер и импортируйте его:
```bash
# On the source machine
scp ~/hermes-backup-.zip newmachine:~/
# On the new machine
hermes import ~/hermes-backup-.zip
```
На новом компьютере запустите hermes setup, чтобы убедиться, что ключи API и конфигурация поставщика работают.
Перенос одного профиля на другой компьютер
Сценарий: вы хотите переместить или предоставить общий доступ к одному конкретному профилю, а не к полной установке.
# On the source machine
hermesprofileexportwork./work-backup.tar.gz
# Copy the file to the target machine, then:
hermesprofileimport./work-backup.tar.gzwork
Импортированный профиль будет содержать все конфигурации, воспоминания, сеансы и навыки из экспорта. Возможно, вам придется обновить пути или повторно пройти аутентификацию у поставщиков, если на новом компьютере установлены другие настройки.
hermes backup против hermes profile export
Особенность
hermes backup
hermes profile export
Случай использования
Полная миграция машины
Портирование/совместное использование определенного профиля
Объем
Глобальный (весь каталог ~/.hermes)
Локальный (единый каталог профилей)
Включает
Все профили, глобальная конфигурация, ключи API, сеансы
:::совет
hermes backup создает последовательный снимок, даже когда Hermes активно работает. Восстановленный архив исключает файлы локальной среды выполнения, такие как gateway.pid и cron.pid.
Разрешение отклонено при перезагрузке оболочки после установки
Сценарий: После запуска установщика Hermes source ~/.zshrc выдает ошибку отказа в доступе.
Причина: Обычно это происходит, когда ~/.zshrc (или ~/.bashrc) имеет неверные права доступа к файлу или когда установщик не может выполнить запись в него правильно. Это не проблема, специфичная для Hermes, а проблема с разрешениями конфигурации оболочки.
Решение:
# Check permissions
ls-la~/.zshrc
# Fix if needed (should be -rw-r--r-- or 644)
chmod644~/.zshrc
# Then reloadsource~/.zshrc
# Or just open a new terminal window — it picks up PATH changes automatically
Если установщик добавил строку PATH, но разрешения неверны, вы можете добавить ее вручную:
Сценарий: Установка завершается нормально, но первая попытка общения завершается с ошибкой HTTP 400.
Причина: Обычно имя модели не совпадает — настроенная модель не существует у вашего провайдера или у ключа API нет к ней доступа.
Решение:
# Check what model and provider are configured
hermesconfigshow|head-20
# Re-run model selection
hermesmodel
# Or test with a known-good model
hermeschat-q"hello"--modelanthropic/claude-opus-4.7
Если вы используете OpenRouter, убедитесь, что в вашем ключе API есть кредиты. Значение 400 от OpenRouter часто означает, что для модели требуется платный план или в идентификаторе модели допущена опечатка.