Cerebras Provider
기준일: 2026-07-26
난이도: 중급
공식 기준: Cerebras
개요
이 페이지는 OpenClaw Cerebras provider의 인증, 모델 ref, 온보딩 플래그, 설정 키를 공식 문서 기준으로 정리합니다.
공식 요약: Cerebras setup (auth + model selection)
model ref는 보통 provider/model 형식입니다. API key·endpoint·model id는 아래 원문 값을 그대로 쓰세요. 임의로 키나 엔드포인트를 만들지 마세요.
빠른 참조
| Property | Value |
|---|---|
| Provider id | cerebras |
| Plugin | official external package (@openclaw/cerebras-provider) |
| Auth env var | CEREBRAS_API_KEY |
| Onboarding flag | --auth-choice cerebras-api-key |
| Direct CLI flag | --cerebras-api-key <key> |
| API | OpenAI-compatible (openai-completions) |
| Base URL | https://api.cerebras.ai/v1 |
| Default model | cerebras/zai-glm-4.7 |
공식 문서 기반 상세
아래는 공식 providers/cerebras 문서를 Mintlify 컴포넌트만 정리하고 공통 제목을 한국어로 맞춘 내용입니다. 설정 키, env, model ref, CLI 플래그는 원문 그대로 유지합니다.
Cerebras provides high-speed OpenAI-compatible inference on custom inference hardware. The plugin ships a static two-model catalog (no live discovery).
| Property | Value |
|---|---|
| Provider id | cerebras |
| Plugin | official external package (@openclaw/cerebras-provider) |
| Auth env var | CEREBRAS_API_KEY |
| Onboarding flag | --auth-choice cerebras-api-key |
| Direct CLI flag | --cerebras-api-key <key> |
| API | OpenAI-compatible (openai-completions) |
| Base URL | https://api.cerebras.ai/v1 |
| Default model | cerebras/zai-glm-4.7 |
Install plugin
openclaw plugins install @openclaw/cerebras-provider
openclaw gateway restart
시작하기
Get an API key
Create an API key in the [Cerebras Cloud Console](https://cloud.cerebras.ai).
Run onboarding
openclaw onboard --auth-choice cerebras-api-key
openclaw onboard --non-interactive \
--auth-choice cerebras-api-key \
--cerebras-api-key "$CEREBRAS_API_KEY"
export CEREBRAS_API_KEY=csk-...
Verify models are available
```bash
openclaw models list --provider cerebras
```
Lists both static models. If `CEREBRAS_API_KEY` is unresolved, `openclaw models status --json` reports the missing credential under `auth.unusableProfiles`.
Non-interactive setup
openclaw onboard --non-interactive \
--mode local \
--auth-choice cerebras-api-key \
--cerebras-api-key "$CEREBRAS_API_KEY"
Built-in catalog
Both models share a 128k context window and 8,192 max output tokens.
| Model ref | Name | Reasoning | Notes |
|---|---|---|---|
cerebras/zai-glm-4.7 |
Z.ai GLM 4.7 | yes | Default model; preview reasoning model |
cerebras/gpt-oss-120b |
GPT OSS 120B | yes | Production reasoning model |
Manual config
Most setups only need the API key. Use explicit models.providers.cerebras config to override model metadata or run in mode: "merge" against the static catalog:
{
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" },
],
},
},
},
}
If the Gateway runs as a daemon (launchd, systemd, Docker), make sure
CEREBRAS_API_KEYis available to that process — for example in~/.openclaw/.envor throughenv.shellEnv. A key exported only in an interactive shell will not help a managed service unless the env is imported separately.
관련 문서
Choosing providers, model refs, and failover behavior.
Reasoning effort levels for the two reasoning-capable Cerebras models.
Agent defaults and model configuration.
Auth profiles, switching models, and resolving "no profile" errors.
검증 체크리스트
-
openclaw models list --provider cerebras로 모델이 보이는지 확인 - 기본 model alias를
agents.defaults.model.primary에 설정했는지 확인 - API key / OAuth / 로컬 런타임 인증 경로를 공식 문서와 대조했는지 확인
- failover 시 데이터가 다른 provider로 이동할 수 있는지 검토