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はじめに
Get an API key
console.groq.com/keys で API キーを作成します。
Set the API key
export GROQ_API_KEY=gsk_...Set a default model
{ agents: { defaults: { model: { primary: "groq/llama-3.3-70b-versatile" }, }, },}Verify the catalog is reachable
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 は、共有の /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" }], }, }, },}Environment availability for the daemon
Gateway が管理対象サービス(launchd、systemd、Docker)として実行される場合、GROQ_API_KEY はそのプロセスから見える必要があります。対話型シェルだけから見えても不十分です。
Custom Groq model ids
OpenClaw は実行時に任意の Groq モデル id を受け付けます。Groq に表示される正確な id を使用し、groq/ を接頭辞として付けてください。静的カタログは一般的なケースを対象とします。カタログにない id は、デフォルトの OpenAI 互換テンプレートにフォールスルーします。
{ agents: { defaults: { model: { primary: "groq/<your-model-id>" }, }, },}