Providers
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-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 | なし | テキスト | 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 |
推論モデル
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 は対話型シェルだけでなく、そのプロセスから参照できる必要があります。
カスタム Groq モデル ID
OpenClaw は、実行時に任意の Groq モデル ID を受け付けます。Groq に表示される正確な ID を使用し、先頭に groq/ を付けてください。静的カタログは一般的なケースを網羅しています。カタログにない ID には、デフォルトの OpenAI 互換テンプレートが適用されます。
{ agents: { defaults: { model: { primary: "groq/<your-model-id>" }, }, },}