OpenClawDocs
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

Providers

Cerebras

Cerebras proporciona inferencia de alta velocidad compatible con OpenAI mediante hardware de inferencia personalizado. El Plugin incluye un catálogo estático de cuatro modelos (sin detección 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

bash
openclaw plugins install @openclaw/cerebras-provideropenclaw gateway restart

Primeros pasos

  • Obtener una clave de API

    Cree una clave de API en Cerebras Cloud Console.

  • Ejecutar la incorporación

    Incorporación
    openclaw onboard --auth-choice cerebras-api-key
    Opción directa
    openclaw onboard --non-interactive \--auth-choice cerebras-api-key \--cerebras-api-key "$CEREBRAS_API_KEY"
    Solo variable de entorno
    export CEREBRAS_API_KEY=csk-...

  • Verificar que los modelos estén disponibles

    bash
    openclaw models list --provider cerebras

    Muestra los cuatro modelos estáticos. Si no se puede resolver CEREBRAS_API_KEY, openclaw models status --json informa de la credencial faltante en auth.unusableProfiles.

    • Configuración no interactiva

    bash
    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 128 000 tokens y un máximo de 8192 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 preliminar
    cerebras/gpt-oss-120b GPT OSS 120B sí Modelo de razonamiento para producción
    cerebras/qwen-3-235b-a22b-instruct-2507 Qwen 3 235B Instruct no Modelo preliminar sin razonamiento
    cerebras/llama3.1-8b Llama 3.1 8B no Modelo para producción centrado en la velocidad

    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 de los modelos o ejecutar mode: "merge" con el catálogo estático:

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

    Temas relacionados

    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".
    Was this useful?
    On this page

    On this page