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>" }, }, },}