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

OpenClaw Windows: подключение Relay через WSL2

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:

powershell
wsl --list --verbose

Если WSL2 ещё нет, пройдите его установку по официальному руководству, затем установите OpenClaw внутри выбранного дистрибутива по инструкции клиента. Требования к Node.js и команды установщика сверяйте с текущим релизом. Relay не устанавливает локальный агент и не выдаёт права на ваш компьютер.

Установка OpenClaw на Windows завершена для этого сценария, когда команда клиента запускается из WSL. Откройте терминал дистрибутива и дальнейшие команды выполняйте там. Настройки Windows-профиля %USERPROFILE% не заменяют файл в домашнем каталоге Linux.

Как создать ключ и передать его процессу

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

В Linux-терминале задайте значение для текущей оболочки. Здесь только демонстрационный ключ:

bash
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. Если файл уже существует, дополните его, а не заменяйте. Пример показывает секцию провайдера и модель по умолчанию; секрет остаётся ссылкой на переменную окружения.

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-терминала выполните короткий запрос:

bash
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 и источник секрета. Служба может запускаться без переменной, которую вы задали в терминале.

Создать аккаунт для подключения OpenClaw

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