Providers

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 del 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 configuración inicial	`--auth-choice sglang`
API	compatible con OpenAI (`openai-completions`)
URL base predeterminada	`http://127.0.0.1:30000/v1`
Marcador de posición del modelo predeterminado	`sglang/Qwen/Qwen3-8B`
Uso de streaming	Sí (`supportsStreamingUsage: true`)
Precios	Marcado como gratuito externo (`modelPricing.external: false`)

OpenClaw también detecta automáticamente los modelos disponibles de SGLang cuando lo activas con 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) abajo.

Primeros pasos

Iniciar SGLang

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

Establecer una clave de API

Cualquier valor funciona si no hay autenticación configurada en tu servidor:

bash

export SGLANG_API_KEY="sglang-local"

Ejecutar la configuración inicial o establecer un modelo directamente

bash

openclaw onboard

O configura el modelo manualmente:

json5

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

Detección de modelos (proveedor implícito)

Cuando SGLANG_API_KEY está establecido (o existe un perfil de autenticación) y no defines models.providers.sglang, OpenClaw consultará:

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

y convertirá los ID devueltos en entradas de modelo.

Configuración explícita (modelos manuales)

Usa configuración explícita cuando:

SGLang se ejecuta en otro host/puerto.
Quieres fijar los valores de contextWindow/maxTokens.
Tu servidor requiere una clave de API real (o quieres controlar las cabeceras).

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,          },        ],      },    },  },}

Configuración avanzada

Comportamiento de estilo proxy

SGLang se trata como un backend /v1 compatible con OpenAI de estilo proxy, no como un endpoint nativo de OpenAI.

Comportamiento	SGLang
Adaptación de solicitudes solo para OpenAI	No se aplica
`service_tier`, `store` de Responses, indicaciones de caché de prompts	No se envían
Adaptación de payload compatible con razonamiento	No se aplica
Cabeceras de atribución ocultas (`originator`, `version`, `User-Agent`)	No se inyectan en URL base personalizadas de SGLang

Solución de problemas

No se puede acceder al servidor

Verifica que el servidor esté en ejecución y responda:

bash

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

Errores de autenticación

Si las solicitudes fallan con errores de autenticación, establece una SGLANG_API_KEY real que coincida con la configuración de tu servidor, o configura el proveedor explícitamente bajo models.providers.sglang.

Relacionado

Selección de modelos

Elegir proveedores, referencias de modelos y comportamiento de conmutación por error.

Referencia de configuración

Esquema de configuración completo, incluidas las entradas de proveedores.

Was this useful?