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-provider
openclaw 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

카탈로그는 OpenClaw 릴리스마다 변경됩니다. openclaw models list --provider groq는 설치된 버전에 알려진 항목을 표시합니다. 새로 추가되거나 사용 중단된 모델이 있는지 console.groq.com/docs/models와 대조해 확인하세요.

추론 모델

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는 대화형 셸뿐만 아니라 해당 프로세스에서도 접근할 수 있어야 합니다.

대화형 셸에서만 내보낸 키는 해당 환경을 함께 가져오지 않는 한 launchd 또는 systemd 데몬에 적용되지 않습니다. Gateway 프로세스에서 읽을 수 있도록 ~/.openclaw/.env 또는 env.shellEnv를 통해 키를 설정하세요.

사용자 지정 Groq 모델 ID

OpenClaw는 런타임에 모든 Groq 모델 ID를 허용합니다. Groq에 표시된 정확한 ID 앞에 groq/를 붙여 사용하세요. 정적 카탈로그에는 일반적인 사례가 포함되어 있으며, 카탈로그에 없는 ID에는 기본 OpenAI 호환 템플릿이 적용됩니다.

{
  agents: {
    defaults: {
      model: { primary: "groq/<your-model-id>" },
    },
  },
}

모델 제공자

제공자, 모델 참조 및 장애 조치 동작을 선택하는 방법입니다.

사고 모드

추론 노력 수준과 제공자 정책 간의 상호작용입니다.

구성 참조

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

Groq Console

Groq 대시보드, API 문서 및 요금 정보입니다.

Overview

Concepts and configuration

Providers

Plugin 설치

시작하기

구성 파일 예시

기본 제공 카탈로그

추론 모델

오디오 전사

관련 항목

모델 제공자

사고 모드

구성 참조

Groq Console

​Plugin 설치

​시작하기

​구성 파일 예시

​기본 제공 카탈로그

​추론 모델

​오디오 전사

​관련 항목

모델 제공자

사고 모드

구성 참조

Groq Console

Plugin 설치

시작하기

구성 파일 예시

기본 제공 카탈로그

추론 모델

오디오 전사

관련 항목