title: "Nous Tool Gateway" description: "Route web search, image generation, text-to-speech, and browser automation through your Nous subscription — no extra API keys needed" sidebar_label: "Tool Gateway" sidebar_position: 2 lang: ru

Шлюз инструментов Nous

:::совет Начать работу Tool Gateway включен в платную подписку на Nous Portal. Управление подпиской →

Tool Gateway позволяет платным подписчикам Nous Portal использовать веб-поиск, генерацию изображений, преобразование текста в речь и автоматизацию браузера посредством существующей подписки — нет необходимости подписываться на отдельные ключи API от Firecrawl, FAL, OpenAI или использования браузера.

Что включено

Инструмент	Что он делает	Прямая альтернатива
Интернет-поиск и извлечение	Выполняйте поиск в Интернете и извлекайте содержимое страниц с помощью Firecrawl	`FIRECRAWL_API_KEY`, `EXA_API_KEY`, `PARALLEL_API_KEY`, `TAVILY_API_KEY`
Создание изображений	Генерация изображений с помощью FAL (9 моделей: FLUX 2 Klein/Pro, GPT-Image 1.5/2, Nano Banana Pro, Ideogram V3, Recraft V4 Pro, Qwen, Z-Image Turbo)	`FAL_KEY`
Преобразование текста в речь	Преобразование текста в речь с помощью OpenAI TTS	`VOICE_TOOLS_OPENAI_KEY`, `ELEVENLABS_API_KEY`
Автоматизация браузера	Управляйте облачными браузерами через «Использование браузера»	`BROWSER_USE_API_KEY`, `BROWSERBASE_API_KEY`

Все четыре инструмента оплачиваются по вашей подписке Nous. Вы можете включить любую комбинацию — например, использовать шлюз для создания веб-страниц и изображений, сохраняя при этом свой собственный ключ ElevenLabs для TTS.

Право на участие

Tool Gateway доступен платным подписчикам Nous Portal. У учетных записей бесплатного уровня нет доступа — обновите подписку, чтобы разблокировать ее.

Чтобы проверить свой статус:

hermes status

Найдите раздел Nous Tool Gateway. Он показывает, какие инструменты активны через шлюз, какие используют прямые ключи, а какие не настроены.

Включение инструментального шлюза

Во время настройки модели

Когда вы запускаете hermes model и выбираете Nous Portal в качестве своего провайдера, Hermes автоматически предлагает включить Tool Gateway:

Your Nous subscription includes the Tool Gateway.

  The Tool Gateway gives you access to web search, image generation,
  text-to-speech, and browser automation through your Nous subscription.
  No need to sign up for separate API keys — just pick the tools you want.

  ○ Web search & extract (Firecrawl) — not configured
  ○ Image generation (FAL) — not configured
  ○ Text-to-speech (OpenAI TTS) — not configured
  ○ Browser automation (Browser Use) — not configured

  ● Enable Tool Gateway
  ○ Skip

Выберите Включить Tool Gateway, и все готово.

Если у вас уже есть прямые ключи API для некоторых инструментов, приглашение адаптируется — вы можете включить шлюз для всех инструментов (ваши существующие ключи хранятся в .env, но не используются во время выполнения), включить только для ненастроенных инструментов или полностью пропустить.

Через `hermes tools`

Вы также можете включить шлюз по отдельности с помощью интерактивной конфигурации инструмента:

hermes tools

Выберите категорию инструментов («Интернет», «Браузер», «Генерация изображений» или «TTS»), затем выберите Nous Subscription в качестве поставщика. Это устанавливает use_gateway: true для этого инструмента в вашей конфигурации.

Ручная настройка

Установите флаг use_gateway непосредственно в ~/.hermes/config.yaml:

web:
  backend: firecrawl
  use_gateway: true

image_gen:
  use_gateway: true

tts:
  provider: openai
  use_gateway: true

browser:
  cloud_provider: browser-use
  use_gateway: true

Как это работает

Если для инструмента установлено use_gateway: true, среда выполнения маршрутизирует вызовы API через Nous Tool Gateway вместо использования прямых ключей API:

Веб-инструменты — web_search и web_extract используют конечную точку Firecrawl шлюза.
Генерация изображения — image_generate использует конечную точку FAL шлюза.
TTS — text_to_speech использует конечную точку OpenAI Audio шлюза.
Браузер — browser_navigate и другие инструменты браузера используют конечную точку использования браузера шлюза.

Шлюз аутентифицируется с использованием ваших учетных данных Nous Portal (хранящихся в ~/.hermes/auth.json после hermes model).

Приоритет

Каждый инструмент сначала проверяет use_gateway:

use_gateway: true → маршрутизация через шлюз, даже если в .env существуют прямые ключи API.
use_gateway: false (или отсутствует) → используйте прямые ключи API, если они доступны, возвращайтесь к шлюзу только в том случае, если прямых ключей не существует.

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

Возврат к прямым клавишам

Чтобы прекратить использование шлюза для определенного инструмента:

hermes tools    # Select the tool → choose a direct provider

Или установите use_gateway: false в конфигурации:

web:
  backend: firecrawl
  use_gateway: false  # Now uses FIRECRAWL_API_KEY from .env

Когда вы выбираете поставщика, не являющегося шлюзом, в hermes tools, флаг use_gateway автоматически устанавливается на false, чтобы предотвратить противоречивую конфигурацию.

Проверка статуса

hermes status

В разделе Nous Tool Gateway показано:

◆ Nous Tool Gateway
  Nous Portal   ✓ managed tools available
  Web tools       ✓ active via Nous subscription
  Image gen       ✓ active via Nous subscription
  TTS             ✓ active via Nous subscription
  Browser         ○ active via Browser Use key
  Modal           ○ available via subscription (optional)

Инструменты с пометкой «активно по подписке Nous» маршрутизируются через шлюз. Инструменты со своими ключами показывают, какой провайдер активен.

Дополнительно: автономный шлюз

Для локальных или пользовательских развертываний шлюза вы можете переопределить конечные точки шлюза с помощью переменных среды в ~/.hermes/.env:

TOOL_GATEWAY_DOMAIN=nousresearch.com     # Base domain for gateway routing
TOOL_GATEWAY_SCHEME=https                 # HTTP or HTTPS (default: https)
TOOL_GATEWAY_USER_TOKEN=your-token        # Auth token (normally auto-populated)
FIRECRAWL_GATEWAY_URL=https://...         # Override for the Firecrawl endpoint specifically

Эти переменные окружения всегда видны в конфигурации независимо от статуса подписки — они полезны для пользовательских настроек инфраструктуры.

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

Нужно ли мне удалять существующие ключи API?

Нет. Если установлен use_gateway: true, среда выполнения пропускает прямые ключи API и маршрутизируется через шлюз. Ваши ключи останутся в .env нетронутыми. Если вы позже отключите шлюз, они будут использоваться снова автоматически.

Могу ли я использовать шлюз для одних инструментов и прямые ключи для других?

Да. Флаг use_gateway присваивается каждому инструменту. Вы можете комбинировать и сочетать — например, шлюз для Интернета и создания изображений, ваш собственный ключ ElevenLabs для TTS и Browserbase для автоматизации браузера.

Что делать, если срок действия моей подписки истечет?

Инструменты, направленные через шлюз, перестанут работать до тех пор, пока вы не продлите подписку или не переключитесь на прямые ключи API через hermes tools.

Работает ли шлюз со шлюзом обмена сообщениями?

Да. Tool Gateway маршрутизирует вызовы API инструментов независимо от того, используете ли вы CLI, Telegram, Discord или любую другую платформу обмена сообщениями. Он работает на уровне среды выполнения инструмента, а не на уровне точки входа.

Включен ли модальный режим?

Модальный (бессерверный терминал) доступен в качестве дополнительного дополнения через подписку Nous. Он не включается в приглашении Tool Gateway — настройте его отдельно через hermes setup terminal или config.yaml.