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

Providers

Cerebras

Cerebras fornece inferência de alta velocidade compatível com a OpenAI em hardware de inferência personalizado. O Plugin inclui um catálogo estático de quatro modelos (sem descoberta em tempo real).

Propriedade Valor
ID do provedor cerebras
Plugin pacote externo oficial (@openclaw/cerebras-provider)
Variável de ambiente de autenticação CEREBRAS_API_KEY
Opção de integração inicial --auth-choice cerebras-api-key
Opção direta da CLI --cerebras-api-key <key>
API compatível com a OpenAI (openai-completions)
URL base https://api.cerebras.ai/v1
Modelo padrão cerebras/zai-glm-4.7

Instalar o Plugin

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

Primeiros passos

  • Obter uma chave de API

    Crie uma chave de API no console do Cerebras Cloud.

  • Executar a integração inicial

    Integração inicial
    openclaw onboard --auth-choice cerebras-api-key
    Opção direta
    openclaw onboard --non-interactive \--auth-choice cerebras-api-key \--cerebras-api-key "$CEREBRAS_API_KEY"
    Somente variável de ambiente
    export CEREBRAS_API_KEY=csk-...

  • Verificar se os modelos estão disponíveis

    bash
    openclaw models list --provider cerebras

    Lista todos os quatro modelos estáticos. Se CEREBRAS_API_KEY não puder ser resolvida, openclaw models status --json informará a credencial ausente em auth.unusableProfiles.

    • Configuração não interativa

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

    Catálogo integrado

    Todos os quatro modelos compartilham uma janela de contexto de 128 mil tokens e um limite máximo de saída de 8.192 tokens.

    Referência do modelo Nome Raciocínio Observações
    cerebras/zai-glm-4.7 Z.ai GLM 4.7 sim Modelo padrão; modelo de raciocínio em prévia
    cerebras/gpt-oss-120b GPT OSS 120B sim Modelo de raciocínio para produção
    cerebras/qwen-3-235b-a22b-instruct-2507 Qwen 3 235B Instruct não Modelo sem raciocínio em prévia
    cerebras/llama3.1-8b Llama 3.1 8B não Modelo para produção com foco em velocidade

    Configuração manual

    A maioria das configurações precisa apenas da chave de API. Use uma configuração explícita em models.providers.cerebras para substituir os metadados dos modelos ou executar com mode: "merge" em conjunto com o 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" },        ],      },    },  },}

    Relacionados

    Provedores de modelos

    Escolha de provedores, referências de modelos e comportamento de failover.
    Modos de pensamento

    Níveis de esforço de raciocínio para os dois modelos da Cerebras com capacidade de raciocínio.
    Referência de configuração

    Padrões dos agentes e configuração de modelos.
    Perguntas frequentes sobre modelos

    Perfis de autenticação, troca de modelos e resolução de erros de "nenhum perfil".
    Was this useful?
    On this page

    On this page