메인 콘텐츠로 건너뛰기

​
Groq

Groq는 맞춤형 LPU 하드웨어를 사용해 오픈소스 모델(Llama, Gemma, Mistral 등)에 대해 초고속 추론을 제공합니다. OpenClaw는 OpenAI 호환 API를 통해 Groq에 연결합니다.
PropertyValue
Providergroq
AuthGROQ_API_KEY
APIOpenAI 호환

​
시작하기

1

API 키 가져오기

console.groq.com/keys에서 API 키를 생성합니다.
2

API 키 설정

export GROQ_API_KEY="gsk_..."
3

기본 모델 설정

{
  agents: {
    defaults: {
      model: { primary: "groq/llama-3.3-70b-versatile" },
    },
  },
}

​
구성 파일 예시

{
  env: { GROQ_API_KEY: "gsk_..." },
  agents: {
    defaults: {
      model: { primary: "groq/llama-3.3-70b-versatile" },
    },
  },
}

​
사용 가능한 모델

Groq의 모델 카탈로그는 자주 변경됩니다. 현재 사용 가능한 모델을 보려면 openclaw models list | grep groq를 실행하거나 console.groq.com/docs/models를 확인하세요.
Model참고
Llama 3.3 70B Versatile범용, 큰 컨텍스트
Llama 3.1 8B Instant빠르고 가벼움
Gemma 2 9B작고 효율적
Mixtral 8x7BMoE 아키텍처, 강력한 reasoning
계정에서 사용할 수 있는 최신 모델 목록은 openclaw models list --provider groq를 사용하세요.

​
오디오 전사

Groq는 빠른 Whisper 기반 오디오 전사도 제공합니다. 미디어 이해 provider로 구성하면, OpenClaw는 공유 tools.media.audio 표면을 통해 음성 메시지를 전사하기 위해 Groq의 whisper-large-v3-turbo 모델을 사용합니다. 
{
  tools: {
    media: {
      audio: {
        models: [{ provider: "groq" }],
      },
    },
  },
}
PropertyValue
공유 구성 경로tools.media.audio
기본 base URLhttps://api.groq.com/openai/v1
기본 모델whisper-large-v3-turbo
API 엔드포인트OpenAI 호환 /audio/transcriptions
Gateway가 데몬(launchd/systemd)으로 실행되는 경우, 해당 프로세스에서 GROQ_API_KEY를 사용할 수 있어야 합니다(예: ~/.openclaw/.env 또는 env.shellEnv).
대화형 셸에만 설정된 키는 데몬이 관리하는 Gateway 프로세스에서는 보이지 않습니다. 지속적으로 사용할 수 있게 하려면 ~/.openclaw/.env 또는 env.shellEnv 구성을 사용하세요.

​
관련 항목

모델 선택

provider, 모델 ref, failover 동작을 선택합니다.

구성 참조

provider 및 오디오 설정을 포함한 전체 구성 스키마입니다.

Groq Console

Groq 대시보드, API 문서 및 가격 정보입니다.

Groq 모델 목록

공식 Groq 모델 카탈로그입니다.