跳转至

Cerebras

Cerebras 在自定义推理硬件上提供高速 OpenAI 兼容推理。该插件可发现原生模型元数据和定价,并附带用于离线回退的内置目录。

属性 值
提供商 ID cerebras
插件 官方外部软件包 (@openclaw/cerebras-provider)
身份验证环境变量 CEREBRAS_API_KEY
入门标志 --auth-choice cerebras-api-key
直接 CLI 标志 --cerebras-api-key <key>
API OpenAI 兼容 (openai-completions)
基础 URL https://api.cerebras.ai/v1
默认模型 cerebras/gemma-4-31b

安装插件

openclaw plugins install @openclaw/cerebras-provider

安装会自动应用于正在运行的 Gateway;否则将在下次启动时生效。参见 应用更改并检查。

快速开始

1. 获取 API 密钥

在 Cerebras Cloud Console 中创建 API 密钥。

2. 运行入门

openclaw onboard --auth-choice cerebras-api-key
openclaw onboard --non-interactive --accept-risk --skip-health \
  --auth-choice cerebras-api-key \
  --cerebras-api-key "$CEREBRAS_API_KEY"
export CEREBRAS_API_KEY=csk-...

3. 验证模型可用

openclaw models list --provider cerebras

列出已配置的 Cerebras 模型。如果 CEREBRAS_API_KEY 未解析,openclaw models status --json 会在 auth.unusableProfiles 下报告缺失的凭据。

非交互式设置

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

--mode 默认为 local,因此这与上面的 直接标志 命令是相同的执行。请在 Gateway 主机上运行它:远程客户端入门(--mode remote)仅配置本地客户端连接,不会在服务器上设置提供商凭据。

发现与定价

当配置了 Cerebras 身份验证,并且推理基础 URL 是规范的 https://api.cerebras.ai/v1 时,OpenClaw 会读取 GET /public/v1/models。此请求仅使用公共请求头:推理 API 密钥和发现凭据绝不会发送到元数据端点。自定义基础 URL 会跳过此公共发现,而不是将代理的目录与 Cerebras 元数据混合。如果没有 Cerebras 凭据,运行时提供商将保持非活动状态。公共元数据列表不会建立账户权限。

实时行提供原生上下文和补全限制、推理和视觉能力,以及 Prompt/补全价格。Cerebras 将这些价格作为每 Token 美元字符串返回;OpenClaw 将其转换为每百万 Token 美元。公共源不提供单独的缓存费率,因此 OpenClaw 对缓存读取使用输入价格,这与 Cerebras 对缓存 Token 的标准输入计费一致。

成功的目录会缓存 60 秒。如果发现失败、返回空目录,或没有可用的模型行,OpenClaw 会使用内置的离线种子。在默认 models.mode: "merge" 中,全新入门不会将生成的模型行或价格复制到你的配置中,从而允许价格刷新。明确编写的模型行和成本保持完整。在 models.mode: "replace" 中,发现被禁用,入门会改为将离线种子保留为显式配置。

内置目录

这三个离线回退模型具有 131,072 Token 的上下文窗口和 40,960 Token 的最大输出。对于仍存在于原生 公共源 中的模型,其价格已根据其 2026 年 8 月 31 日的响应刷新;缺失的旧版引用保留其种子快照。

模型引用 名称 推理 备注
cerebras/zai-glm-4.7 Z.ai GLM 4.7 是 2026 年 8 月 17 日弃用;为显式配置保留
cerebras/gpt-oss-120b GPT OSS 120B 是 生产推理模型
cerebras/gemma-4-31b Gemma 4 31B 是 默认;预览;文本和图像输入

Cerebras 的 弃用通知 将 zai-glm-4.7 标记为已弃用,但未指定替代项。OpenClaw 会保留已发布的引用,而不是删除它或重写现有选择;保留并不保证上游可用性。

全新入门遵循 Cerebras 当前的 Gemma 4 推荐。Cerebras 将 Gemma 4 31B 描述为其参考中型模型,具有与 GPT OSS 相当或更高的智能,并支持多模态代理。它是一个公共预览模型,可能会比生产 GPT OSS 端点更早变更或停止服务;现有 OpenClaw 配置会保留其已选模型。

Prompt 缓存

Cerebras 会自动缓存匹配的 Prompt 前缀。在原生 API 上,OpenClaw 会为每个对话发送稳定的 prompt_cache_key,以改善缓存路由。缓存 Token 会减少 Prompt 处理和未缓存 Token 的速率限制使用量;它们按标准输入 Token 价格计费。参见 Cerebras Prompt 缓存。

手动配置

大多数配置只需要 API 密钥。使用显式的 models.providers.cerebras 配置,在 mode: "merge" 中覆盖模型元数据;将 models 留空,即可使用发现的条目,而无需固定生成的价格:

{
  env: { vars: { CEREBRAS_API_KEY: "csk-..." } },
  agents: {
    defaults: {
      model: { primary: "cerebras/gemma-4-31b" },
    },
  },
  models: {
    mode: "merge",
    providers: {
      cerebras: {
        baseUrl: "https://api.cerebras.ai/v1",
        apiKey: "${CEREBRAS_API_KEY}",
        api: "openai-completions",
        models: [],
      },
    },
  },
}

Note

如果 Gateway 作为守护进程运行(launchd、systemd、Docker),请确保 CEREBRAS_API_KEY 对该进程可用——例如放在 ~/.openclaw/.env 中,或通过 env.shellEnv 提供。仅在交互式 shell 中导出的密钥,除非单独导入环境变量,否则对受管服务无效。

模型提供商

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

思考模式

Cerebras 模型的推理努力级别。

配置参考

代理默认设置和模型配置。

模型常见问题

身份验证配置文件、切换模型,以及解决 "no profile" 错误。

本页原文 Markdown:在 AtomGit 查看·内容源自开源项目 cl/openclaw