OpenClaw Windows: подключение Relay через WSL2
OpenClaw Windows можно настроить для Relay через WSL2: установите клиент внутри Linux-среды, передайте туда ключ и добавьте OpenAI-совместимого провайдера с адресом https://relay-llm.ru/v1. Затем выберите модель и проверьте короткий ответ без работы с файлами. Ниже этот путь разобран отдельно от установки Windows-компонентов: ключ из PowerShell не появляется внутри службы WSL автоматически.
Как подготовить OpenClaw Windows к работе через WSL2
В руководстве OpenClaw для Windows описаны способы запуска, включая WSL2. Для этой инструкции выберите WSL2 и выполняйте Linux-шаги внутри него. Не смешивайте инструкции для Windows-процесса и Linux-службы: у них разные домашние каталоги, переменные и настройки.
Проверьте установленные дистрибутивы в PowerShell:
wsl --list --verboseЕсли WSL2 ещё нет, пройдите его установку по официальному руководству, затем установите OpenClaw внутри выбранного дистрибутива по инструкции клиента. Требования к Node.js и команды установщика сверяйте с текущим релизом. Relay не устанавливает локальный агент и не выдаёт права на ваш компьютер.
Установка OpenClaw на Windows завершена для этого сценария, когда команда клиента запускается из WSL. Откройте терминал дистрибутива и дальнейшие команды выполняйте там. Настройки Windows-профиля %USERPROFILE% не заменяют файл в домашнем каталоге Linux.
Как создать ключ и передать его процессу
Создайте отдельный ключ в кабинете Relay. Полный секрет показывается один раз. Разрешите нужную текстовую модель и задайте лимит расходов для теста. Все обычные ключи аккаунта тратят общий баланс: отдельный ключ помогает ограничить и отключить приложение, но не создаёт отдельный кошелёк.
В Linux-терминале задайте значение для текущей оболочки. Здесь только демонстрационный ключ:
export RELAY_API_KEY="sk-demo-not-a-real-key"
test -n "$RELAY_API_KEY" && printf 'Ключ задан\n'Для реального секрета используйте свой способ безопасной передачи переменной. Не выводите её значение на экран ради проверки. Команда test проверяет лишь наличие строки, а не действительность ключа. Авторизацию подтвердит запрос к API.
Фоновая служба OpenClaw может не наследовать окружение терминала. Если клиент работает как служба, настройте секрет в её среде по руководству вашей версии. Не пытайтесь исправить 401 только повторным export в другом окне. В инструкции интеграции разобран отдельный случай служебного запуска.
Как добавить провайдера Relay
Внутри WSL откройте ~/.openclaw/openclaw.json. Если файл уже существует, дополните его, а не заменяйте. Пример показывает секцию провайдера и модель по умолчанию; секрет остаётся ссылкой на переменную окружения.
{
"models": {
"providers": {
"relay": {
"baseUrl": "https://relay-llm.ru/v1",
"apiKey": "${RELAY_API_KEY}",
"api": "openai-completions",
"models": [{ "id": "gpt-6-sol", "name": "GPT 6 Sol" }]
}
}
},
"agents": {
"defaults": { "model": { "primary": "relay/gpt-6-sol" } }
}
}Схему собственного провайдера описывает руководство OpenClaw. Если установленный релиз требует другие поля, сверяйтесь с ним. Имя relay в примере локальное: оно связывает запись провайдера и ссылку на модель. Публичный ID gpt-6-sol должен совпадать с каталогом Relay.
В OpenAI-совместимом режиме нужен адрес с /v1. Не приписывайте к baseUrl метод /chat/completions, его добавляет клиент. У Anthropic Messages другое правило адреса; не меняйте протокол, оставляя прежнюю конфигурацию.
Как проверить API до запуска инструментов агента
Из того же WSL-терминала выполните короткий запрос:
curl --fail-with-body --show-error https://relay-llm.ru/v1/chat/completions \
-H "Authorization: Bearer $RELAY_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"gpt-6-sol","messages":[{"role":"user","content":"Ответь словом: готово"}]}'Если API отвечает, запустите OpenClaw с настроенным профилем и отправьте такое же сообщение. Пока не подключайте команды оболочки, браузер и доступ к рабочим каталогам. Так вы проверите именно обмен с моделью. Успешный curl не доказывает, что служба получила тот же ключ или перечитала файл настроек.
После первого ответа откройте журнал запросов Relay и сопоставьте время, модель и расход. Если клиент показывает пустой счётчик токенов, смотрите фактическую запись кабинета; отсутствие счётчика в OpenClaw не означает бесплатный вызов.
Что делать при ошибке
При 401 сравните среду запуска клиента и проверочного запроса. При 404 проверьте составленный путь и ID модели. Если сам OpenClaw не запускается после правки JSON, верните сохранённую копию и проверьте синтаксис конфигурации. Перевыпуск ключа не исправит ошибку файла.
Для инструментальных задач затем добавляйте права по одному. Лимит ключа ограничивает API-расходы, но не запрещает агенту удалить файл или выполнить локальную команду. Первую правку поручите на копии проекта, просмотрите diff и запустите её адресный тест. Параметры ключа описаны на странице API-ключей.
OpenClaw Windows хранит настройки в профиле Windows или WSL?
В этом сценарии клиент работает внутри WSL и читает домашний каталог Linux. Конфигурация Windows-процесса находится отдельно; не переносите между ними путь вслепую.
Как установить OpenClaw на Windows без WSL2?
Проверьте другие способы в руководстве текущей версии OpenClaw. Пример этой статьи рассчитан на WSL2 и не подтверждает одинаковую работу Windows-службы.
Почему curl отвечает, а агент получает 401?
Проверьте окружение процесса OpenClaw и источник секрета. Служба может запускаться без переменной, которую вы задали в терминале.