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 и добавьте провайдера. Пример показывает раздел модели и её выбор по умолчанию. Если конфигурация уже содержит другие параметры, объедините разделы вручную: не заменяйте весь файл этим фрагментом.
{
"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. Если переименуете провайдера в своей конфигурации, обновите и ссылку выбора.
В baseUrl не добавляют /chat/completions: клиент собирает маршрут сам. Название адаптера openai-completions относится к настройке OpenClaw для Chat Completions. Оно не означает, что нужно обращаться к устаревшему пути /v1/completions, который Relay не поддерживает.
Поля клиента меняются. При расхождении с вашей версией сверьте схему с её руководством и страницей интеграции, вместо добавления неподтверждённых настроек совместимости.
Как проверить ключ отдельно от OpenClaw
Этот запрос помогает понять, связана ли ошибка с клиентом. Он проверяет сведения о ключе, без запуска генерации модели.
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 не заменяют фактическую сумму списания.