Providers
Groq
Groq는 맞춤형 LPU 하드웨어를 사용해 오픈 웨이트 모델(Llama, Gemma, Kimi, Qwen, GPT OSS 등)에 초고속 추론을 제공합니다. Groq Plugin은 OpenAI 호환 채팅 제공자와 오디오 미디어 이해 제공자를 모두 등록합니다.
| 속성 | 값 |
|---|---|
| 제공자 ID | groq |
| Plugin | 공식 외부 패키지 |
| 인증 환경 변수 | GROQ_API_KEY |
| API | OpenAI 호환(openai-completions) |
| 기본 URL | https://api.groq.com/openai/v1 |
| 오디오 전사 | whisper-large-v3-turbo(기본값) |
| 권장 기본 채팅 모델 | groq/llama-3.3-70b-versatile |
Plugin 설치
공식 Plugin을 설치한 다음 Gateway를 다시 시작합니다.
openclaw plugins install @openclaw/groq-provideropenclaw gateway restart시작하기
API 키 발급
console.groq.com/keys에서 API 키를 생성합니다.
API 키 설정
export GROQ_API_KEY=gsk_...기본 모델 설정
{ agents: { defaults: { model: { primary: "groq/llama-3.3-70b-versatile" }, }, },}카탈로그에 접근할 수 있는지 확인
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-versatile |
Llama 3.3 70B Versatile | 아니요 | 텍스트 | 131,072 |
groq/llama-3.1-8b-instant |
Llama 3.1 8B Instant | 아니요 | 텍스트 | 131,072 |
groq/meta-llama/llama-4-scout-17b-16e-instruct |
Llama 4 Scout 17B | 아니요 | 텍스트 + 이미지 | 131,072 |
groq/openai/gpt-oss-120b |
GPT OSS 120B | 예 | 텍스트 | 131,072 |
groq/openai/gpt-oss-20b |
GPT OSS 20B | 예 | 텍스트 | 131,072 |
groq/openai/gpt-oss-safeguard-20b |
Safety GPT OSS 20B | 예 | 텍스트 | 131,072 |
groq/qwen/qwen3-32b |
Qwen3 32B | 예 | 텍스트 | 131,072 |
groq/groq/compound |
Compound | 예 | 텍스트 | 131,072 |
groq/groq/compound-mini |
Compound Mini | 예 | 텍스트 | 131,072 |
추론 모델
Groq 추론 모델(위 표에서 reasoning: true)은 OpenClaw의 공통 /think 수준을 low, medium, high의 reasoning_effort 값에 매핑합니다. /think off 또는 /think none은 비활성화 값을 전송하는 대신 요청에서 reasoning_effort를 생략합니다.
공통 /think 수준과 OpenClaw가 제공자별로 이를 변환하는 방법은 사고 모드를 참조하세요.
오디오 전사
Groq Plugin은 음성 메시지를 공통 tools.media.audio 표면을 통해 전사할 수 있도록 오디오 미디어 이해 제공자도 등록합니다.
| 속성 | 값 |
|---|---|
| 공통 구성 경로 | tools.media.audio |
| 기본 URL | https://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는 대화형 셸뿐만 아니라 해당 프로세스에서도 접근할 수 있어야 합니다.
사용자 지정 Groq 모델 ID
OpenClaw는 런타임에 모든 Groq 모델 ID를 허용합니다. Groq에 표시된 정확한 ID 앞에 groq/를 붙여 사용하세요. 정적 카탈로그에는 일반적인 사례가 포함되어 있으며, 카탈로그에 없는 ID에는 기본 OpenAI 호환 템플릿이 적용됩니다.
{ agents: { defaults: { model: { primary: "groq/<your-model-id>" }, }, },}