Cerebras 提供高速、兼容 OpenAI 的推理服务。在 OpenClaw 中，你只需获取 API 密钥并通过 openclaw onboard 配置即可使用。内置四个模型，其中两个支持推理能力，请注意 zai-glm-4.7 和 qwen-3-235b-a22b-instruct-2507 当前为预览状态，llama3.1-8b 和 qwen-3-235b-a22b-instruct-2507 计划在 2026 年 5 月 27 日废弃。配置后运行 openclaw models list --provider cerebras 验证模型可用性。

OpenClaw 怎么配置 Cerebras 高速推理模型

Cerebras 在专用推理硬件上提供高速、兼容 OpenAI 的推理服务。OpenClaw 内置了 Cerebras provider 插件，自带四个模型的静态目录。

属性	值
Provider id	cerebras
插件	内置，enabledByDefault: true
认证环境变量	CEREBRAS_API_KEY
Onboarding 标记	--auth-choice cerebras-api-key
直接 CLI 标记	--cerebras-api-key <key>
API	兼容 OpenAI（openai-completions）
Base URL	https://api.cerebras.ai/v1
默认模型	cerebras/zai-glm-4.7

开始配置

获取 API 密钥

在 [Cerebras Cloud Console](https://cloud.cerebras.ai) 创建一个 API 密钥。

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

验证模型是否可用

```bash
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 静态目录映射了 Cerebras 公共的 OpenAI 兼容端点。所有四个模型共享 128K 上下文和 8,192 最大输出 token。

模型标识	名称	支持推理	备注
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	否	生产级速度优先模型

WARNING

Cerebras 将 zai-glm-4.7 和 qwen-3-235b-a22b-instruct-2507 标记为预览模型，llama3.1-8b 和 qwen-3-235b-a22b-instruct-2507 计划于 2026 年 5 月 27 日废弃。在生产环境中依赖它们之前，请查看 Cerebras 的受支持模型页面。

手动配置

内置插件通常只需 API 密钥。当你需要覆盖模型元数据，或以 mode: "merge" 运行以修改静态目录时，可以进行显式配置：

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

INFO

如果 Gateway 以守护进程运行（launchd、systemd、Docker），请确保 CEREBRAS_API_KEY 对该进程可用——例如放在 ~/.openclaw/.env 中或通过 env.shellEnv 导入。仅在交互式 shell 中导出的密钥，如果没有被单独导入，将无法被托管服务使用。

相关文档

模型提供商

选择提供商、模型引用和故障转移行为。

思考模式

两个支持推理的 Cerebras 模型的推理强度设置。

配置参考

智能体默认设置和模型配置。

模型 FAQ

认证配置文件、切换模型和解决“无配置文件”错误。

常见问题

怎么获取 Cerebras API 密钥？

在 Cerebras Cloud Console 创建 API 密钥，密钥以 csk- 开头。

如何验证 Cerebras 模型已在 OpenClaw 中可用？

运行 openclaw models list --provider cerebras，应看到四个模型。如果列表为空或报错，检查 CEREBRAS_API_KEY 是否正确设置。

Cerebras 哪些模型即将废弃？

llama3.1-8b 和 qwen-3-235b-a22b-instruct-2507 计划于 2026 年 5 月 27 日废弃，届时它们可能无法使用。建议提前规划替代模型。