Cerebras

Cerebras proporciona inferencia de alta velocidad compatible con OpenAI en hardware de inferencia personalizado. El Plugin incluye un catálogo estático de dos modelos (sin descubrimiento en tiempo real).

Propiedad	Valor
Id. del proveedor	`cerebras`
Plugin	paquete externo oficial (`@openclaw/cerebras-provider`)
Variable de entorno de autenticación	`CEREBRAS_API_KEY`
Opción de incorporación	`--auth-choice cerebras-api-key`
Opción directa de la CLI	`--cerebras-api-key <key>`
API	compatible con OpenAI (`openai-completions`)
URL base	`https://api.cerebras.ai/v1`
Modelo predeterminado	`cerebras/zai-glm-4.7`

Instalar el Plugin

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

Primeros pasos

Obtener una clave de API

Cree una clave de API en la consola de Cerebras Cloud.

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

Verificar que los modelos estén disponibles

openclaw models list --provider cerebras

Muestra los dos modelos estáticos. Si CEREBRAS_API_KEY no se resuelve, openclaw models status --json informa de 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

Ambos modelos comparten una ventana de contexto de 128k y un máximo de 8,192 tokens de salida.

Referencia del modelo	Nombre	Razonamiento	Notas
`cerebras/zai-glm-4.7`	Z.ai GLM 4.7	sí	Modelo predeterminado; modelo de razonamiento en vista previa
`cerebras/gpt-oss-120b`	GPT OSS 120B	sí	Modelo de razonamiento para producción

Configuración manual

La mayoría de las configuraciones solo necesitan la clave de API. Use una configuración explícita de models.providers.cerebras para sobrescribir los metadatos del modelo o ejecutar en mode: "merge" con 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 un daemon (launchd, systemd, Docker), asegúrese de que CEREBRAS_API_KEY esté disponible para ese proceso; por ejemplo, en ~/.openclaw/.env o mediante env.shellEnv. Una clave exportada únicamente en un shell interactivo no servirá para un servicio administrado, a menos que el entorno se importe por separado.

Contenido relacionado

Proveedores de modelos

Elección de proveedores, referencias 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 los agentes y configuración de modelos.

Preguntas frecuentes sobre modelos

Perfiles de autenticación, cambio de modelos y resolución de errores de «sin perfil».

Overview

Concepts and configuration

Providers

Instalar el Plugin

Primeros pasos

Configuración no interactiva

Catálogo integrado

Configuración manual

Contenido relacionado

Proveedores de modelos

Modos de pensamiento

Referencia de configuración

Preguntas frecuentes sobre modelos

​Instalar el Plugin

​Primeros pasos

​Configuración no interactiva

​Catálogo integrado

​Configuración manual

​Contenido relacionado

Proveedores de modelos

Modos de pensamiento

Referencia de configuración

Preguntas frecuentes sobre modelos

Instalar el Plugin

Primeros pasos

Configuración no interactiva

Catálogo integrado

Configuración manual

Contenido relacionado