Providers
Groq
Groq는 맞춤형 LPU 하드웨어를 사용하여 오픈 가중치 모델(Llama, Gemma, Kimi, Qwen, GPT OSS 등)에 초고속 추론을 제공합니다. Groq 플러그인은 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 |
플러그인 설치
공식 플러그인을 설치한 다음 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 | 아니요 | text | 131,072 |
groq/llama-3.1-8b-instant |
Llama 3.1 8B Instant | 아니요 | text | 131,072 |
groq/meta-llama/llama-4-scout-17b-16e-instruct |
Llama 4 Scout 17B | 아니요 | text + image | 131,072 |
groq/openai/gpt-oss-120b |
GPT OSS 120B | 예 | text | 131,072 |
groq/openai/gpt-oss-20b |
GPT OSS 20B | 예 | text | 131,072 |
groq/openai/gpt-oss-safeguard-20b |
Safety GPT OSS 20B | 예 | text | 131,072 |
groq/qwen/qwen3-32b |
Qwen3 32B | 예 | text | 131,072 |
groq/groq/compound |
Compound | 예 | text | 131,072 |
groq/groq/compound-mini |
Compound Mini | 예 | text | 131,072 |
추론 모델
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 |
| 기본 기본 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>" }, }, },}