Cerebras
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/zai-glm-4.7 |
安装插件
openclaw plugins install @openclaw/cerebras-provider
openclaw gateway restart入门指南
获取 API key
在 Cerebras Cloud Console 中创建 API key。
运行新手引导
openclaw onboard --auth-choice cerebras-api-keyopenclaw onboard --non-interactive \
--auth-choice cerebras-api-key \
--cerebras-api-key "$CEREBRAS_API_KEY"export CEREBRAS_API_KEY=csk-...验证模型是否可用
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。
| 模型引用 | 名称 | 推理 | 说明 |
|---|---|---|---|
cerebras/zai-glm-4.7 | Z.ai GLM 4.7 | 是 | 默认模型；预览版推理模型 |
cerebras/gpt-oss-120b | GPT OSS 120B | 是 | 生产级推理模型 |
手动配置
大多数设置只需要 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 中导出的密钥无法供托管服务使用，除非单独导入该环境变量。