Saltar al contenido principal

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 proporciona inferencia de alta velocidad compatible con OpenAI en hardware de inferencia personalizado. OpenClaw incluye un Plugin de proveedor de Cerebras integrado con un catálogo estático de cuatro modelos.
PropiedadValor
ID de proveedorcerebras
Pluginintegrado, enabledByDefault: true
Variable de entorno de autenticaciónCEREBRAS_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

​
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
3

Verificar que los modelos estén disponibles

openclaw models list --provider cerebras
La lista debe incluir los cuatro modelos integrados. 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

OpenClaw incluye un catálogo estático de Cerebras que replica el endpoint público compatible con OpenAI. Los cuatro modelos comparten un contexto de 128k y 8192 tokens de salida máxima.
Referencia del modeloNombreRazonamientoNotas
cerebras/zai-glm-4.7Z.ai GLM 4.7síModelo predeterminado; modelo de razonamiento en vista previa
cerebras/gpt-oss-120bGPT OSS 120BsíModelo de razonamiento de producción
cerebras/qwen-3-235b-a22b-instruct-2507Qwen 3 235B InstructnoModelo sin razonamiento en vista previa
cerebras/llama3.1-8bLlama 3.1 8BnoModelo de producción enfocado en velocidad
Cerebras marca zai-glm-4.7 y qwen-3-235b-a22b-instruct-2507 como modelos en vista previa, y llama3.1-8b junto con qwen-3-235b-a22b-instruct-2507 están documentados para su obsolescencia 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

El Plugin integrado normalmente significa que solo necesitas la clave de API. Usa la configuración explícita de models.providers.cerebras cuando quieras sobrescribir metadatos de modelos 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 daemon (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 que solo esté en ~/.profile no ayudará a un servicio gestionado a menos que el entorno se importe por separado.

​
Relacionado

Proveedores de modelos

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