メインコンテンツへスキップ

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

Groq は、カスタム LPU ハードウェアを使用して、オープンウェイトモデル (Llama、Gemma、Kimi、Qwen、GPT OSS など) で超高速推論を提供します。OpenClaw には、OpenAI 互換のチャットプロバイダーと音声メディア理解プロバイダーの両方を登録する、バンドル済みの Groq Plugin が含まれています。
プロパティ
プロバイダー IDgroq
Pluginバンドル済み、enabledByDefault: true
認証環境変数GROQ_API_KEY
オンボーディングフラグ--auth-choice groq-api-key
APIOpenAI 互換 (openai-completions)
ベース URLhttps://api.groq.com/openai/v1
音声文字起こしwhisper-large-v3-turbo (デフォルト)
推奨チャットデフォルトgroq/llama-3.3-70b-versatile

はじめに

1

API キーを取得する

console.groq.com/keys で API キーを作成します。
2

API キーを設定する

openclaw onboard --auth-choice groq-api-key
3

デフォルトモデルを設定する

{
  agents: {
    defaults: {
      model: { primary: "groq/llama-3.3-70b-versatile" },
    },
  },
}
4

カタログに到達できることを確認する

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-versatileLlama 3.3 70B Versatileなしtext131,072
groq/llama-3.1-8b-instantLlama 3.1 8B Instantなしtext131,072
groq/meta-llama/llama-4-maverick-17b-128e-instructLlama 4 Maverick 17Bなしtext + image131,072
groq/meta-llama/llama-4-scout-17b-16e-instructLlama 4 Scout 17Bなしtext + image131,072
groq/llama3-70b-8192Llama 3 70Bなしtext8,192
groq/llama3-8b-8192Llama 3 8Bなしtext8,192
groq/gemma2-9b-itGemma 2 9Bなしtext8,192
groq/mistral-saba-24bMistral Saba 24Bなしtext32,768
groq/moonshotai/kimi-k2-instructKimi K2 Instructなしtext131,072
groq/moonshotai/kimi-k2-instruct-0905Kimi K2 Instruct 0905なしtext262,144
groq/openai/gpt-oss-120bGPT OSS 120Bありtext131,072
groq/openai/gpt-oss-20bGPT OSS 20Bありtext131,072
groq/openai/gpt-oss-safeguard-20bSafety GPT OSS 20Bありtext131,072
groq/qwen-qwq-32bQwen QwQ 32Bありtext131,072
groq/qwen/qwen3-32bQwen3 32Bありtext131,072
groq/deepseek-r1-distill-llama-70bDeepSeek R1 Distill Llama 70Bありtext131,072
groq/groq/compoundCompoundありtext131,072
groq/groq/compound-miniCompound Miniありtext131,072
カタログは OpenClaw の各リリースに合わせて進化します。openclaw models list --provider groq は、インストール済みバージョンが認識している行を表示します。新しく追加されたモデルや非推奨になったモデルについては console.groq.com/docs/models と照合してください。

推論モデル

OpenClaw は共有の /think レベルを Groq のモデル固有の reasoning_effort 値にマッピングします。
  • qwen/qwen3-32b では、思考を無効にすると none を送信し、思考を有効にすると default を送信します。
  • Groq GPT OSS 推論モデル (openai/gpt-oss-*) では、OpenClaw は /think レベルに基づいて lowmedium、または high を送信します。これらのモデルは無効値をサポートしないため、思考を無効にすると reasoning_effort は省略されます。
  • DeepSeek R1 Distill、Qwen QwQ、Compound は Groq のネイティブな推論サーフェスを使用します。/think は可視性を制御しますが、モデルは常に推論します。
共有の /think レベルと、OpenClaw がプロバイダーごとにそれらをどのように変換するかについては、思考モード を参照してください。

音声文字起こし

Groq のバンドル済み Plugin は 音声メディア理解プロバイダー も登録するため、音声メッセージを共有の tools.media.audio サーフェス経由で文字起こしできます。
プロパティ
共有設定パスtools.media.audio
デフォルトベース URLhttps://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 は対話型シェルだけでなく、そのプロセスから見える必要があります。
~/.profile にのみ置かれたキーは、その環境がそこにもインポートされていない限り、launchd や systemd デーモンには役立ちません。Gateway プロセスから読み取れるようにするには、キーを ~/.openclaw/.env または env.shellEnv 経由で設定してください。
OpenClaw は実行時に任意の Groq モデル ID を受け入れます。Groq が表示する正確な ID を使用し、先頭に groq/ を付けてください。バンドル済みカタログは一般的なケースをカバーします。カタログにない ID はデフォルトの OpenAI 互換テンプレートにフォールスルーします。
{
  agents: {
    defaults: {
      model: { primary: "groq/<your-model-id>" },
    },
  },
}

関連

モデルプロバイダー

プロバイダー、モデル参照、フェイルオーバー動作の選択。

思考モード

推論エフォートレベルとプロバイダーポリシーの相互作用。

設定リファレンス

プロバイダーと音声設定を含む完全な設定スキーマ。

Groq Console

Groq ダッシュボード、API ドキュメント、価格。