Cerebras

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

安装插件¶

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 凭据时，运行时提供方将保持非活动状态。列出公共元数据并不代表账户已获授权。

实时行提供原生上下文长度和完成长度限制、推理与视觉能力，以及提示/完成价格。Cerebras 以 USD/每 token 的字符串形式返回这些价格；OpenClaw 会将它们转换为 USD/每百万 token。公共数据源不提供缓存费率。OpenClaw 运行时估算中的零缓存字段并不代表对企业级缓存或计费的声明。

成功获取的目录会缓存 60 秒。如果发现过程失败、返回空目录，或没有可用的模型行，OpenClaw 将使用内置的离线种子数据。在默认的 models.mode: "merge" 模式下，全新引导配置不会将生成的模型行或价格复制到你的配置中，从而允许价格刷新。显式编写的模型行和成本将保持不变。在 models.mode: "replace" 模式下，发现功能会被禁用，引导配置会改为将离线种子数据作为显式配置保留。

内置目录¶

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

Cerebras 的 弃用通知 将 zai-glm-4.7 标记为已弃用，但未指明替代模型。OpenClaw 保留随附引用，而不是删除它或重写现有选择；保留并不保证上游可用性。

全新引导配置会遵循 Cerebras 当前的 Gemma 4 推荐。Cerebras 将 Gemma 4 31B 描述为其参考级中型模型，智能水平与 GPT OSS 同等或更高，并支持多模态智能体。这是一个公开预览模型，与生产级 GPT OSS 端点相比，可能会在更短的通知期内发生变更或停止服务；现有 OpenClaw 配置会保留其已选模型。

手动配置¶

大多数设置只需要 API 密钥。如需在 mode: "merge" 下覆盖模型元数据，可使用显式的 models.providers.cerebras 配置；将 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: [],
      },
    },
  },
}

相关¶

模型提供商

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

思考模式

Cerebras 模型的推理努力级别。

配置参考

Agent 默认值和模型配置。

模型常见问题

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