> ## Documentation Index
> Fetch the complete documentation index at: https://docs.llmeasy.ru/llms.txt
> Use this file to discover all available pages before exploring further.

# Настройка кастомной модели Hermes Agent через LLMEasy

> Подключите LLMEasy к Hermes Agent через модели группы GPT и OpenAI-compatible протокол.

Hermes Agent — это AI-agent для локальных terminal workflows. Его можно использовать как помощника для разработки, а также комбинировать skills, MCP, scheduled tasks и subagents для более длинных автоматизированных задач.

При подключении LLMEasy используйте API Key из группы **GPT** и OpenAI-compatible endpoint.

<Info>
  Эта страница описывает только подключение Hermes Agent через группу GPT. ID модели копируйте из <a href={"https://www.llmeasy.ru/pricing"}>model plaza</a>.
</Info>

## Требования

* API Key LLMEasy (<a href={"https://www.llmeasy.ru/register"}>зарегистрироваться</a>)
* API Key относится к группе **GPT**
* ID модели группы GPT из <a href={"https://www.llmeasy.ru/pricing"}>model plaza</a>
* macOS, Linux или Windows WSL2

## Установка Hermes Agent

<Tabs>
  <Tab title="macOS / Linux / WSL2">
    ```bash theme={null}
    curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
    ```
  </Tab>

  <Tab title="Windows">
    На Windows сначала используйте WSL2. Native PowerShell support зависит от текущей версии Hermes Agent. Если вы используете native Windows, следуйте подсказкам установщика вашей версии.
  </Tab>
</Tabs>

## Настройка

<Tabs>
  <Tab title="Интерактивная настройка">
    <Steps>
      <Step title="Запустите выбор модели">
        ```bash theme={null}
        hermes model
        ```
      </Step>

      <Step title="Выберите OpenAI или OpenAI Compatible provider">
        Выберите **OpenAI** или **OpenAI Compatible** в списке providers.
      </Step>

      <Step title="Заполните конфигурацию LLMEasy">
        Введите:

        * **Base URL**: `https://www.llmeasy.ru/v1`
        * **API Key**: ваш API Key LLMEasy
        * **Model**: ID модели группы **GPT** из <a href={"https://www.llmeasy.ru/pricing"}>model plaza</a>
      </Step>

      <Step title="Перезапустите Hermes Agent">
        После обновления конфигурации завершите текущую сессию Hermes Agent и запустите ее снова.
      </Step>

      <Step title="Запустите Hermes Agent">
        ```bash theme={null}
        hermes
        ```
      </Step>
    </Steps>
  </Tab>

  <Tab title="CLI config">
    Если вам удобнее копировать команды, запишите конфигурацию Hermes Agent напрямую.

    ```bash theme={null}
    hermes config set llm.provider openai
    hermes config set llm.base_url "https://www.llmeasy.ru/v1"
    hermes config set llm.api_key "YOUR_LLMEASY_API_KEY"
    hermes config set llm.model "YOUR_GPT_MODEL_ID"
    ```

    Замените `YOUR_LLMEASY_API_KEY` на ваш API Key LLMEasy, а `YOUR_GPT_MODEL_ID` — на ID модели группы GPT из <a href={"https://www.llmeasy.ru/pricing"}>model plaza</a>.

    Затем запустите Hermes Agent:

    ```bash theme={null}
    hermes
    ```
  </Tab>

  <Tab title="Environment variables">
    Если вы не хотите сохранять API Key в конфигурации Hermes Agent, экспортируйте его в текущем shell.

    ```bash theme={null}
    export OPENAI_API_BASE="https://www.llmeasy.ru/v1"
    export OPENAI_API_KEY="YOUR_LLMEASY_API_KEY"
    export HERMES_MODEL="YOUR_GPT_MODEL_ID"
    hermes
    ```

    Эти переменные действуют только в текущей shell-сессии. В новом терминале экспортируйте их снова или добавьте в свой shell profile.
  </Tab>
</Tabs>

## Кратко о возможностях

| Возможность     | Для чего нужна                                             |
| --------------- | ---------------------------------------------------------- |
| Terminal UI     | Общение с agent прямо в терминале                          |
| Skills          | Сохранение повторяемых workflows                           |
| MCP             | Подключение локальных или удаленных инструментов           |
| Scheduled tasks | Запуск задач по расписанию и recurring workflows           |
| Subagents       | Разделение сложной работы между специализированными agents |
| Message gateway | Подключение agent к дополнительным message entry points    |

## Миграция с OpenClaw

Если вы уже используете OpenClaw, сначала проверьте, есть ли в вашей текущей версии Hermes Agent команда миграции. Перед изменениями запустите dry run.

```bash theme={null}
hermes claw migrate --dry-run
```

После проверки результата выполните миграцию:

```bash theme={null}
hermes claw migrate
```

После миграции все равно проверьте **Base URL**, API Key и model ID в Hermes Agent. Они должны соответствовать `https://www.llmeasy.ru/v1`, вашему API Key LLMEasy и ID модели группы GPT.

## Troubleshooting

* Если запросы не отвечают или завершаются ошибкой, проверьте, что **Base URL** равен `https://www.llmeasy.ru/v1`. Обычно здесь не нужно добавлять `/chat/completions`.
* Если Hermes сообщает, что модель не существует, проверьте, что **Model** — это ID модели группы GPT из <a href={"https://www.llmeasy.ru/pricing"}>model plaza</a>.
* Если возникает ошибка авторизации, проверьте лишние пробелы в API Key и убедитесь, что ключ относится к группе **GPT**.
* Если после изменения настроек Hermes все еще использует старую модель, завершите текущую сессию Hermes Agent и снова выполните `hermes`.
* LLMEasy обычно не требует дополнительного `User-Agent` или custom headers. Добавляйте headers только если этого явно требует ваш custom gateway, tenant routing, observability или caching layer.

<Note>
  Не коммитьте реальные API Keys в репозиторий. Для командных конфигураций используйте environment variables или локальную конфигурацию.
</Note>

## Связанные FAQ

* [MCP и API Key / Base URL](/faq/concepts/mcp-vs-api-key-base-url)
* [Что такое model\_provider, base\_url и wire\_api?](/faq/codex/model-provider-base-url-wire-api)
* [Как настроить OpenAI-compatible API в Cline](/faq/cline/openai-compatible-api)
* [Настройка OpenClaw с LLMEasy](/ai-tools/openclaw)