Vai al contenuto principale

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.

Cerebras offre inferenza ad alta velocità compatibile con OpenAI su hardware di inferenza personalizzato. OpenClaw include un Plugin provider Cerebras integrato con un catalogo statico di quattro modelli.
ProprietàValore
ID providercerebras
Pluginintegrato, enabledByDefault: true
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

​
Per iniziare

1

Ottieni una chiave API

Crea una chiave API nella Cerebras Cloud Console.
2

Esegui l’onboarding

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

Verifica che i modelli siano disponibili

openclaw models list --provider cerebras
L’elenco dovrebbe includere tutti e quattro i modelli integrati. 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 Cerebras statico che rispecchia l’endpoint pubblico compatibile con OpenAI. Tutti e quattro i modelli condividono un contesto da 128k e 8.192 token di output massimo.
Rif. 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 in anteprima senza ragionamento
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, mentre llama3.1-8b e 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 usarli per carichi di lavoro di produzione.

​
Configurazione manuale

Il Plugin integrato di solito significa che ti serve solo la chiave API. Usa la configurazione esplicita models.providers.cerebras quando vuoi sovrascrivere i metadati dei modelli 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 il Gateway viene eseguito come daemon (launchd, systemd, Docker), assicurati che CEREBRAS_API_KEY sia disponibile per quel processo, per esempio in ~/.openclaw/.env o tramite env.shellEnv. Una chiave presente solo in ~/.profile non aiuterà un servizio gestito, a meno che l’env non venga importato separatamente.

​
Correlati

Provider di modelli

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

Modalità di pensiero

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

Riferimento di configurazione

Valori predefiniti degli agenti e configurazione dei modelli.

FAQ sui modelli

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