> ## Documentation Index
> Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Groq

[Groq](https://groq.com)는 맞춤형 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를 다시 시작합니다.

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw plugins install @openclaw/groq-provider
openclaw gateway restart
```

## 시작하기

<Steps>
  <Step title="API 키 받기">
    [console.groq.com/keys](https://console.groq.com/keys)에서 API 키를 만듭니다.
  </Step>

  <Step title="API 키 설정">
    ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
    export GROQ_API_KEY=gsk_...
    ```
  </Step>

  <Step title="기본 모델 설정">
    ```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
    {
      agents: {
        defaults: {
          model: { primary: "groq/llama-3.3-70b-versatile" },
        },
      },
    }
    ```
  </Step>

  <Step title="카탈로그에 연결할 수 있는지 확인">
    ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
    openclaw models list --provider groq
    ```
  </Step>
</Steps>

### 구성 파일 예시

```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
  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](https://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 |

<Tip>
  카탈로그는 각 OpenClaw 릴리스와 함께 발전합니다. `openclaw models list --provider groq`는 설치된 버전에 알려진 행을 보여 줍니다. 새로 추가되었거나 사용 중단된 모델은 [console.groq.com/docs/models](https://console.groq.com/docs/models)와 대조해 확인하세요.
</Tip>

## 추론 모델

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가 공급자별로 이를 변환하는 방식은 [사고 모드](/ko/tools/thinking)를 참조하세요.

## 오디오 전사

Groq 플러그인은 음성 메시지를 공유 `tools.media.audio` 표면을 통해 전사할 수 있도록 **오디오 미디어 이해 공급자**도 등록합니다.

| 속성        | 값                                 |
| --------- | --------------------------------- |
| 공유 구성 경로  | `tools.media.audio`               |
| 기본 기본 URL | `https://api.groq.com/openai/v1`  |
| 기본 모델     | `whisper-large-v3-turbo`          |
| 자동 우선순위   | 20                                |
| API 엔드포인트 | OpenAI 호환 `/audio/transcriptions` |

Groq를 기본 오디오 백엔드로 만들려면 다음을 사용합니다.

```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
  tools: {
    media: {
      audio: {
        models: [{ provider: "groq" }],
      },
    },
  },
}
```

<AccordionGroup>
  <Accordion title="데몬의 환경 가용성">
    Gateway가 관리형 서비스(launchd, systemd, Docker)로 실행되는 경우 `GROQ_API_KEY`는 대화형 셸뿐 아니라 해당 프로세스에도 보여야 합니다.

    <Warning>
      대화형 셸에서만 내보낸 키는 해당 환경도 그곳으로 가져오지 않는 한 launchd 또는 systemd 데몬에 도움이 되지 않습니다. Gateway 프로세스에서 읽을 수 있도록 `~/.openclaw/.env` 또는 `env.shellEnv`를 통해 키를 설정하세요.
    </Warning>
  </Accordion>

  <Accordion title="사용자 지정 Groq 모델 ID">
    OpenClaw는 런타임에 모든 Groq 모델 ID를 허용합니다. Groq가 표시하는 정확한 ID를 사용하고 앞에 `groq/`를 붙이세요. 정적 카탈로그는 일반적인 사례를 다룹니다. 카탈로그에 없는 ID는 기본 OpenAI 호환 템플릿으로 넘어갑니다.

    ```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
    {
      agents: {
        defaults: {
          model: { primary: "groq/<your-model-id>" },
        },
      },
    }
    ```
  </Accordion>
</AccordionGroup>

## 관련 항목

<CardGroup cols={2}>
  <Card title="모델 공급자" href="/ko/concepts/model-providers" icon="layers">
    공급자, 모델 참조, 장애 조치 동작 선택.
  </Card>

  <Card title="사고 모드" href="/ko/tools/thinking" icon="brain">
    추론 노력 수준과 공급자 정책 상호작용.
  </Card>

  <Card title="구성 참조" href="/ko/gateway/configuration-reference" icon="gear">
    공급자 및 오디오 설정을 포함한 전체 구성 스키마.
  </Card>

  <Card title="Groq Console" href="https://console.groq.com" icon="arrow-up-right-from-square">
    Groq 대시보드, API 문서, 가격.
  </Card>
</CardGroup>