Vai al contenuto principale
Cerebras fornisce inferenza ad alta velocità compatibile con OpenAI su hardware di inferenza personalizzato. Il Plugin del provider Cerebras include un catalogo statico di quattro modelli.
ProprietàValore
ID providercerebras
Pluginpacchetto esterno ufficiale
Variabile env authCEREBRAS_API_KEY
Flag di onboarding--auth-choice cerebras-api-key
Flag CLI diretto--cerebras-api-key <key>
APIcompatibile con OpenAI (openai-completions)
URL di basehttps://api.cerebras.ai/v1
Modello predefinitocerebras/zai-glm-4.7

​
Installa il Plugin

Installa il Plugin ufficiale, quindi riavvia Gateway: 
openclaw plugins install @openclaw/cerebras-provider
openclaw gateway restart

​
Per iniziare

1

Get an API key

Crea una chiave API nella Console Cloud di Cerebras.
2

Run onboarding

openclaw onboard --auth-choice cerebras-api-key

openclaw onboard --non-interactive \
  --auth-choice cerebras-api-key \
  --cerebras-api-key "$CEREBRAS_API_KEY"

export CEREBRAS_API_KEY=csk-...
3

Verify models are available

openclaw models list --provider cerebras
L’elenco dovrebbe includere tutti e quattro i modelli statici. Se CEREBRAS_API_KEY non viene risolto, openclaw models status --json segnala la credenziale mancante in auth.unusableProfiles.

​
Configurazione non interattiva

openclaw onboard --non-interactive \
  --mode local \
  --auth-choice cerebras-api-key \
  --cerebras-api-key "$CEREBRAS_API_KEY"

​
Catalogo integrato

OpenClaw include un catalogo statico Cerebras che rispecchia l’endpoint pubblico compatibile con OpenAI. Tutti e quattro i modelli condividono un contesto da 128k e 8.192 token di output massimi.
Riferimento modelloNomeRagionamentoNote
cerebras/zai-glm-4.7Z.ai GLM 4.7sìModello predefinito; modello di ragionamento in anteprima
cerebras/gpt-oss-120bGPT OSS 120BsìModello di ragionamento di produzione
cerebras/qwen-3-235b-a22b-instruct-2507Qwen 3 235B InstructnoModello senza ragionamento in anteprima
cerebras/llama3.1-8bLlama 3.1 8BnoModello di produzione ottimizzato per la velocità
Cerebras contrassegna zai-glm-4.7 e qwen-3-235b-a22b-instruct-2507 come modelli in anteprima, e llama3.1-8b più qwen-3-235b-a22b-instruct-2507 sono documentati per la deprecazione il 27 maggio 2026. Controlla la pagina dei modelli supportati di Cerebras prima di fare affidamento su di essi per carichi di lavoro di produzione.

​
Configurazione manuale

Il Plugin di solito significa che ti serve solo la chiave API. Usa la configurazione esplicita models.providers.cerebras quando vuoi sovrascrivere i metadati del modello o eseguire in mode: "merge" rispetto al catalogo statico: 
{
  env: { CEREBRAS_API_KEY: "csk-..." },
  agents: {
    defaults: {
      model: { primary: "cerebras/zai-glm-4.7" },
    },
  },
  models: {
    mode: "merge",
    providers: {
      cerebras: {
        baseUrl: "https://api.cerebras.ai/v1",
        apiKey: "${CEREBRAS_API_KEY}",
        api: "openai-completions",
        models: [
          { id: "zai-glm-4.7", name: "Z.ai GLM 4.7" },
          { id: "gpt-oss-120b", name: "GPT OSS 120B" },
        ],
      },
    },
  },
}
Se Gateway viene eseguito come daemon (launchd, systemd, Docker), assicurati che CEREBRAS_API_KEY sia disponibile per quel processo, ad esempio in ~/.openclaw/.env o tramite env.shellEnv. Una chiave esportata solo in una shell interattiva non aiuterà un servizio gestito a meno che l’env non venga importato separatamente.

​
Correlati

Model providers

Scelta dei provider, riferimenti modello e comportamento di failover.

Thinking modes

Livelli di impegno di ragionamento per i due modelli Cerebras con capacità di ragionamento.

Configuration reference

Impostazioni predefinite degli agenti e configurazione dei modelli.

Models FAQ

Profili di auth, cambio di modelli e risoluzione degli errori “no profile”.