Skip to main content
Cerebras 提供在定制推理硬件上的高速、兼容 OpenAI 的推理服务。OpenClaw 包含一个内置的 Cerebras 提供方插件，带有一个静态的四模型目录。
PropertyValue
Provider idcerebras
Pluginbundled, enabledByDefault: true
Auth env varCEREBRAS_API_KEY
Onboarding flag--auth-choice cerebras-api-key
Direct CLI flag--cerebras-api-key <key>
APIOpenAI-compatible (openai-completions)
Base URLhttps://api.cerebras.ai/v1
Default modelcerebras/zai-glm-4.7

​
快速开始

1

获取 API 密钥

在 Cerebras Cloud Console 中创建一个 API 密钥。
2

运行 onboarding

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

验证模型可用

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 最大输出 token。
Model refNameReasoningNotes
cerebras/zai-glm-4.7Z.ai GLM 4.7yes默认模型；预览版推理模型
cerebras/gpt-oss-120bGPT OSS 120Byes生产级推理模型
cerebras/qwen-3-235b-a22b-instruct-2507Qwen 3 235B Instructno预览版非推理模型
cerebras/llama3.1-8bLlama 3.1 8Bno面向速度的生产模型
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" 下针对静态目录运行时，请使用显式的 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" },
        ],
      },
    },
  },
}
如果 Gateway 以守护进程方式运行（launchd、systemd、Docker），请确保 CEREBRAS_API_KEY 对该进程可用——例如放在 ~/.openclaw/.env 中，或通过 env.shellEnv 提供。仅在交互式 shell 中导出的密钥不会对托管服务生效，除非该环境变量被单独导入。

​
相关内容

模型提供方

选择提供方、模型引用以及故障切换行为。

思考模式

两个具备推理能力的 Cerebras 模型的推理强度级别。

配置参考

代理默认值和模型配置。

模型 FAQ

认证配置文件、切换模型以及解决“没有配置文件”错误。