Skip to main content
Cerebras 在自定义推理硬件上提供高速、兼容 OpenAI 的推理。该插件内置静态的四模型目录（无实时发现）。
属性值
提供商 idcerebras
插件官方外部包（@openclaw/cerebras-provider）
凭证环境变量CEREBRAS_API_KEY
新手引导标志--auth-choice cerebras-api-key
直接 CLI 标志--cerebras-api-key <key>
API兼容 OpenAI（openai-completions）
基础 URLhttps://api.cerebras.ai/v1
默认模型cerebras/zai-glm-4.7

​
安装插件

openclaw plugins install @openclaw/cerebras-provider
openclaw gateway restart

​
入门指南

1

获取 API key

在 Cerebras Cloud Console 中创建 API key。
2

运行新手引导

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

验证模型可用

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"

​
内置目录

全部四个模型共享 128k 上下文窗口和 8,192 个最大输出 token。
模型 ref名称推理说明
cerebras/zai-glm-4.7Z.ai GLM 4.7是默认模型；预览版推理模型
cerebras/gpt-oss-120bGPT OSS 120B是生产推理模型
cerebras/qwen-3-235b-a22b-instruct-2507Qwen 3 235B Instruct否预览版非推理模型
cerebras/llama3.1-8bLlama 3.1 8B否面向速度的生产模型
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 key。使用显式的 models.providers.cerebras 配置来覆盖模型元数据，或以 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" },
        ],
      },
    },
  },
}
如果 Gateway 网关作为守护进程运行（launchd、systemd、Docker），请确保 CEREBRAS_API_KEY 对该进程可用，例如放在 ~/.openclaw/.env 中，或通过 env.shellEnv 提供。仅在交互式 shell 中导出的 key 对托管服务没有帮助，除非单独导入该环境变量。

​
相关

模型提供商

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

思考模式

两个支持推理的 Cerebras 模型的推理强度级别。

配置参考

Agent 默认值和模型配置。

模型常见问题

凭证档案、切换模型，以及解决 “no profile” 错误。