메인 콘텐츠로 건너뛰기
Groq는 맞춤형 LPU 하드웨어를 사용하여 오픈 가중치 모델(Llama, Gemma, Kimi, Qwen, GPT OSS 등)에 초고속 추론을 제공합니다. Groq 플러그인은 OpenAI 호환 채팅 공급자와 오디오 미디어 이해 공급자를 모두 등록합니다.
속성값
공급자 IDgroq
Plugin공식 외부 패키지
인증 환경 변수GROQ_API_KEY
APIOpenAI 호환(openai-completions)
기본 URLhttps://api.groq.com/openai/v1
오디오 전사whisper-large-v3-turbo(기본값)
제안 채팅 기본값groq/llama-3.3-70b-versatile

​
플러그인 설치

공식 플러그인을 설치한 다음 Gateway를 다시 시작합니다. 
openclaw plugins install @openclaw/groq-provider
openclaw gateway restart

​
시작하기

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" },
    },
  },
}
4

카탈로그에 연결할 수 있는지 확인

openclaw models list --provider groq

​
구성 파일 예시

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

​
기본 제공 카탈로그

OpenClaw는 추론 항목과 비추론 항목을 모두 포함하는 매니페스트 기반 Groq 카탈로그를 제공합니다. 설치된 버전의 정적 행을 보려면 openclaw models list --provider groq를 실행하거나, Groq의 공식 목록은 console.groq.com/docs/models에서 확인하세요.
모델 참조이름추론입력컨텍스트
groq/llama-3.3-70b-versatileLlama 3.3 70B Versatile아니요text131,072
groq/llama-3.1-8b-instantLlama 3.1 8B Instant아니요text131,072
groq/meta-llama/llama-4-scout-17b-16e-instructLlama 4 Scout 17B아니요text + image131,072
groq/openai/gpt-oss-120bGPT OSS 120B예text131,072
groq/openai/gpt-oss-20bGPT OSS 20B예text131,072
groq/openai/gpt-oss-safeguard-20bSafety GPT OSS 20B예text131,072
groq/qwen/qwen3-32bQwen3 32B예text131,072
groq/groq/compoundCompound예text131,072
groq/groq/compound-miniCompound Mini예text131,072
카탈로그는 각 OpenClaw 릴리스와 함께 발전합니다. openclaw models list --provider groq는 설치된 버전에 알려진 행을 보여 줍니다. 새로 추가되었거나 사용 중단된 모델은 console.groq.com/docs/models와 대조해 확인하세요.

​
추론 모델

OpenClaw는 공유 /think 수준을 Groq의 모델별 reasoning_effort 값에 매핑합니다.
  • qwen/qwen3-32b의 경우 비활성화된 사고는 none을 보내고 활성화된 사고는 default를 보냅니다.
  • Groq GPT OSS 추론 모델(openai/gpt-oss-*)의 경우 OpenClaw는 /think 수준에 따라 low, medium 또는 high를 보냅니다. 해당 모델은 비활성화 값을 지원하지 않으므로 비활성화된 사고에서는 reasoning_effort를 생략합니다.
  • DeepSeek R1 Distill, Qwen QwQ, Compound는 Groq의 네이티브 추론 표면을 사용합니다. /think는 표시 여부를 제어하지만 모델은 항상 추론합니다.
공유 /think 수준과 OpenClaw가 공급자별로 이를 변환하는 방식은 사고 모드를 참조하세요.

​
오디오 전사

Groq 플러그인은 음성 메시지를 공유 tools.media.audio 표면을 통해 전사할 수 있도록 오디오 미디어 이해 공급자도 등록합니다.
속성값
공유 구성 경로tools.media.audio
기본 기본 URLhttps://api.groq.com/openai/v1
기본 모델whisper-large-v3-turbo
자동 우선순위20
API 엔드포인트OpenAI 호환 /audio/transcriptions
Groq를 기본 오디오 백엔드로 만들려면 다음을 사용합니다. 
{
  tools: {
    media: {
      audio: {
        models: [{ provider: "groq" }],
      },
    },
  },
}
Gateway가 관리형 서비스(launchd, systemd, Docker)로 실행되는 경우 GROQ_API_KEY는 대화형 셸뿐 아니라 해당 프로세스에도 보여야 합니다.
대화형 셸에서만 내보낸 키는 해당 환경도 그곳으로 가져오지 않는 한 launchd 또는 systemd 데몬에 도움이 되지 않습니다. Gateway 프로세스에서 읽을 수 있도록 ~/.openclaw/.env 또는 env.shellEnv를 통해 키를 설정하세요.
OpenClaw는 런타임에 모든 Groq 모델 ID를 허용합니다. Groq가 표시하는 정확한 ID를 사용하고 앞에 groq/를 붙이세요. 정적 카탈로그는 일반적인 사례를 다룹니다. 카탈로그에 없는 ID는 기본 OpenAI 호환 템플릿으로 넘어갑니다.
{
  agents: {
    defaults: {
      model: { primary: "groq/<your-model-id>" },
    },
  },
}

​
관련 항목

모델 공급자

공급자, 모델 참조, 장애 조치 동작 선택.

사고 모드

추론 노력 수준과 공급자 정책 상호작용.

구성 참조

공급자 및 오디오 설정을 포함한 전체 구성 스키마.

Groq Console

Groq 대시보드, API 문서, 가격.