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 |
安装插件¶
安装会自动应用于正在运行的 Gateway;否则将在下次启动时生效。参见 应用更改并检查。
快速开始¶
1. 获取 API 密钥
在 Cerebras Cloud Console 中创建 API 密钥。
2. 运行入门
3. 验证模型可用
列出已配置的 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