Pular para o conteúdo principal
Cerebras fornece inferência de alta velocidade compatível com OpenAI em hardware de inferência personalizado. O plugin de provedor Cerebras inclui um catálogo estático de quatro modelos.
PropriedadeValor
ID do provedorcerebras
Pluginpacote externo oficial
Variável de ambiente de autenticaçãoCEREBRAS_API_KEY
Sinalizador de integração--auth-choice cerebras-api-key
Sinalizador direto da CLI--cerebras-api-key <key>
APIcompatível com OpenAI (openai-completions)
URL basehttps://api.cerebras.ai/v1
Modelo padrãocerebras/zai-glm-4.7

​
Instalar plugin

Instale o plugin oficial e reinicie o Gateway: 
openclaw plugins install @openclaw/cerebras-provider
openclaw gateway restart

​
Primeiros passos

1

Obtenha uma chave de API

Crie uma chave de API no Cerebras Cloud Console.
2

Execute a integração

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

Verifique se os modelos estão disponíveis

openclaw models list --provider cerebras
A lista deve incluir todos os quatro modelos estáticos. Se CEREBRAS_API_KEY não for resolvida, openclaw models status --json relatará 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

O OpenClaw inclui um catálogo Cerebras estático que espelha o endpoint público compatível com OpenAI. Todos os quatro modelos compartilham um contexto de 128k e 8.192 tokens máximos de saída.
Referência do modeloNomeRaciocínioObservações
cerebras/zai-glm-4.7Z.ai GLM 4.7simModelo padrão; modelo de raciocínio em prévia
cerebras/gpt-oss-120bGPT OSS 120BsimModelo de raciocínio de produção
cerebras/qwen-3-235b-a22b-instruct-2507Qwen 3 235B InstructnãoModelo em prévia sem raciocínio
cerebras/llama3.1-8bLlama 3.1 8BnãoModelo de produção focado em velocidade
A Cerebras marca zai-glm-4.7 e qwen-3-235b-a22b-instruct-2507 como modelos em prévia, e llama3.1-8b mais qwen-3-235b-a22b-instruct-2507 estão documentados para descontinuação em 27 de maio de 2026. Verifique a página de modelos compatíveis da Cerebras antes de confiar neles para cargas de trabalho de produção.

​
Configuração manual

O plugin 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" com 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" },
        ],
      },
    },
  },
}
Se o Gateway for executado como daemon (launchd, systemd, Docker), garanta que CEREBRAS_API_KEY esteja disponível para esse processo, por exemplo em ~/.openclaw/.env ou por meio de env.shellEnv. Uma chave exportada apenas em um shell interativo não ajudará um serviço gerenciado, a menos que o ambiente seja importado separadamente.

​
Relacionado

Provedores de modelos

Escolha de provedores, referências de modelo e comportamento de failover.

Modos de pensamento

Níveis de esforço de raciocínio para os dois modelos Cerebras capazes de raciocínio.

Referência de configuração

Padrões de agente e configuração de modelo.

FAQ de modelos

Perfis de autenticação, troca de modelos e resolução de erros “no profile”.