Providers

Cerebras

Cerebras fornece inferência de alta velocidade compatível com OpenAI em hardware de inferência personalizado. OpenClaw inclui um plugin de provedor Cerebras incluído com um catálogo estático de quatro modelos.

Propriedade Valor
ID do provedor cerebras
Plugin incluído, enabledByDefault: true
Var. de env de auth CEREBRAS_API_KEY
Flag de onboarding --auth-choice cerebras-api-key
Flag direta da CLI --cerebras-api-key <key>
API compatível com OpenAI (openai-completions)
URL base https://api.cerebras.ai/v1
Modelo padrão cerebras/zai-glm-4.7

Primeiros passos

  • Obtenha uma chave de API

    Crie uma chave de API no Cerebras Cloud Console.

  • Execute o onboarding

    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-...
    
  • Verifique se os modelos estão disponíveis

    openclaw models list --provider cerebras
    

    A lista deve incluir todos os quatro modelos incluídos. Se CEREBRAS_API_KEY não for resolvida, openclaw models status --json relata a credencial ausente em auth.unusableProfiles.

  • Configuração não interativa

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

    Catálogo integrado

    OpenClaw vem com um catálogo estático da Cerebras que espelha o endpoint público compatível com OpenAI. Todos os quatro modelos compartilham um contexto de 128k e 8.192 tokens de saída máximos.

    Ref. 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 de produção
    cerebras/qwen-3-235b-a22b-instruct-2507 Qwen 3 235B Instruct não Modelo em prévia sem raciocínio
    cerebras/llama3.1-8b Llama 3.1 8B não Modelo de produção focado em velocidade

    Configuração manual

    O plugin incluído geralmente significa que você só precisa da chave de API. Use a configuração explícita models.providers.cerebras quando quiser substituir metadados de modelo ou executar em mode: "merge" contra o 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" },
            ],
          },
        },
      },
    }
    

    Relacionado