Skip to main content
SGLang distribuisce modelli open-weight tramite un’API HTTP compatibile con OpenAI. OpenClaw si connette a SGLang utilizzando la famiglia di provider openai-completions, con rilevamento automatico dei modelli disponibili. OpenClaw inoltre rileva automaticamente i modelli disponibili da SGLang quando si aderisce impostando SGLANG_API_KEY. Usa sglang/* in agents.defaults.models per mantenere dinamico il rilevamento quando configuri anche un URL di base SGLang personalizzato. Consulta Rilevamento dei modelli (provider implicito) più avanti.

​
Per iniziare

1

Avvia SGLang

Avvia SGLang con un server compatibile con OpenAI. L’URL di base deve esporre gli endpoint /v1 (ad esempio /v1/models, /v1/chat/completions). SGLang viene comunemente eseguito su:
  • http://127.0.0.1:30000/v1
2

Imposta una chiave API

Qualsiasi valore è valido se sul server non è configurata l’autenticazione:
3

Esegui la configurazione iniziale o imposta direttamente un modello

In alternativa, configura manualmente il modello:

​
Rilevamento dei modelli (provider implicito)

Quando SGLANG_API_KEY è impostata (o esiste un profilo di autenticazione) e non definisci models.providers.sglang, OpenClaw interroga:
  • GET http://127.0.0.1:30000/v1/models
e converte gli ID restituiti in voci di modello.
Se imposti esplicitamente models.providers.sglang, per impostazione predefinita OpenClaw usa i modelli dichiarati. Aggiungi "sglang/*": {} a agents.defaults.models quando vuoi che OpenClaw interroghi l’endpoint /models del provider configurato e includa tutti i modelli SGLang pubblicizzati.

​
Configurazione esplicita (modelli manuali)

Usa una configurazione esplicita quando:
  • SGLang viene eseguito su un host o una porta diversi.
  • Vuoi fissare i valori contextWindow/maxTokens.
  • Il server richiede una chiave API reale (o vuoi controllare le intestazioni).

​
Configurazione avanzata

SGLang viene trattato come un backend /v1 in stile proxy compatibile con OpenAI, non come un endpoint OpenAI nativo.
Server non raggiungibileVerifica che il server sia in esecuzione e risponda:
Errori di autenticazioneSe le richieste non riescono a causa di errori di autenticazione, imposta una SGLANG_API_KEY reale che corrisponda alla configurazione del server oppure configura esplicitamente il provider in models.providers.sglang.
Se esegui SGLang senza autenticazione, qualsiasi valore non vuoto per SGLANG_API_KEY è sufficiente per aderire al rilevamento dei modelli.

​
Argomenti correlati

Selezione del modello

Scelta dei provider, dei riferimenti ai modelli e del comportamento di failover.

Riferimento della configurazione

Schema di configurazione completo, incluse le voci dei provider.