mirror of
https://github.com/openclaw/openclaw.git
synced 2026-06-25 11:39:34 +00:00
95 lines
2.9 KiB
Markdown
95 lines
2.9 KiB
Markdown
---
|
|
summary: "Cerebras setup (auth + model selection)"
|
|
title: "Cerebras"
|
|
read_when:
|
|
- You want to use Cerebras with OpenClaw
|
|
- You need the Cerebras API key env var or CLI auth choice
|
|
---
|
|
|
|
[Cerebras](https://www.cerebras.ai) provides high-speed OpenAI-compatible inference.
|
|
|
|
| Property | Value |
|
|
| -------- | ---------------------------- |
|
|
| Provider | `cerebras` |
|
|
| Auth | `CEREBRAS_API_KEY` |
|
|
| API | OpenAI-compatible |
|
|
| Base URL | `https://api.cerebras.ai/v1` |
|
|
|
|
## Getting Started
|
|
|
|
<Steps>
|
|
<Step title="Get an API key">
|
|
Create an API key in the [Cerebras Cloud Console](https://cloud.cerebras.ai).
|
|
</Step>
|
|
<Step title="Run onboarding">
|
|
```bash
|
|
openclaw onboard --auth-choice cerebras-api-key
|
|
```
|
|
</Step>
|
|
<Step title="Verify models are available">
|
|
```bash
|
|
openclaw models list --provider cerebras
|
|
```
|
|
</Step>
|
|
</Steps>
|
|
|
|
### Non-Interactive Setup
|
|
|
|
```bash
|
|
openclaw onboard --non-interactive \
|
|
--mode local \
|
|
--auth-choice cerebras-api-key \
|
|
--cerebras-api-key "$CEREBRAS_API_KEY"
|
|
```
|
|
|
|
## Built-In Catalog
|
|
|
|
OpenClaw ships a static Cerebras catalog for the public OpenAI-compatible endpoint:
|
|
|
|
| Model ref | Name | Notes |
|
|
| ----------------------------------------- | -------------------- | -------------------------------------- |
|
|
| `cerebras/zai-glm-4.7` | Z.ai GLM 4.7 | Default model; preview reasoning model |
|
|
| `cerebras/gpt-oss-120b` | GPT OSS 120B | Production reasoning model |
|
|
| `cerebras/qwen-3-235b-a22b-instruct-2507` | Qwen 3 235B Instruct | Preview non-reasoning model |
|
|
| `cerebras/llama3.1-8b` | Llama 3.1 8B | Production speed-focused model |
|
|
|
|
<Warning>
|
|
Cerebras marks `zai-glm-4.7` and `qwen-3-235b-a22b-instruct-2507` as preview models, and `llama3.1-8b` / `qwen-3-235b-a22b-instruct-2507` are documented for deprecation on May 27, 2026. Check Cerebras' supported-models page before relying on them for production.
|
|
</Warning>
|
|
|
|
## Manual Config
|
|
|
|
The bundled plugin usually means you only need the API key. Use explicit
|
|
`models.providers.cerebras` config when you want to override model metadata:
|
|
|
|
```json5
|
|
{
|
|
env: { CEREBRAS_API_KEY: "sk-..." },
|
|
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" },
|
|
],
|
|
},
|
|
},
|
|
},
|
|
}
|
|
```
|
|
|
|
<Note>
|
|
If the Gateway runs as a daemon (launchd/systemd), make sure `CEREBRAS_API_KEY`
|
|
is available to that process, for example in `~/.openclaw/.env` or through
|
|
`env.shellEnv`.
|
|
</Note>
|