메인 콘텐츠로 건너뛰기

Documentation Index

Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

Cerebras는 맞춤형 추론 하드웨어에서 고속 OpenAI 호환 추론을 제공합니다. OpenClaw에는 정적 4개 모델 카탈로그가 포함된 번들 Cerebras 제공자 Plugin이 포함되어 있습니다.
속성값
제공자 IDcerebras
Plugin번들, enabledByDefault: true
인증 환경 변수CEREBRAS_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

​
시작하기

1

API 키 받기

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

온보딩 실행

openclaw onboard --auth-choice cerebras-api-key
3

모델 사용 가능 여부 확인

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"

​
내장 카탈로그

OpenClaw는 공개 OpenAI 호환 엔드포인트를 반영하는 정적 Cerebras 카탈로그를 제공합니다. 네 모델 모두 128k 컨텍스트와 최대 출력 토큰 8,192개를 공유합니다.
모델 ref이름추론참고 사항
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)으로 실행되는 경우 CEREBRAS_API_KEY가 해당 프로세스에서 사용 가능해야 합니다. 예를 들어 ~/.openclaw/.env 또는 env.shellEnv를 통해 제공할 수 있습니다. ~/.profile에만 있는 키는 env를 별도로 가져오지 않는 한 관리형 서비스에 도움이 되지 않습니다.

​
관련 항목

모델 제공자

제공자, 모델 refs, 장애 조치 동작 선택.

사고 모드

추론 가능 Cerebras 모델 2개에 대한 추론 노력 수준.

구성 참조

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

모델 FAQ

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