Cerebras

Cerebras 在自定义推理硬件上提供高速的 OpenAI 兼容推理。OpenClaw 包含一个捆绑的 Cerebras 提供商插件，具有静态的四模型目录。

属性	值
提供商 ID	`cerebras`
插件	已捆绑，`enabledByDefault: true`
身份验证环境变量	`CEREBRAS_API_KEY`
新手引导标志	`--auth-choice cerebras-api-key`
直接 CLI 标志	`--cerebras-api-key <key>`
API	OpenAI 兼容 (`openai-completions`)
基础 URL	`https://api.cerebras.ai/v1`
默认模型	`cerebras/zai-glm-4.7`

入门指南

获取 API 密钥
在 Cerebras Cloud Console 中创建 API 密钥。

运行新手引导

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

验证模型可用
Terminal window
```
openclaw models list --provider cerebras
```
该列表应包含所有四个捆绑模型。如果 CEREBRAS_API_KEY 未解析，openclaw models status --json 将在 auth.unusableProfiles 下报告缺少凭据。

非交互式设置

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

内置目录

OpenClaw 附带了一个静态 Cerebras 目录，该目录镜像了公共 OpenAI 兼容端点。所有四个模型共享 128k 上下文和 8,192 最大输出令牌。

模型参考	名称	推理	备注
`cerebras/zai-glm-4.7`	Z.ai GLM 4.7	是	默认模型；预览推理模型
`cerebras/gpt-oss-120b`	GPT OSS 120B	是	生产推理模型
`cerebras/qwen-3-235b-a22b-instruct-2507`	Qwen 3 235B Instruct	否	预览非推理模型
`cerebras/llama3.1-8b`	Llama 3.1 8B	否	注重生产环境速度的模型

手动配置

由于捆绑了插件，通常您只需要 API 密钥。当您想要覆盖模型元数据或针对静态目录在 mode: "merge" 中运行时，请使用显式的 models.providers.cerebras 配置：

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