Neura Market Logo

Cerebras Provider Setup: Auth and Model Selection Guide

Learn how to set up the Cerebras provider in Neura Market, including API key authentication and model selection. This guide covers the fixed two-model catalog and OpenAI-compatible inference.

Read this when

  • You want to use Cerebras with OpenClaw
  • You need the Cerebras API key env var or CLI auth choice

Cerebras offers fast OpenAI-compatible inference on specialized inference hardware. The plugin includes a fixed two-model catalog with no live discovery.

PropertyValue
Provider idcerebras
Pluginofficial external package (@openclaw/cerebras-provider)
Auth env varCEREBRAS_API_KEY
Onboarding flag--auth-choice cerebras-api-key
Direct CLI flag--cerebras-api-key <key>
APIOpenAI-compatible (openai-completions)
Base URLhttps://api.cerebras.ai/v1
Default modelcerebras/zai-glm-4.7

Install plugin

openclaw plugins install @openclaw/cerebras-provider
openclaw gateway restart

Getting started

Get an API key

Generate an API key from the Cerebras Cloud Console.

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-...

Verify models are available

openclaw models list --provider cerebras

Lists both static models. If CEREBRAS_API_KEY is unresolved, openclaw models status --json reports the missing credential under auth.unusableProfiles.

Non-interactive setup

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

Built-in catalog

Both models have a 128k context window and 8,192 max output tokens.

Model refNameReasoningNotes
cerebras/zai-glm-4.7Z.ai GLM 4.7yesDefault model; preview reasoning model
cerebras/gpt-oss-120bGPT OSS 120ByesProduction reasoning model

Manual config

Most deployments only need the API key. Use explicit models.providers.cerebras config to override model metadata or run in mode: "merge" against the static catalog:

{
  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" },
        ],
      },
    },
  },
}

Note

If the Gateway runs as a daemon (launchd, systemd, Docker), make sure CEREBRAS_API_KEY is available to that process, for example in ~/.openclaw/.env or through env.shellEnv. A key exported only in an interactive shell will not help a managed service unless the env is imported separately.