メインコンテンツへスキップ
Groq は、カスタム LPU ハードウェアを使用して、オープンウェイトモデル(Llama、Gemma、Kimi、Qwen、GPT OSS など)で超高速推論を提供します。Groq Plugin は、OpenAI 互換のチャットプロバイダーと音声メディア理解プロバイダーの両方を登録します。
プロパティ
プロバイダーIDgroq
Plugin公式外部パッケージ
認証 env varGROQ_API_KEY
APIOpenAI 互換(openai-completions
ベースURLhttps://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

はじめに

1

API キーを取得

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

API キーを設定

export GROQ_API_KEY=gsk_...
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 は、推論ありと推論なしのエントリを含む、manifest ベースの Groq カタログを同梱しています。インストール済みバージョンの静的な行を確認するには openclaw models list --provider groq を実行し、Groq の公式リストを確認するには console.groq.com/docs/models を参照してください。
モデル参照名前推論入力コンテキスト
groq/llama-3.3-70b-versatileLlama 3.3 70B Versatileなしテキスト131,072
groq/llama-3.1-8b-instantLlama 3.1 8B Instantなしテキスト131,072
groq/meta-llama/llama-4-scout-17b-16e-instructLlama 4 Scout 17Bなしテキスト + 画像131,072
groq/openai/gpt-oss-120bGPT OSS 120Bありテキスト131,072
groq/openai/gpt-oss-20bGPT OSS 20Bありテキスト131,072
groq/openai/gpt-oss-safeguard-20bSafety GPT OSS 20Bありテキスト131,072
groq/qwen/qwen3-32bQwen3 32Bありテキスト131,072
groq/groq/compoundCompoundありテキスト131,072
groq/groq/compound-miniCompound Miniありテキスト131,072
カタログは OpenClaw の各リリースで進化します。openclaw models list --provider groq は、インストール済みバージョンが認識している行を表示します。新しく追加されたモデルや非推奨になったモデルについては、console.groq.com/docs/models と照合してください。

推論モデル

Groq の推論モデル(上の表で reasoning: true)は、OpenClaw の共有 /think レベルを lowmediumhighreasoning_effort 値にマッピングします。/think off または /think none は、無効化された値を送信するのではなく、リクエストから reasoning_effort を省略します。 共有 /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 は対話型シェルだけでなく、そのプロセスからも見えている必要があります。
対話型シェルでのみ export されたキーは、その環境もそこに取り込まれていない限り、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 ドキュメント、価格。