sidebar_position: 3 title: "FAQ & Troubleshooting" description: "Frequently asked questions and solutions to common issues with Hermes Agent" lang: ru


Часто задаваемые вопросы и устранение неполадок

Быстрые ответы и исправления для наиболее распространенных вопросов и проблем.


Часто задаваемые вопросы

Какие провайдеры LLM работают с Hermes?

Агент Hermes работает с любым API-интерфейсом, совместимым с OpenAI. Поддерживаемые поставщики включают:

Установите своего провайдера с помощью hermes model или отредактировав ~/.hermes/.env. См. ссылку Переменные среды для всех ключей поставщика.

Работает ли это в Windows?

Не изначально. Для агента Hermes требуется Unix-подобная среда. В Windows установите WSL2 и запустите Hermes изнутри. Стандартная команда установки отлично работает в WSL2:

curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash

Работает ли это на Android/Termux?

Да — у Hermes теперь есть проверенный путь установки Termux для телефонов Android.

Быстрая установка:

curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash

Подробные инструкции, поддерживаемые дополнительные возможности и текущие ограничения см. в Руководстве по Termux.

Важное предостережение: полная дополнительная версия .[all] в настоящее время недоступна на Android, поскольку дополнительная версия voice зависит от faster-whisperctranslate2, а ctranslate2 не публикует колеса Android. Вместо этого используйте проверенное дополнение .[termux].

Мои данные куда-нибудь отправляются?

Вызовы API передаются только тому поставщику LLM, который вы настроили (например, OpenRouter, ваш локальный экземпляр Ollama). Агент Hermes не собирает телеметрию, данные об использовании или аналитику. Ваши разговоры, память и навыки хранятся локально в ~/.hermes/.

Могу ли я использовать его в автономном режиме/с локальными моделями?

Да. Запустите hermes model, выберите Пользовательская конечная точка и введите URL-адрес вашего сервера:

hermes model
# 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

Или настройте его непосредственно в config.yaml:

model:
  default: qwen3.5:27b
  provider: custom
  base_url: http://localhost:11434/v1

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 программно:

from run_agent import AIAgent

agent = AIAgent(model="anthropic/claude-opus-4.7")
response = agent.chat("Explain quantum computing briefly")

См. Руководство по библиотеке Python для полного использования API.


Устранение неполадок

Проблемы с установкой

hermes: command not found после установки

Причина: Ваша оболочка не перезагрузила обновленный PATH.

Решение:

# Reload your shell profile
source ~/.bashrc    # bash
source ~/.zshrc     # zsh

# Or start a new terminal session

Если это по-прежнему не работает, проверьте место установки:

which hermes
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
sudo apt install python3.12   # Ubuntu/Debian
brew install python@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.

Решение:

curl -LsSf https://astral.sh/uv/install.sh | sh
source ~/.bashrc

Ошибки отказа в разрешении во время установки

Причина: Недостаточно разрешений на запись в каталог установки.

Решение:

# Don't use sudo with the installer — it installs to ~/.local/bin
# If you previously installed with sudo, clean up:
sudo rm /usr/local/bin/hermes
# Then re-run the standard installer
curl -fsSL https://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
hermes model

# 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
hermes config show

# Re-configure your provider
hermes model

# Or set directly
hermes config set OPENROUTER_API_KEY sk-or-v1-xxxxxxxxxxxx

:::предупреждение Убедитесь, что ключ соответствует поставщику. Ключ OpenAI не будет работать с OpenRouter и наоборот. Проверьте ~/.hermes/.env на наличие конфликтующих записей.

Модель недоступна / модель не найдена

Причина: Идентификатор модели неверен или недоступен у вашего провайдера.

Решение:

# List available models for your provider
hermes model

# Set a valid model
hermes config set HERMES_MODEL anthropic/claude-opus-4.7

# Or specify per-session
hermes chat --model openrouter/meta-llama/llama-3.1-70b-instruct

Ограничение скорости (429 ошибок)

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

Решение. Подождите немного и повторите попытку. Для длительного использования учитывайте: - Обновление плана вашего провайдера - Переход на другую модель или поставщика - Использование hermes chat --provider <alternative> для маршрутизации на другой сервер.

Превышена длина контекста

Причина: Разговор стал слишком длинным для контекстного окна модели, или Hermes обнаружил неправильную длину контекста для вашей модели.

Решение:

# Compress the current session
/compress

# Or start a fresh session
hermes chat

# Use a model with a larger context window
hermes chat --model openrouter/google/gemini-3-flash-preview

Если это произойдет при первом длинном разговоре, возможно, у Гермеса неправильная длина контекста для вашей модели. Проверьте, что он обнаружил:

Посмотрите на строку запуска CLI — она показывает длину обнаруженного контекста (например, 📊 Context limit: 128000 tokens). Вы также можете проверить это с помощью /usage во время сеанса.

Чтобы исправить обнаружение контекста, установите его явно:

# In ~/.hermes/config.yaml
model:
  default: your-model-name
  context_length: 131072  # your model's actual context window

Или для пользовательских конечных точек добавьте их для каждой модели:

custom_providers:
  - name: "My Server"
    base_url: "http://localhost:11434/v1"
    models:
      qwen3.5:27b:
        context_length: 32768

См. Определение длины контекста, чтобы узнать, как работает автоматическое определение, и обо всех параметрах переопределения.


Проблемы с терминалом

Команда заблокирована как опасная

Причина: Hermes обнаружил потенциально разрушительную команду (например, rm -rf, DROP TABLE). Это функция безопасности.

Решение. При появлении запроса просмотрите команду и введите y, чтобы одобрить ее. Вы также можете: - Попросите агента использовать более безопасную альтернативу. - Полный список опасных шаблонов смотрите в Документации по безопасности.

:::совет Это работает так, как задумано: Гермес никогда молча не запускает деструктивные команды. В запросе на утверждение показано, что именно будет выполнено.

sudo не работает через шлюз обмена сообщениями

Причина: Шлюз обмена сообщениями работает без интерактивного терминала, поэтому sudo не может запросить пароль.

Решение: - Избегайте sudo в сообщениях — попросите агента найти альтернативы. - Если вам необходимо использовать sudo, настройте sudo без пароля для определенных команд в /etc/sudoers. - Или переключитесь на интерфейс терминала для задач администрирования: hermes chat

Серверная часть Docker не подключается

Причина: Демон Docker не запущен или у пользователя отсутствуют разрешения.

Решение:

# Check Docker is running
docker info

# Add your user to the docker group
sudo usermod -aG docker $USER
newgrp docker

# Verify
docker run hello-world

Проблемы с сообщениями

Бот не отвечает на сообщения

Причина: Бот не запущен, не авторизован или вашего пользователя нет в белом списке.

Решение:

# Check if the gateway is running
hermes gateway status

# Start the gateway
hermes gateway start

# 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, претендует на эксклюзивный доступ
Открыто Взаимодействовать может любой желающий (не рекомендуется для производства)

Настройте ~/.hermes/config.yaml в настройках вашего шлюза. См. Документацию по сообщениям.

Шлюз не запускается

Причина: отсутствуют зависимости, конфликты портов или неправильно настроенные токены.

Решение:

# Install messaging dependencies
pip install "hermes-agent[telegram]"   # or [discord], [slack], [whatsapp]

# Check for port conflicts
lsof -i :8080

# Verify configuration
hermes config show

WSL: шлюз продолжает отключаться или происходит сбой hermes gateway start

Причина: Поддержка systemd в WSL ненадежна. Во многих установках WSL2 systemd не включен, и даже если он включен, службы могут не пережить перезапуск WSL или завершение работы Windows в режиме ожидания.

Решение. Используйте режим переднего плана вместо службы systemd:

# Option 1: Direct foreground (simplest)
hermes gateway run

# Option 2: Persistent via tmux (survives terminal close)
tmux new -s hermes 'hermes gateway run'
# Reattach later: tmux attach -t hermes

# Option 3: Background via nohup
nohup hermes gateway run > ~/.hermes/logs/gateway.log 2>&1 &

Если вы все равно хотите попробовать systemd, убедитесь, что он включен:

  1. Откройте /etc/wsl.conf (создайте его, если он не существует)
  2. Добавьте: ini [boot] systemd=true
  3. Из PowerShell: wsl --shutdown.
  4. Снова откройте терминал WSL.
  5. Проверьте: 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:

hermes gateway install    # Re-snapshots your current PATH
hermes gateway start      # Detects the updated plist and reloads

Вы можете убедиться, что plist имеет правильный PATH:

/usr/libexec/PlistBuddy -c "Print :EnvironmentVariables:PATH" \
  ~/Library/LaunchAgents/ai.hermes.gateway.plist

Проблемы с производительностью

Медленные ответы

Причина: Большая модель, удаленный сервер 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
hermes chat

# Resume a specific session later if needed
hermes chat --continue

Проблемы с MCP

Сервер MCP не подключается

Причина: Двоичный файл сервера не найден, неверный путь к команде или отсутствует среда выполнения.

Решение:

# Ensure MCP dependencies are installed (already included in standard install)
cd ~/.hermes/hermes-agent && uv pip install -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

Проверьте конфигурацию ~/.hermes/config.yaml MCP:

mcp_servers:
  filesystem:
    command: "npx"
    args: ["-y", "@modelcontextprotocol/server-filesystem", "/home/user/docs"]

Инструменты не отображаются с сервера MCP

Причина: Сервер запущен, но обнаружение инструментов не выполнено, инструменты были отфильтрованы конфигурацией или сервер не поддерживает ожидаемые возможности MCP.

Решение: - Проверьте журналы шлюза/агента на наличие ошибок подключения MCP. - Убедитесь, что сервер отвечает на метод tools/list RPC. - Проверьте любые настройки tools.include, tools.exclude, tools.resources, tools.prompts или enabled на этом сервере. - Помните, что утилиты ресурсов/подсказок регистрируются только тогда, когда сеанс действительно поддерживает эти возможности. - Используйте /reload-mcp после изменения конфигурации.

# Verify MCP servers are configured
hermes config show | grep -A 12 mcp_servers

# Restart Hermes or reload MCP after config changes
hermes chat

См. также: - MCP (Протокол контекста модели) - Использовать MCP с Hermes - Справочник по конфигурации MCP

Ошибки тайм-аута MCP

Причина: Сервер 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 model
  provider: "openrouter"                    # provider for subagents

Теперь, когда вы говорите Hermes: «Напишите мне в Твиттере об X», и он порождает субагент delegate_task, этот субагент работает на Gemini вместо вашей основной модели. Ваш основной разговор остается в формате GPT-5.4.

Вы также можете явно указать в своем приглашении: * «Делегируйте задачу по написанию сообщений в социальных сетях о запуске нашего продукта. Используйте субагента для фактического написания». * Агент будет использовать delegate_task, который автоматически подберет конфигурацию делегирования.

Для одноразового переключения модели без делегирования используйте /model в CLI:

/model google/gemini-3-flash-preview    # switch for this session
# ... write your content ...
/model openai/gpt-5.4                   # switch back

Дополнительную информацию о том, как работает делегирование, см. в разделе Делегирование субагента.

Запуск нескольких агентов на одном номере WhatsApp (привязка для каждого чата)

Сценарий. В OpenClaw у вас было несколько независимых агентов, привязанных к определенным чатам WhatsApp: один для группы семейного списка покупок, другой для вашего частного чата. Сможет ли Гермес сделать это?

Текущее ограничение: Для каждого профиля Hermes требуется собственный номер/сеанс WhatsApp. Вы не можете привязать несколько профилей к разным чатам на один и тот же номер WhatsApp — мост WhatsApp (Baileys) использует один сеанс с аутентификацией на каждый номер.

Обходной путь:

  1. Используйте один профиль с переключением личности. Создайте разные файлы контекста AGENTS.md или используйте команду /personality, чтобы изменить поведение каждого чата. Агент видит, в каком чате он находится, и может адаптироваться.

  2. Используйте задания cron для специализированных задач. Для отслеживания списка покупок настройте задание cron, которое будет отслеживать определенный чат и управлять списком — отдельный агент не требуется.

  3. Используйте отдельные номера. Если вам нужны по-настоящему независимые агенты, свяжите каждый профиль с собственным номером WhatsApp. Для этого подойдут виртуальные номера из таких сервисов, как Google Voice.

  4. Вместо этого используйте Telegram или Discord. Эти платформы более естественно поддерживают привязку каждого чата — каждая группа Telegram или канал Discord получает свой собственный сеанс, и вы можете запускать несколько токенов бота (по одному на каждый профиль) в одной учетной записи.

Дополнительные сведения см. в Профили и Настройка WhatsApp.

Управление тем, что отображается в Telegram (скрытие журналов и рассуждений)

Сценарий. В Telegram вместо окончательных результатов вы видите журналы выполнения шлюза, рассуждения Hermes и сведения о вызовах инструментов.

Решение: Параметр display.tool_progress в config.yaml определяет, насколько часто отображается активность инструмента:

display:
  tool_progress: "off"   # options: 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 skills
  platform_disabled:
    telegram: [skill-a, skill-b]  # disabled only on telegram

После изменения перезапустите шлюз (hermes gateway restart или завершите работу и перезапустите). Командное меню Telegram-бота перестраивается при запуске.

:::совет Навыки с очень длинными описаниями в меню Telegram сокращаются до 40 символов, чтобы не выходить за пределы размера полезной нагрузки. Если навыки не отображаются, возможно, проблема связана с общим размером полезной нагрузки, а не с ограничением количества команд в 100 — отключение неиспользуемых навыков помогает в обоих случаях.

Сеансы общих потоков (несколько пользователей, один разговор)

Сценарий. У вас есть ветка Telegram или Discord, в которой несколько человек упоминают бота. Вы хотите, чтобы все упоминания в этой теме были частью одного общего разговора, а не отдельных сеансов для каждого пользователя.

Текущее поведение: Hermes создает сеансы с ключом по идентификатору пользователя на большинстве платформ, поэтому каждый человек получает свой собственный контекст разговора. Это сделано для обеспечения конфиденциальности и изоляции контекста.

Обходной путь:

  1. Используйте Slack. Сеансы Slack кодируются потоком, а не пользователем. Несколько пользователей в одной теме ведут один разговор — именно то поведение, которое вы описываете. Это наиболее естественный вариант.

  2. Используйте групповой чат с одним пользователем. Если один человек является назначенным «оператором», который передает вопросы, сеанс остается единым. Другие могут читать вместе.

  3. Используйте канал Discord. Сеансы Discord привязаны к каналу, поэтому все пользователи в одном канале имеют общий контекст. Используйте выделенный канал для общего разговора.

Экспорт Гермеса на другой компьютер

Сценарий: Вы накопили навыки, задания cron и память на одном компьютере и хотите перенести все на новый выделенный компьютер с Linux.

Решение:

  1. Установите агент Hermes на новый компьютер: bash curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash

  2. На исходном компьютере создайте полную резервную копию: bash hermes backup При этом создается архив всего вашего каталога ~/.hermes/ — конфигурации, ключей API, воспоминаний, навыков, сеансов и профилей — сохраненного в вашем домашнем каталоге как ~/hermes-backup-<timestamp>.zip.

  3. Скопируйте zip-архив на новый компьютер и импортируйте его: ```bash # On the source machine scp ~/hermes-backup-.zip newmachine:~/

# On the new machine hermes import ~/hermes-backup-.zip ```

  1. На новом компьютере запустите hermes setup, чтобы убедиться, что ключи API и конфигурация поставщика работают.

Перенос одного профиля на другой компьютер

Сценарий: вы хотите переместить или предоставить общий доступ к одному конкретному профилю, а не к полной установке.

# On the source machine
hermes profile export work ./work-backup.tar.gz

# Copy the file to the target machine, then:
hermes profile import ./work-backup.tar.gz work

Импортированный профиль будет содержать все конфигурации, воспоминания, сеансы и навыки из экспорта. Возможно, вам придется обновить пути или повторно пройти аутентификацию у поставщиков, если на новом компьютере установлены другие настройки.

hermes backup против hermes profile export

Особенность hermes backup hermes profile export
Случай использования Полная миграция машины Портирование/совместное использование определенного профиля
Объем Глобальный (весь каталог ~/.hermes) Локальный (единый каталог профилей)
Включает Все профили, глобальная конфигурация, ключи API, сеансы Единый профиль: SOUL.md, воспоминания, сессии, навыки
Учетные данные Включено (.env и auth.json) Исключено (удалено для безопасного обмена)
Формат .zip .tar.gz

Резервный вариант вручную (rsync): Если вы предпочитаете копировать файлы напрямую, исключите репозиторий кода:

rsync -av --exclude='hermes-agent' ~/.hermes/ newmachine:~/.hermes/

:::совет 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)
chmod 644 ~/.zshrc

# Then reload
source ~/.zshrc

# Or just open a new terminal window — it picks up PATH changes automatically

Если установщик добавил строку PATH, но разрешения неверны, вы можете добавить ее вручную:

echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc

Ошибка 400 при первом запуске агента

Сценарий: Установка завершается нормально, но первая попытка общения завершается с ошибкой HTTP 400.

Причина: Обычно имя модели не совпадает — настроенная модель не существует у вашего провайдера или у ключа API нет к ней доступа.

Решение:

# Check what model and provider are configured
hermes config show | head -20

# Re-run model selection
hermes model

# Or test with a known-good model
hermes chat -q "hello" --model anthropic/claude-opus-4.7

Если вы используете OpenRouter, убедитесь, что в вашем ключе API есть кредиты. Значение 400 от OpenRouter часто означает, что для модели требуется платный план или в идентификаторе модели допущена опечатка.


Все еще застрял?

Если ваша проблема не описана здесь:

  1. Искать существующие проблемы: Проблемы GitHub
  2. Спросите сообщество: Nous Research Discord
  3. Отправьте отчет об ошибке: укажите свою ОС, версию Python (python3 --version), версию Hermes (hermes --version) и полное сообщение об ошибке.