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 のインストール

はじめに

設定ファイルの例

組み込みカタログ

推論モデル

音声文字起こし

関連情報