---
read_when:
    - Ви хочете запустити OpenClaw для роботи з локальним сервером SGLang.
    - Вам потрібні OpenAI-сумісні кінцеві точки /v1 з власними моделями
summary: Запустіть OpenClaw із SGLang (самостійно розгорнутим сервером, сумісним з OpenAI)
title: SGLang
x-i18n:
    generated_at: "2026-05-13T05:34:01Z"
    model: gpt-5.5
    provider: openai
    source_hash: bd1a5954e3994e3640ee17c62acedc314716c3ed5e52528da436c36c077ebead
    source_path: providers/sglang.md
    workflow: 16
---

SGLang обслуговує моделі з відкритими вагами через HTTP API, сумісний з OpenAI. OpenClaw підключається до SGLang за допомогою сімейства провайдерів `openai-completions` з автоматичним виявленням доступних моделей.

| Властивість               | Значення                                                     |
| ------------------------- | ------------------------------------------------------------ |
| Ідентифікатор провайдера  | `sglang`                                                     |
| Plugin                    | вбудований, `enabledByDefault: true`                         |
| Змінна середовища автентифікації | `SGLANG_API_KEY` (будь-яке непорожнє значення, якщо сервер не має автентифікації) |
| Прапорець початкового налаштування | `--auth-choice sglang`                                       |
| API                       | сумісний з OpenAI (`openai-completions`)                     |
| Базова URL-адреса за замовчуванням | `http://127.0.0.1:30000/v1`                                  |
| Заповнювач моделі за замовчуванням | `sglang/Qwen/Qwen3-8B`                                       |
| Використання потокової передачі | Так (`supportsStreamingUsage: true`)                         |
| Ціноутворення             | Позначено як зовнішньо безкоштовне (`modelPricing.external: false`) |

OpenClaw також **автоматично виявляє** доступні моделі з SGLang, коли ви вмикаєте це за допомогою `SGLANG_API_KEY`. Використовуйте `sglang/*` у `agents.defaults.models`, щоб зберегти динамічне виявлення, коли ви також налаштовуєте власну базову URL-адресу SGLang. Див. [Виявлення моделей (неявний провайдер)](#model-discovery-implicit-provider) нижче.

## Початок роботи

<Steps>
  <Step title="Запустіть SGLang">
    Запустіть SGLang із сервером, сумісним з OpenAI. Ваша базова URL-адреса має надавати
    кінцеві точки `/v1` (наприклад, `/v1/models`, `/v1/chat/completions`). SGLang
    зазвичай працює на:

    - `http://127.0.0.1:30000/v1`

  </Step>
  <Step title="Установіть API-ключ">
    Підійде будь-яке значення, якщо на вашому сервері не налаштовано автентифікацію:

    ```bash
    export SGLANG_API_KEY="sglang-local"
    ```

  </Step>
  <Step title="Запустіть початкове налаштування або задайте модель напряму">
    ```bash
    openclaw onboard
    ```

    Або налаштуйте модель вручну:

    ```json5
    {
      agents: {
        defaults: {
          model: { primary: "sglang/your-model-id" },
        },
      },
    }
    ```

  </Step>
</Steps>

## Виявлення моделей (неявний провайдер)

Коли встановлено `SGLANG_API_KEY` (або існує профіль автентифікації), і ви **не**
визначаєте `models.providers.sglang`, OpenClaw виконає запит:

- `GET http://127.0.0.1:30000/v1/models`

і перетворить повернуті ідентифікатори на записи моделей.

<Note>
Якщо ви явно задаєте `models.providers.sglang`, OpenClaw за замовчуванням використовує оголошені
вами моделі. Додайте `"sglang/*": {}` до `agents.defaults.models`, коли
хочете, щоб OpenClaw звертався до кінцевої точки `/models` цього налаштованого провайдера та включав
усі оголошені моделі SGLang.
</Note>

## Явна конфігурація (моделі вручну)

Використовуйте явну конфігурацію, коли:

- SGLang працює на іншому хості або порту.
- Ви хочете закріпити значення `contextWindow`/`maxTokens`.
- Ваш сервер потребує справжнього API-ключа (або ви хочете керувати заголовками).

```json5
{
  models: {
    providers: {
      sglang: {
        baseUrl: "http://127.0.0.1:30000/v1",
        apiKey: "${SGLANG_API_KEY}",
        api: "openai-completions",
        models: [
          {
            id: "your-model-id",
            name: "Local SGLang Model",
            reasoning: false,
            input: ["text"],
            cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 },
            contextWindow: 128000,
            maxTokens: 8192,
          },
        ],
      },
    },
  },
}
```

## Розширена конфігурація

<AccordionGroup>
  <Accordion title="Поведінка в стилі проксі">
    SGLang розглядається як проксі-бекенд `/v1`, сумісний з OpenAI, а не як
    нативна кінцева точка OpenAI.

    | Поведінка | SGLang |
    |----------|--------|
    | Формування запитів лише для OpenAI | Не застосовується |
    | `service_tier`, Responses `store`, підказки кешу промптів | Не надсилаються |
    | Формування корисного навантаження для сумісності reasoning | Не застосовується |
    | Приховані заголовки атрибуції (`originator`, `version`, `User-Agent`) | Не вставляються для власних базових URL-адрес SGLang |

  </Accordion>

  <Accordion title="Усунення несправностей">
    **Сервер недоступний**

    Переконайтеся, що сервер запущений і відповідає:

    ```bash
    curl http://127.0.0.1:30000/v1/models
    ```

    **Помилки автентифікації**

    Якщо запити завершуються помилками автентифікації, установіть справжній `SGLANG_API_KEY`, який відповідає
    конфігурації вашого сервера, або явно налаштуйте провайдера в
    `models.providers.sglang`.

    <Tip>
    Якщо ви запускаєте SGLang без автентифікації, будь-якого непорожнього значення для
    `SGLANG_API_KEY` достатньо, щоб увімкнути виявлення моделей.
    </Tip>

  </Accordion>
</AccordionGroup>

## Пов’язане

<CardGroup cols={2}>
  <Card title="Вибір моделі" href="/uk/concepts/model-providers" icon="layers">
    Вибір провайдерів, посилань на моделі та поведінки перемикання після збою.
  </Card>
  <Card title="Довідник конфігурації" href="/uk/gateway/configuration-reference" icon="gear">
    Повна схема конфігурації, включно із записами провайдерів.
  </Card>
</CardGroup>