Переменные окружения

· 6 мин чтения · admin

Обзор

Все переменные окружения Hermes Agent задаются в файле ~/.hermes/.env. Также их можно установить командой hermes config set VAR value. Ниже приведён полный справочник по категориям.

Провайдеры LLM

Переменные для настройки подключения к языковым моделям:

  • OPENROUTER_API_KEY — API-ключ OpenRouter (рекомендуется для гибкости выбора моделей)
  • OPENROUTER_BASE_URL — переопределение базового URL, совместимого с OpenRouter
  • NOUS_BASE_URL — переопределение базового URL Nous Portal (для разработки и тестирования)
  • NOUS_API_KEY — API-ключ для Nous Portal
  • HERMES_INFERENCE_PROVIDER — имя провайдера для основного вывода (openrouter, nous и др.)
  • HERMES_INFERENCE_MODEL — имя модели (например, nousresearch/hermes-4-405b). Имеет приоритет над config.yaml
  • OPENAI_API_KEY — ключ для OpenAI-совместимых провайдеров
  • ANTHROPIC_API_KEY — ключ для Anthropic (Claude)
  • GOOGLE_API_KEY — ключ для Google Gemini
  • GROQ_API_KEY — ключ для Groq (LLM и STT/Whisper)
  • DEEPSEEK_API_KEY — ключ для DeepSeek
  • XIAOMI_API_KEY — ключ для Xiaomi MiMo
  • KIMI_API_KEY — ключ для Kimi / Moonshot
  • DASHSCOPE_API_KEY — ключ для Alibaba / DashScope
  • GLM_API_KEY — ключ для Z.AI / GLM
  • MINIMAX_API_KEY — ключ для MiniMax (международный)
  • MINIMAX_CN_API_KEY — ключ для MiniMax CN (Китай)
  • KILOCODE_API_KEY — ключ для Kilo Code
  • AI_GATEWAY_API_KEY — ключ для AI Gateway (Vercel)
  • OPENCODE_ZEN_API_KEY — ключ для OpenCode Zen
  • OPENCODE_GO_API_KEY — ключ для OpenCode Go
  • HF_TOKEN — токен для Hugging Face
  • COPILOT_GITHUB_TOKEN — токен для GitHub Copilot (через OAuth device code flow)
  • COPILOT_CLI_PATH — путь к CLI GitHub Copilot для ACP-интеграции
  • HERMES_OPENROUTER_CACHE — включение кеширования ответов OpenRouter (1/true/yes)
  • HERMES_OPENROUTER_CACHE_TTL — время жизни кеша в секундах (1–86400)

API инструментов

  • HERMES_WEB_SEARCH_PROVIDER — провайдер веб-поиска (exa, brave, serper, tavily и др.)
  • EXA_API_KEY — ключ для поискового движка Exa
  • BRAVE_API_KEY — ключ для Brave Search
  • SERPER_API_KEY — ключ для Serper (Google Search)
  • TAVILY_API_KEY — ключ для Tavily
  • HERMES_WEB_EXTRACT_PROVIDER — провайдер извлечения веб-страниц (firecrawl, jina)
  • FIRECRAWL_API_KEY — ключ для Firecrawl
  • JINA_API_KEY — ключ для Jina Reader

Терминал и SSH

  • HERMES_TERMINAL_BACKEND — бэкенд терминала: local, ssh, docker, singularity
  • HERMES_SSH_HOST — хост для SSH-подключения
  • HERMES_SSH_USER — имя пользователя SSH
  • HERMES_SSH_KEY_PATH — путь к SSH-ключу
  • HERMES_DOCKER_IMAGE — Docker-образ для контейнерного бэкенда
  • HERMES_DOCKER_WORKDIR — рабочая директория внутри контейнера
  • HERMES_PERSISTENT_SHELL — включение персистентной оболочки (true/false)

Мессенджеры

Hermes поддерживает множество платформ общения:

  • HERMES_TELEGRAM_BOT_TOKEN — токен Telegram-бота
  • HERMES_DISCORD_BOT_TOKEN — токен Discord-бота
  • HERMES_SLACK_BOT_TOKEN — токен Slack-бота
  • HERMES_SLACK_APP_TOKEN — токен приложения Slack для Socket Mode
  • HERMES_WHATSAPP_PHONE_ID — идентификатор телефона WhatsApp Business
  • HERMES_WHATSAPP_TOKEN — токен доступа WhatsApp
  • HERMES_MATRIX_ACCESS_TOKEN — токен доступа Matrix
  • HERMES_LINE_CHANNEL_ACCESS_TOKEN — токен LINE Messaging API

Поведение агента

  • HERMES_MAX_ITERATIONS — максимальное число итераций вызова инструментов на разговор (по умолчанию: 90)
  • HERMES_YOLO_MODE — установите 1 для отключения подтверждения опасных команд
  • HERMES_API_TIMEOUT — таймаут вызова LLM API в секундах (по умолчанию: 1800)
  • HERMES_STREAM_READ_TIMEOUT — таймаут чтения потока в секундах (по умолчанию: 120)
  • HERMES_AGENT_TIMEOUT — таймаут неактивности агента в шлюзе (по умолчанию: 900 сек)
  • HERMES_QUIET — подавление несущественного вывода (true/false)
  • HERMES_HUMAN_DELAY_MODE — режим имитации набора: off/natural/custom
  • HERMES_EXEC_ASK — включение запросов на подтверждение выполнения в режиме шлюза
  • HERMES_IGNORE_RULES — пропуск автоматической загрузки файлов правил (AGENTS.md, SOUL.md и др.)
  • HERMES_REDACT_SECRETS — управление маскированием секретов в выводе (по умолчанию: true)
  • DELEGATION_MAX_CONCURRENT_CHILDREN — максимум параллельных подагентов (по умолчанию: 3)

Безопасность и приватность

Настройки безопасности, конфиденциальности и управления доступом:

  • security.redact_secrets — маскирование секретов (API-ключи, токены) в выводе инструментов перед передачей в контекст. По умолчанию: false. Установите через hermes config set security.redact_secrets true. Требует перезапуска сессии.
  • privacy.redact_pii — хэширование идентификаторов пользователей и удаление телефонных номеров из контекста сессии в шлюзе. По умолчанию: false. Установите через hermes config set privacy.redact_pii true.
  • approvals.mode — режим подтверждения выполнения опасных команд. Значения: manual (всегда спрашивать, по умолчанию), smart (LLM-оценка рисков), off (пропуск всех подтверждений). Установите через hermes config set approvals.mode smart.

Интерфейс

  • HERMES_TUI — запуск текстового интерфейса (1 вместо классического CLI)
  • HERMES_TUI_THEME — тема TUI: light, dark или hex-код фона
  • HERMES_TUI_RESUME — возобновление сессии TUI по ID

Сессии

  • SESSION_IDLE_MINUTES — сброс сессий после N минут неактивности (по умолчанию: 1440)
  • SESSION_RESET_HOUR — час ежедневного сброса в 24-часовом формате (по умолчанию: 4)

Память

Настройки системы памяти агента (через config.yaml, секция memory):

  • memory.memory_enabled — включение персистентной памяти (true/false)
  • memory.user_profile_enabled — включение профиля пользователя (true/false)
  • memory.provider — провайдер памяти (встроенный, Honcho, Mem0 и др.)
  • memory.memory_char_limit — лимит символов для MEMORY.md (по умолчанию: 2200)
  • memory.user_char_limit — лимит символов для USER.md (по умолчанию: 1375)

Голос и транскрипция

  • VOICE_TOOLS_OPENAI_KEY — ключ OpenAI для STT (Whisper) и TTS

Подробнее о настройке голоса см. в разделе «Голосовой ввод» документации.

Вспомогательные задачи

Переменные для переопределения моделей вспомогательных задач (зрение, извлечение веб-страниц):

  • AUXILIARY_VISION_PROVIDER / AUXILIARY_VISION_MODEL — провайдер и модель для задач зрения
  • AUXILIARY_VISION_BASE_URL / AUXILIARY_VISION_API_KEY — прямой endpoint для зрения
  • AUXILIARY_WEB_EXTRACT_PROVIDER / AUXILIARY_WEB_EXTRACT_MODEL — провайдер и модель для извлечения веб-страниц

Логирование и отладка

  • HERMES_DUMP_REQUESTS — дамп API-запросов в лог-файлы (true/false)
  • HERMES_OAUTH_TRACE — логирование OAuth-обмена токенами (1)
  • HERMES_PLUGINS_DEBUG — подробный лог обнаружения плагинов (1/true)
  • HERMES_DEBUG_INTERRUPT — подробный лог прерываний и отмен (1)

Совет: используйте hermes config set для установки переменных — команда автоматически сохраняет их в нужный файл (.env для секретов, config.yaml для остальных настроек).