---
read_when:
    - 你想要讓 OpenClaw 搭配本機 SGLang 伺服器執行
    - 你想要使用自有模型的 OpenAI 相容 `/v1` 端點
summary: 使用 SGLang 執行 OpenClaw（相容 OpenAI 的自架伺服器）
title: SGLang
x-i18n:
    generated_at: "2026-07-11T21:44:27Z"
    model: gpt-5.6
    postprocess_version: locale-links-v1
    provider: openai
    source_hash: 54a7805315a7d65fdd2c7c9b6836aa2faccc88db7802cce0ba8c2d4a1aac9d65
    source_path: providers/sglang.md
    workflow: 16
---

SGLang 透過與 OpenAI 相容的 HTTP API 提供開放權重模型。OpenClaw 使用 `openai-completions` 提供者系列連線至 SGLang，並自動探索可用模型。

| 屬性                      | 值                                                           |
| ------------------------- | ------------------------------------------------------------ |
| 提供者 ID                 | `sglang`                                                     |
| 外掛                      | 內建，`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`）             |

當您透過 `SGLANG_API_KEY` 選擇啟用時，OpenClaw 也會從 SGLang **自動探索**可用模型。如果您同時設定自訂的 SGLang 基礎 URL，請在 `agents.defaults.models` 中使用 `sglang/*`，讓探索維持動態。請參閱下方的[模型探索（隱含提供者）](#model-discovery-implicit-provider)。

## 開始使用

<Steps>
  <Step title="啟動 SGLang">
    啟動具有 OpenAI 相容伺服器的 SGLang。您的基礎 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`

並將傳回的 ID 轉換為模型項目。

<Note>
如果您明確設定 `models.providers.sglang`，OpenClaw 預設會使用您宣告的
模型。若要讓 OpenClaw 查詢該已設定提供者的 `/models` 端點，並納入
所有公告的 SGLang 模型，請在 `agents.defaults.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: "本機 SGLang 模型",
            reasoning: false,
            input: ["text"],
            cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 },
            contextWindow: 128000,
            maxTokens: 8192,
          },
        ],
      },
    },
  },
}
```

## 進階設定

<AccordionGroup>
  <Accordion title="代理式行為">
    SGLang 會被視為代理式、與 OpenAI 相容的 `/v1` 後端，而非
    原生 OpenAI 端點。

    | 行為 | SGLang |
    |----------|--------|
    | 僅限 OpenAI 的請求塑形 | 不套用 |
    | `service_tier`、Responses `store`、提示快取提示 | 不傳送 |
    | 推理相容性承載資料塑形 | 不套用 |
    | 隱藏的來源標頭（`originator`、`version`、`User-Agent`） | 不會注入自訂 SGLang 基礎 URL |

  </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="/zh-TW/concepts/model-providers" icon="layers">
    選擇提供者、模型參照及容錯移轉行為。
  </Card>
  <Card title="設定參考" href="/zh-TW/gateway/configuration-reference" icon="gear">
    完整的設定結構描述，包括提供者項目。
  </Card>
</CardGroup>