Zum Hauptinhalt springen
Cerebras stellt schnelle OpenAI-kompatible Inferenz auf spezieller Inferenzhardware bereit. Das Cerebras-Provider-Plugin enthält einen statischen Katalog mit vier Modellen.
EigenschaftWert
Provider-IDcerebras
Pluginoffizielles externes Paket
Auth-Env-VarCEREBRAS_API_KEY
Onboarding-Flag--auth-choice cerebras-api-key
Direktes CLI-Flag--cerebras-api-key <key>
APIOpenAI-kompatibel (openai-completions)
Basis-URLhttps://api.cerebras.ai/v1
Standardmodellcerebras/zai-glm-4.7

​
Plugin installieren

Installieren Sie das offizielle Plugin und starten Sie anschließend den Gateway neu: 
openclaw plugins install @openclaw/cerebras-provider
openclaw gateway restart

​
Erste Schritte

1

API-Schlüssel abrufen

Erstellen Sie einen API-Schlüssel in der Cerebras Cloud Console.
2

Onboarding ausführen

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

Verifizieren, dass Modelle verfügbar sind

openclaw models list --provider cerebras
Die Liste sollte alle vier statischen Modelle enthalten. Wenn CEREBRAS_API_KEY nicht aufgelöst wird, meldet openclaw models status --json die fehlenden Anmeldedaten unter auth.unusableProfiles.

​
Nicht interaktive Einrichtung

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

​
Integrierter Katalog

OpenClaw liefert einen statischen Cerebras-Katalog aus, der den öffentlichen OpenAI-kompatiblen Endpunkt widerspiegelt. Alle vier Modelle verwenden einen 128k-Kontext und 8.192 maximale Ausgabe-Token.
Modell-RefNameReasoningHinweise
cerebras/zai-glm-4.7Z.ai GLM 4.7jaStandardmodell; Vorschau-Reasoning-Modell
cerebras/gpt-oss-120bGPT OSS 120BjaProduktions-Reasoning-Modell
cerebras/qwen-3-235b-a22b-instruct-2507Qwen 3 235B InstructneinVorschau-Modell ohne Reasoning
cerebras/llama3.1-8bLlama 3.1 8BneinProduktionsmodell mit Fokus auf Geschwindigkeit
Cerebras kennzeichnet zai-glm-4.7 und qwen-3-235b-a22b-instruct-2507 als Vorschaumodelle, und llama3.1-8b sowie qwen-3-235b-a22b-instruct-2507 sind zur Einstellung am 27. Mai 2026 dokumentiert. Prüfen Sie die Seite zu unterstützten Modellen von Cerebras, bevor Sie sich für Produktions-Workloads auf diese Modelle verlassen.

​
Manuelle Konfiguration

Mit dem Plugin benötigen Sie normalerweise nur den API-Schlüssel. Verwenden Sie eine explizite models.providers.cerebras-Konfiguration, wenn Sie Modellmetadaten überschreiben oder im Modus mode: "merge" mit dem statischen Katalog arbeiten möchten: 
{
  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" },
        ],
      },
    },
  },
}
Wenn der Gateway als Daemon ausgeführt wird (launchd, systemd, Docker), stellen Sie sicher, dass CEREBRAS_API_KEY für diesen Prozess verfügbar ist, zum Beispiel in ~/.openclaw/.env oder über env.shellEnv. Ein Schlüssel, der nur in einer interaktiven Shell exportiert wurde, hilft einem verwalteten Dienst nicht, sofern die Env nicht separat importiert wird.

​
Verwandte Themen

Modell-Provider

Provider, Modell-Refs und Failover-Verhalten auswählen.

Denkmodi

Reasoning-Aufwandsstufen für die zwei Reasoning-fähigen Cerebras-Modelle.

Konfigurationsreferenz

Agent-Standards und Modellkonfiguration.

Modelle-FAQ

Auth-Profile, Modelle wechseln und Fehler vom Typ „no profile“ beheben.