Cerebras

Cerebras는 맞춤형 추론 하드웨어에서 고속 OpenAI 호환 추론을 제공합니다. Plugin에는 4개 모델의 정적 카탈로그가 포함되어 있습니다(실시간 검색 없음).

속성	값
공급자 ID	`cerebras`
Plugin	공식 외부 패키지 (`@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`

Plugin 설치

openclaw plugins install @openclaw/cerebras-provider
openclaw gateway restart

시작하기

API 키 발급

Cerebras Cloud Console에서 API 키를 생성합니다.

온보딩 실행

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-...

모델 사용 가능 여부 확인

openclaw models list --provider cerebras

정적 모델 4개를 모두 나열합니다. 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"

기본 제공 카탈로그

4개 모델은 모두 128k 컨텍스트 창과 최대 8,192개의 출력 토큰을 지원합니다.

모델 참조	이름	추론	참고 사항
`cerebras/zai-glm-4.7`	Z.ai GLM 4.7	예	기본 모델, 미리 보기 추론 모델
`cerebras/gpt-oss-120b`	GPT OSS 120B	예	프로덕션 추론 모델
`cerebras/qwen-3-235b-a22b-instruct-2507`	Qwen 3 235B Instruct	아니요	미리 보기 비추론 모델
`cerebras/llama3.1-8b`	Llama 3.1 8B	아니요	프로덕션 속도 최적화 모델

Cerebras는 zai-glm-4.7 및 qwen-3-235b-a22b-instruct-2507을 미리 보기 모델로 표시하며, llama3.1-8b와 qwen-3-235b-a22b-instruct-2507은 2026년 5월 27일에 지원 중단될 예정이라고 문서에 명시되어 있습니다. 프로덕션 워크로드에 사용하기 전에 Cerebras의 지원 모델 페이지를 확인하세요.

수동 구성

대부분의 설정에는 API 키만 필요합니다. 모델 메타데이터를 재정의하거나 정적 카탈로그에 대해 mode: "merge"로 실행하려면 명시적인 models.providers.cerebras 구성을 사용하세요.

{
  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를 통해 제공할 수 있습니다. 대화형 셸에서만 내보낸 키는 환경을 별도로 가져오지 않는 한 관리형 서비스에 적용되지 않습니다.

모델 공급자

공급자와 모델 참조를 선택하고 장애 조치 동작을 구성하는 방법입니다.

사고 모드

추론을 지원하는 두 Cerebras 모델의 추론 노력 수준입니다.

구성 참조

에이전트 기본값 및 모델 구성입니다.

모델 FAQ

인증 프로필, 모델 전환 및 “프로필 없음” 오류 해결 방법입니다.

Overview

Concepts and configuration

Providers

Plugin 설치

시작하기

비대화형 설정

기본 제공 카탈로그

수동 구성

관련 항목

모델 공급자

사고 모드

구성 참조

모델 FAQ

​Plugin 설치

​시작하기

​비대화형 설정

​기본 제공 카탈로그

​수동 구성

​관련 항목

모델 공급자

사고 모드

구성 참조

모델 FAQ

Plugin 설치

시작하기

비대화형 설정

기본 제공 카탈로그

수동 구성

관련 항목