Настройка OpenClaw

Зачем такая схема

OpenClaw позволяет регистрировать дополнительных провайдеров моделей через блок models.providers. Для моделей Claude из LLMsRelay самый чистый путь — подключить LLMsRelay как кастомного anthropic-messages-провайдера.

• OpenClaw считает его полноценным Anthropic-совместимым провайдером.
• Сохраняются system-блоки, tool use, content blocks и reasoning.
• В конфиге используются обычные ссылки на модели: llmsrelay/claude-sonnet-4-6.

Где лежит конфиг

OpenClaw читает один JSON-файл из домашней директории:

~/.openclaw/openclaw.json

Есть команды openclaw config и openclaw configure, но для такого специфичного провайдера быстрее править JSON напрямую — сниппет ниже копируется как есть.

Переменная окружения

Экспортируйте ключ LLMsRelay — конфиг возьмёт его через placeholder:

export LLMSRELAY_API_KEY="YOUR_SK_CS4_KEY"

Так ключ не попадает в openclaw.json и в бэкапы dotfiles.

Минимальный рабочий конфиг

Скопируйте в ~/.openclaw/openclaw.json (формат — JSON5, можно комментарии и trailing-запятые):

{
  env: {
    LLMSRELAY_API_KEY: "YOUR_SK_CS4_KEY",
  },
  agents: {
    defaults: {
      model: { primary: "llmsrelay/claude-sonnet-4-6" },
    },
  },
  models: {
    mode: "merge",
    providers: {
      llmsrelay: {
        baseUrl: "https://api.llmsrelay.com",
        apiKey: "${LLMSRELAY_API_KEY}",
        api: "anthropic-messages",
        models: [
          {
            id: "claude-sonnet-4-6",
            name: "Claude Sonnet 4.6",
            reasoning: true,
            input: ["text", "image"],
            contextWindow: 1000000,
            maxTokens: 64000,
          },
          {
            id: "claude-opus-4-7",
            name: "Claude Opus 4.7",
            reasoning: true,
            input: ["text", "image"],
            contextWindow: 1000000,
            maxTokens: 128000,
          },
          {
            id: "claude-haiku-4-5",
            name: "Claude Haiku 4.5",
            reasoning: true,
            input: ["text", "image"],
            contextWindow: 200000,
            maxTokens: 64000,
          },
        ],
      },
    },
  },
}

Почему baseUrl без /v1

В anthropic-messages-провайдере OpenClaw baseUrl — это корень провайдера. Путь Anthropic Messages OpenClaw добавляет сам.

• ✅ Правильно: https://api.llmsrelay.com
• ❌ Неправильно: https://api.llmsrelay.com/v1

С /v1 путь задвоится и вы получите 404 на каждом запросе.

Проверка

После сохранения конфига выполните по порядку:

openclaw gateway status

openclaw models list

В выводе должны быть llmsrelay/claude-sonnet-4-6, llmsrelay/claude-opus-4-7 и llmsrelay/claude-haiku-4-5.

openclaw models set llmsrelay/claude-sonnet-4-6

openclaw dashboard

Сделайте тестовый запрос — он должен появиться под провайдером llmsrelay.

Расширенно: контекст 1M

Для длинного контекста на Sonnet 4.6 / Opus 4.7 включите флаг по модели:

{
  agents: {
    defaults: {
      models: {
        "llmsrelay/claude-sonnet-4-6": { params: { context1m: true } },
        "llmsrelay/claude-opus-4-7":   { params: { context1m: true } },
      },
    },
  },
}

Важное ограничение: /fast

Типичные ошибки

echo $LLMSRELAY_API_KEY

Связанное

• Обзор SDK и клиентов — OpenClaw это продвинутый клиент с custom-провайдерами, а не простой base_url.
• Настройка API-ключа
• Модели Claude

Настройка на Windows

1. Установка OpenClaw

OpenClaw поставляется как npm-пакет и как самостоятельный бинарь под Windows:

npm install -g openclaw
openclaw --version

Альтернатива — openclaw-windows-x64.exe с GitHub Releases, добавьте в PATH.

2. Путь к конфигу на Windows

OpenClaw читает %USERPROFILE%\.openclaw\openclaw.json (например C:\Users\<you>\.openclaw\openclaw.json):

mkdir $env:USERPROFILE\.openclaw -ErrorAction SilentlyContinue
notepad $env:USERPROFILE\.openclaw\openclaw.json

Вставьте конфиг из раздела «Минимальный рабочий конфиг». Сохраняйте как UTF-8 без BOM.

3. Постоянная переменная LLMSRELAY_API_KEY

setx LLMSRELAY_API_KEY "YOUR_SK_CS4_KEY"

Через GUI: Win+R → sysdm.cpl → Переменные среды → User variables → Новая.

4. Проверка

openclaw gateway status
openclaw models list
openclaw models set llmsrelay/claude-sonnet-4-6

5. WSL

Из WSL используйте Linux-путь ~/.openclaw/openclaw.json и переэкспортируйте переменную в ~/.bashrc:

export LLMSRELAY_API_KEY="YOUR_SK_CS4_KEY"

6. Решение проблем

• «openclaw не распознан» — откройте новую PowerShell или добавьте %APPDATA%\npm в PATH.
• Placeholder ${LLMSRELAY_API_KEY} не подставился — переменная не задана в шелле, откуда запускали openclaw. Используйте setx и откройте новый терминал.
• Ошибка парсинга JSON — Notepad сохранил с BOM. Сохраните как UTF-8 без BOM (VS Code или Notepad++).
• Кавычки в PowerShell — оборачивайте значения двойными кавычками; в cmd.exe правила другие.
• Антивирус блокирует node.exe / openclaw.exe — добавьте в whitelist бинарь и хост api.llmsrelay.com.