К содержимому
Блог

OpenClaw: как подключить Relay и проверить первого агента

OpenClaw: как подключить Relay и проверить первого агента

OpenClaw запускает агентов, которые используют выбранную модель и доступные клиенту инструменты. Для работы через Relay добавьте собственного провайдера с адресом https://relay-llm.ru/v1, ключом Relay и идентификатором модели. Затем выберите эту модель для агента и начните с короткого текстового ответа. Подробная настройка клиента есть в руководстве OpenClaw; ниже разобран первый запуск и поиск ошибок.

Коротко

  • Провайдер, модель и инструменты агента настраиваются отдельно.

  • Добавление модели в список ещё не означает её выбор по умолчанию.

  • Сначала проверьте ключ вне OpenClaw, затем запускайте задачу без изменения файлов.

Что понадобится для первого запуска OpenClaw

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

В Relay зарегистрируйтесь, подтвердите почту и создайте отдельный ключ для OpenClaw. Сохраните секрет при создании: повторно прочитать его нельзя. Задайте дневной или общий лимит расходов, если хотите ограничить пробный запуск. Все ключи расходуют общий баланс аккаунта.

Выберите модель в каталоге. Для примера используется gpt-5.6-sol с Chat Completions. Не заменяйте идентификатор названием семейства. Если выбираете другую модель, сначала проверьте текстовый ответ, затем отдельно работу инструментов.

Проверьте доступный баланс и условия пополнения на странице цен и в кабинете. Relay оплачивает запросы к модели; он не настраивает права OpenClaw на файлы, команды или учётные записи приложений.

Как добавить провайдера и модель

Передайте ключ через RELAY_API_KEY в окружении процесса, который запускает OpenClaw. Для фоновой службы настройте окружение самой службы: переменная в открытом терминале не обязательно попадёт в другой процесс. Не записывайте рабочий секрет в общий файл конфигурации или Git.

Откройте файл настроек OpenClaw и добавьте провайдера. Пример показывает раздел модели и её выбор по умолчанию. Если конфигурация уже содержит другие параметры, объедините разделы вручную: не заменяйте весь файл этим фрагментом.

json
{
  "models": {
    "providers": {
      "relay": {
        "baseUrl": "https://relay-llm.ru/v1",
        "apiKey": "${RELAY_API_KEY}",
        "api": "openai-completions",
        "models": [{ "id": "gpt-5.6-sol", "name": "gpt-5.6-sol" }]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": { "primary": "relay/gpt-5.6-sol" }
    }
  }
}

relay здесь обозначает имя провайдера внутри клиента. Ссылка relay/gpt-5.6-sol выбирает запись этого провайдера; сам идентификатор модели для Relay остаётся gpt-5.6-sol. Если переименуете провайдера в своей конфигурации, обновите и ссылку выбора.

GPT-5.6 Sol0,24 $ за 1 млн входных токенов

В baseUrl не добавляют /chat/completions: клиент собирает маршрут сам. Название адаптера openai-completions относится к настройке OpenClaw для Chat Completions. Оно не означает, что нужно обращаться к устаревшему пути /v1/completions, который Relay не поддерживает.

Поля клиента меняются. При расхождении с вашей версией сверьте схему с её руководством и страницей интеграции, вместо добавления неподтверждённых настроек совместимости.

Как проверить ключ отдельно от OpenClaw

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

bash
curl -i "https://relay-llm.ru/v1/key" \
  -H "Authorization: Bearer $RELAY_API_KEY"

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

Затем попросите OpenClaw ответить одной фразой, без чтения файлов и внешних действий. Проверьте в истории запросов Relay, что использована нужная модель и нужный ключ. Только после этого добавляйте агенту задачу с инструментом.

Как дать агенту первую проверяемую задачу

Подготовьте отдельную папку с учебным текстом без секретов. Задайте конкретный результат: «Прочитай указанный файл, перечисли три факта из него и ничего не изменяй». Проверьте разрешения клиента отдельно; текст запроса не заменяет запрет записи в настройках инструментов.

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

Сохраняйте результат задачи вместе с временем запуска. Это помогает отличить ошибку ответа от ошибки инструмента: успешный HTTP-запрос к модели не доказывает, что клиент прочитал нужный файл.

Что делать при ошибке подключения

Если отдельный запрос работает, а OpenClaw получает 401, проверьте передачу переменной именно его процессу. При 404 сравните полный маршрут и идентификатор модели. Если клиент не выбрал модель Relay, проверьте ссылку провайдер/модель и локальные настройки конкретного агента.

Если ответ приходит, но действие не выполняется, исследуйте разрешения и журнал самого клиента. Перевыпуск API-ключа не добавит прав на локальные файлы. Для отказов шлюза сохраняйте x-request-id и используйте справочник ошибок.

OpenClaw AI и Relay выполняют одну задачу?

OpenClaw управляет агентом и его инструментами. Relay обслуживает API-запросы к модели по вашему ключу.

Как выбрать другую модель для OpenClaw Agent?

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

Почему модель добавлена, но агент использует прежнюю?

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

Где смотреть стоимость запросов OpenClaw?

В истории запросов Relay по ключу клиента. Показания счётчика внутри OpenClaw не заменяют фактическую сумму списания.

Создать аккаунт

Модели из статьи

Готовы подключиться?Войдите в консоль, пополните баланс и создайте API-ключ.