Groq

Groq는 맞춤형 LPU 하드웨어를 사용해 오픈 가중치 모델(Llama, Gemma, Kimi, Qwen, GPT OSS 등)에 초고속 추론을 제공합니다. OpenClaw에는 OpenAI 호환 채팅 Provider와 오디오 미디어 이해 Provider를 모두 등록하는 번들 Groq Plugin이 포함되어 있습니다.

# 시작하기

openclaw onboard --auth-choice groq-api-key

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는 추론 항목과 비추론 항목을 모두 포함하는 manifest 기반 Groq 카탈로그를 제공합니다. 설치된 버전에 번들로 포함된 행을 보려면 openclaw models list --provider groq를 실행하거나, 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도 등록합니다.

Groq를 기본 오디오 백엔드로 설정하려면:

{
  tools: {
    media: {
      audio: {
        models: [{ provider: "groq" }],
      },
    },
  },
}

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

# 관련 항목