Pular para o conteúdo 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 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.
PropriedadeValor
ID do provedorcerebras
Pluginincluído, enabledByDefault: true
Var. de env de authCEREBRAS_API_KEY
Flag de onboarding--auth-choice cerebras-api-key
Flag direta 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

Primeiros passos

1

Obtenha uma chave de API

Crie uma chave de API no Cerebras Cloud Console.
2

Execute o onboarding

openclaw onboard --auth-choice cerebras-api-key
3

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 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. Consulte a página de modelos compatíveis da Cerebras antes de depender deles para workloads de produção.

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" },
        ],
      },
    },
  },
}
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 presente apenas em ~/.profile não ajudará um serviço gerenciado, a menos que o env seja importado separadamente.

Relacionado

Provedores de modelos

Escolha de provedores, refs. de modelo e comportamento de failover.

Modos de pensamento

Níveis de esforço de raciocínio para os dois modelos Cerebras com capacidade 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 de “no profile”.