Providers
SGLang
SGLang sirve modelos de pesos abiertos mediante una API HTTP compatible con OpenAI. OpenClaw se conecta a SGLang mediante 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) |
| Opción 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 del modelo predeterminado | sglang/Qwen/Qwen3-8B |
| Uso de streaming | Sí (supportsStreamingUsage: true) |
| Precios | Marcado como externo y gratuito (modelPricing.external: false) |
OpenClaw también detecta automáticamente los modelos disponibles en SGLang al habilitarlo con SGLANG_API_KEY. Use sglang/* en agents.defaults.models para mantener la detección dinámica cuando también configure una URL base personalizada de SGLang. Consulte Detección de modelos (proveedor implícito) más adelante.
Primeros pasos
Iniciar SGLang
Inicie SGLang con un servidor compatible con OpenAI. La URL base debe exponer
los 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 el servidor:
export SGLANG_API_KEY="sglang-local"Ejecutar la incorporación o establecer un modelo directamente
openclaw onboardTambién puede configurar el modelo manualmente:
{ agents: { defaults: { model: { primary: "sglang/your-model-id" }, }, },}Detección de modelos (proveedor implícito)
Cuando se establece SGLANG_API_KEY (o existe un perfil de autenticación) y no se
define models.providers.sglang, OpenClaw consulta:
GET http://127.0.0.1:30000/v1/models
y convierte los identificadores devueltos en entradas de modelos.
Configuración explícita (modelos manuales)
Use una configuración explícita cuando:
- SGLang se ejecute en otro host o puerto.
- Desee fijar los valores de
contextWindow/maxTokens. - El servidor requiera una clave de API real (o desee controlar los encabezados).
{ 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 tipo proxy
SGLang se trata como un backend /v1 compatible con OpenAI y de tipo proxy, no como un
endpoint nativo de OpenAI.
| Comportamiento | SGLang |
|---|---|
| Adaptación de solicitudes exclusiva de OpenAI | No se aplica |
service_tier, Responses store, indicaciones de caché de prompts |
No se envían |
| Adaptación de la carga útil para compatibilidad con el razonamiento | No se aplica |
Encabezados de atribución ocultos (originator, version, User-Agent) |
No se inyectan en URL base personalizadas de SGLang |
Solución de problemas
No se puede acceder al servidor
Verifique que el servidor esté en ejecución y responda:
curl http://127.0.0.1:30000/v1/modelsErrores de autenticación
Si las solicitudes fallan con errores de autenticación, establezca un valor real para SGLANG_API_KEY que coincida con
la configuración del servidor o configure el proveedor explícitamente en
models.providers.sglang.
