> ## Documentation Index
> Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt
> Use this file to discover all available pages before exploring further.
# SGLang
SGLang sirve modelos de pesos abiertos mediante una API HTTP compatible con OpenAI. OpenClaw se conecta a SGLang usando la familia de proveedores `openai-completions` con detección automática de los modelos disponibles.
| Propiedad | Valor |
| --------------------------------------------- | --------------------------------------------------------------------------------- |
| ID de proveedor | `sglang` |
| Plugin | incluido, `enabledByDefault: true` |
| Variable de entorno de autenticación | `SGLANG_API_KEY` (cualquier valor no vacío si el servidor no tiene autenticación) |
| Marca de incorporación | `--auth-choice sglang` |
| API | compatible con OpenAI (`openai-completions`) |
| URL base predeterminada | `http://127.0.0.1:30000/v1` |
| Marcador de posición de modelo predeterminado | `sglang/Qwen/Qwen3-8B` |
| Uso en streaming | Sí (`supportsStreamingUsage: true`) |
| Precios | Marcado como externo gratuito (`modelPricing.external: false`) |
OpenClaw también **detecta automáticamente** los modelos disponibles de SGLang cuando aceptas usar `SGLANG_API_KEY`. Usa `sglang/*` en `agents.defaults.models` para mantener la detección dinámica cuando también configures una URL base personalizada de SGLang. Consulta [Detección de modelos (proveedor implícito)](#model-discovery-implicit-provider) más abajo.
## Primeros pasos
Inicia SGLang con un servidor compatible con OpenAI. Tu URL base debe exponer
endpoints `/v1` (por ejemplo, `/v1/models`, `/v1/chat/completions`). SGLang
suele ejecutarse en:
* `http://127.0.0.1:30000/v1`
Cualquier valor funciona si no hay autenticación configurada en tu servidor:
```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
export SGLANG_API_KEY="sglang-local"
```
```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw onboard
```
O configura el modelo manualmente:
```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
agents: {
defaults: {
model: { primary: "sglang/your-model-id" },
},
},
}
```
## Detección de modelos (proveedor implícito)
Cuando `SGLANG_API_KEY` está definido (o existe un perfil de autenticación) y **no**
defines `models.providers.sglang`, OpenClaw consulta:
* `GET http://127.0.0.1:30000/v1/models`
y convierte los ID devueltos en entradas de modelo.
Si defines `models.providers.sglang` explícitamente, OpenClaw usa tus modelos
declarados de forma predeterminada. Agrega `"sglang/*": {}` a `agents.defaults.models`
cuando quieras que OpenClaw consulte el endpoint `/models` de ese proveedor configurado
e incluya todos los modelos SGLang anunciados.
## Configuración explícita (modelos manuales)
Usa configuración explícita cuando:
* SGLang se ejecuta en otro host/puerto.
* Quieres fijar valores de `contextWindow`/`maxTokens`.
* Tu servidor requiere una clave de API real (o quieres controlar los encabezados).
```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
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,
},
],
},
},
},
}
```
## Configuración avanzada
SGLang se trata como un backend `/v1` compatible con OpenAI de estilo proxy, no como
un endpoint nativo de OpenAI.
| Comportamiento | SGLang |
| ------------------------------------------------------------------------- | --------------------------------------------------- |
| Formato de solicitud solo para OpenAI | No se aplica |
| `service_tier`, `store` de Responses, sugerencias de caché de prompts | No se envían |
| Formato de payload compatible con razonamiento | No se aplica |
| Encabezados de atribución ocultos (`originator`, `version`, `User-Agent`) | No se inyectan en URL base personalizadas de SGLang |
**No se puede acceder al servidor**
Verifica que el servidor esté en ejecución y responda:
```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
curl http://127.0.0.1:30000/v1/models
```
**Errores de autenticación**
Si las solicitudes fallan con errores de autenticación, define una `SGLANG_API_KEY` real que coincida
con la configuración de tu servidor, o configura el proveedor explícitamente en
`models.providers.sglang`.
Si ejecutas SGLang sin autenticación, cualquier valor no vacío para
`SGLANG_API_KEY` es suficiente para aceptar la detección de modelos.
## Relacionado
Elegir proveedores, referencias de modelo y comportamiento de conmutación por error.
Esquema de configuración completo, incluidas las entradas de proveedores.