Saltar al contenido principal
Cerebras proporciona inferencia de alta velocidad compatible con OpenAI en hardware de inferencia personalizado. El plugin incluye un catálogo estático de cuatro modelos (sin descubrimiento en vivo).
PropiedadValor
ID de proveedorcerebras
Pluginpaquete externo oficial (@openclaw/cerebras-provider)
Variable env de authCEREBRAS_API_KEY
Marca de incorporación--auth-choice cerebras-api-key
Marca directa de CLI--cerebras-api-key <key>
APIcompatible con OpenAI (openai-completions)
URL basehttps://api.cerebras.ai/v1
Modelo predeterminadocerebras/zai-glm-4.7

​
Instalar plugin

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

​
Primeros pasos

1

Obtener una clave de API

Crea una clave de API en la Cerebras Cloud Console.
2

Ejecutar la incorporación

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

Verificar que los modelos estén disponibles

openclaw models list --provider cerebras
Lista los cuatro modelos estáticos. Si CEREBRAS_API_KEY no se resuelve, openclaw models status --json informa la credencial faltante en auth.unusableProfiles.

​
Configuración no interactiva

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

​
Catálogo integrado

Los cuatro modelos comparten una ventana de contexto de 128k y 8192 tokens de salida máximos.
Ref del modeloNombreRazonamientoNotas
cerebras/zai-glm-4.7Z.ai GLM 4.7síModelo predeterminado; modelo de razonamiento preliminar
cerebras/gpt-oss-120bGPT OSS 120BsíModelo de razonamiento de producción
cerebras/qwen-3-235b-a22b-instruct-2507Qwen 3 235B InstructnoModelo preliminar sin razonamiento
cerebras/llama3.1-8bLlama 3.1 8BnoModelo de producción centrado en velocidad
Cerebras marca zai-glm-4.7 y qwen-3-235b-a22b-instruct-2507 como modelos preliminares, y llama3.1-8b junto con qwen-3-235b-a22b-instruct-2507 están documentados para quedar obsoletos el 27 de mayo de 2026. Consulta la página de modelos compatibles de Cerebras antes de depender de ellos para cargas de trabajo de producción.

​
Configuración manual

La mayoría de las configuraciones solo necesitan la clave de API. Usa la configuración explícita models.providers.cerebras para sobrescribir los metadatos de modelo o ejecutar en mode: "merge" contra el catálogo estático: 
{
  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" },
        ],
      },
    },
  },
}
Si el Gateway se ejecuta como demonio (launchd, systemd, Docker), asegúrate de que CEREBRAS_API_KEY esté disponible para ese proceso, por ejemplo en ~/.openclaw/.env o mediante env.shellEnv. Una clave exportada solo en un shell interactivo no ayudará a un servicio administrado a menos que el entorno se importe por separado.

​
Relacionado

Proveedores de modelos

Elección de proveedores, refs de modelos y comportamiento de conmutación por error.

Modos de pensamiento

Niveles de esfuerzo de razonamiento para los dos modelos de Cerebras con capacidad de razonamiento.

Referencia de configuración

Valores predeterminados de agente y configuración de modelos.

Preguntas frecuentes sobre modelos

Perfiles de auth, cambio de modelos y resolución de errores de “no profile”.