메인 콘텐츠로 건너뛰기

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

Groq는 맞춤형 LPU 하드웨어를 사용해 오픈 가중치 모델(Llama, Gemma, Kimi, Qwen, GPT OSS 등)에 초고속 추론을 제공합니다. OpenClaw에는 OpenAI 호환 채팅 Provider와 오디오 미디어 이해 Provider를 모두 등록하는 번들 Groq Plugin이 포함되어 있습니다.
속성값
Provider IDgroq
Plugin번들 제공, enabledByDefault: true
인증 환경 변수GROQ_API_KEY
온보딩 플래그--auth-choice groq-api-key
APIOpenAI 호환(openai-completions)
기본 URLhttps://api.groq.com/openai/v1
오디오 전사whisper-large-v3-turbo(기본값)
제안 채팅 기본값groq/llama-3.3-70b-versatile

​
시작하기

1

API 키 받기

console.groq.com/keys에서 API 키를 만듭니다.
2

API 키 설정

openclaw onboard --auth-choice groq-api-key
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는 추론 항목과 비추론 항목을 모두 포함하는 manifest 기반 Groq 카탈로그를 제공합니다. 설치된 버전에 번들로 포함된 행을 보려면 openclaw models list --provider groq를 실행하거나, Groq의 공식 목록은 console.groq.com/docs/models에서 확인하세요.
모델 참조이름추론입력컨텍스트
groq/llama-3.3-70b-versatileLlama 3.3 70B Versatile아니요텍스트131,072
groq/llama-3.1-8b-instantLlama 3.1 8B Instant아니요텍스트131,072
groq/meta-llama/llama-4-maverick-17b-128e-instructLlama 4 Maverick 17B아니요텍스트 + 이미지131,072
groq/meta-llama/llama-4-scout-17b-16e-instructLlama 4 Scout 17B아니요텍스트 + 이미지131,072
groq/llama3-70b-8192Llama 3 70B아니요텍스트8,192
groq/llama3-8b-8192Llama 3 8B아니요텍스트8,192
groq/gemma2-9b-itGemma 2 9B아니요텍스트8,192
groq/mistral-saba-24bMistral Saba 24B아니요텍스트32,768
groq/moonshotai/kimi-k2-instructKimi K2 Instruct아니요텍스트131,072
groq/moonshotai/kimi-k2-instruct-0905Kimi K2 Instruct 0905아니요텍스트262,144
groq/openai/gpt-oss-120bGPT OSS 120B예텍스트131,072
groq/openai/gpt-oss-20bGPT OSS 20B예텍스트131,072
groq/openai/gpt-oss-safeguard-20bSafety GPT OSS 20B예텍스트131,072
groq/qwen-qwq-32bQwen QwQ 32B예텍스트131,072
groq/qwen/qwen3-32bQwen3 32B예텍스트131,072
groq/deepseek-r1-distill-llama-70bDeepSeek R1 Distill Llama 70B예텍스트131,072
groq/groq/compoundCompound예텍스트131,072
groq/groq/compound-miniCompound Mini예텍스트131,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가 Provider별로 이를 변환하는 방식은 생각하기 모드를 참고하세요.

​
오디오 전사

Groq의 번들 Plugin은 음성 메시지를 공유 tools.media.audio 표면을 통해 전사할 수 있도록 오디오 미디어 이해 Provider도 등록합니다.
속성값
공유 설정 경로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는 대화형 셸뿐만 아니라 해당 프로세스에도 표시되어야 합니다.
~/.profile에만 있는 키는 해당 환경을 거기로도 가져오지 않는 한 launchd 또는 systemd daemon에 도움이 되지 않습니다. Gateway 프로세스에서 읽을 수 있도록 키를 ~/.openclaw/.env에 설정하거나 env.shellEnv를 통해 설정하세요.
OpenClaw는 런타임에 모든 Groq 모델 ID를 허용합니다. Groq가 표시하는 정확한 ID를 사용하고 앞에 groq/를 붙이세요. 번들 카탈로그는 일반적인 경우를 다룹니다. 카탈로그에 없는 ID는 기본 OpenAI 호환 템플릿으로 넘어갑니다.
{
  agents: {
    defaults: {
      model: { primary: "groq/<your-model-id>" },
    },
  },
}

​
관련 항목

모델 Provider

Provider, 모델 참조, 장애 조치 동작 선택.

생각하기 모드

추론 노력 레벨과 Provider 정책 상호작용.

설정 참조

Provider와 오디오 설정을 포함한 전체 설정 스키마.

Groq Console

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