Providers
Groq
Groq は、カスタム LPU ハードウェアを使用して、オープンウェイトモデル (Llama、Gemma、Kimi、Qwen、GPT OSS など) で超高速推論を提供します。OpenClaw には、OpenAI 互換のチャットプロバイダーと音声メディア理解プロバイダーの両方を登録する、バンドル済みの Groq Plugin が含まれています。
| プロパティ | 値 |
|---|---|
| プロバイダー ID | groq |
| Plugin | バンドル済み、enabledByDefault: true |
| 認証環境変数 | GROQ_API_KEY |
| オンボーディングフラグ | --auth-choice groq-api-key |
| API | OpenAI 互換 (openai-completions) |
| ベース URL | https://api.groq.com/openai/v1 |
| 音声文字起こし | whisper-large-v3-turbo (デフォルト) |
| 推奨チャットデフォルト | groq/llama-3.3-70b-versatile |
はじめに
API キーを取得する
console.groq.com/keys で API キーを作成します。
API キーを設定する
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 は、推論ありと推論なしの両方の項目を含む、マニフェストに基づく Groq カタログを同梱しています。インストール済みバージョンにバンドルされている行を確認するには openclaw models list --provider groq を実行し、Groq の正式な一覧については 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-maverick-17b-128e-instruct |
Llama 4 Maverick 17B | なし | text + image | 131,072 |
groq/meta-llama/llama-4-scout-17b-16e-instruct |
Llama 4 Scout 17B | なし | text + image | 131,072 |
groq/llama3-70b-8192 |
Llama 3 70B | なし | text | 8,192 |
groq/llama3-8b-8192 |
Llama 3 8B | なし | text | 8,192 |
groq/gemma2-9b-it |
Gemma 2 9B | なし | text | 8,192 |
groq/mistral-saba-24b |
Mistral Saba 24B | なし | text | 32,768 |
groq/moonshotai/kimi-k2-instruct |
Kimi K2 Instruct | なし | text | 131,072 |
groq/moonshotai/kimi-k2-instruct-0905 |
Kimi K2 Instruct 0905 | なし | text | 262,144 |
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-qwq-32b |
Qwen QwQ 32B | あり | text | 131,072 |
groq/qwen/qwen3-32b |
Qwen3 32B | あり | text | 131,072 |
groq/deepseek-r1-distill-llama-70b |
DeepSeek R1 Distill Llama 70B | あり | text | 131,072 |
groq/groq/compound |
Compound | あり | text | 131,072 |
groq/groq/compound-mini |
Compound Mini | あり | text | 131,072 |
推論モデル
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 がプロバイダーごとにそれらをどのように変換するかについては、思考モード を参照してください。
音声文字起こし
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>" },
},
},
}