메인 콘텐츠로 건너뛰기
Cerebras는 맞춤형 추론 하드웨어에서 고속 OpenAI 호환 추론을 제공합니다. Cerebras 제공자 Plugin에는 정적 4개 모델 카탈로그가 포함되어 있습니다.
속성값
제공자 IDcerebras
Plugin공식 외부 패키지
인증 env varCEREBRAS_API_KEY
온보딩 플래그--auth-choice cerebras-api-key
직접 CLI 플래그--cerebras-api-key <key>
APIOpenAI 호환 (openai-completions)
기본 URLhttps://api.cerebras.ai/v1
기본 모델cerebras/zai-glm-4.7

​
Plugin 설치

공식 Plugin을 설치한 다음 Gateway를 다시 시작하세요. 
openclaw plugins install @openclaw/cerebras-provider
openclaw gateway restart

​
시작하기

1

API 키 받기

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

온보딩 실행

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

모델 사용 가능 여부 확인

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"

​
내장 카탈로그

OpenClaw는 공개 OpenAI 호환 엔드포인트를 미러링하는 정적 Cerebras 카탈로그를 제공합니다. 네 모델 모두 128k 컨텍스트와 최대 출력 토큰 8,192개를 공유합니다.
모델 참조이름추론참고
cerebras/zai-glm-4.7Z.ai GLM 4.7예기본 모델, 프리뷰 추론 모델
cerebras/gpt-oss-120bGPT OSS 120B예프로덕션 추론 모델
cerebras/qwen-3-235b-a22b-instruct-2507Qwen 3 235B Instruct아니요프리뷰 비추론 모델
cerebras/llama3.1-8bLlama 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의 지원 모델 페이지를 확인하세요.

​
수동 설정

일반적으로 Plugin을 사용하면 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)으로 실행되는 경우, 예를 들어 ~/.openclaw/.env 또는 env.shellEnv를 통해 CEREBRAS_API_KEY를 해당 프로세스에서 사용할 수 있는지 확인하세요. 대화형 셸에서만 내보낸 키는 env를 별도로 가져오지 않는 한 관리형 서비스에는 도움이 되지 않습니다.

​
관련 항목

모델 제공자

제공자, 모델 참조, 장애 조치 동작을 선택합니다.

사고 모드

추론이 가능한 두 Cerebras 모델의 추론 노력 수준입니다.

설정 참조

에이전트 기본값 및 모델 설정입니다.

모델 FAQ

인증 프로필, 모델 전환, “no profile” 오류 해결입니다.