Groq

Groq 使用自訂 LPU 硬體，為開放權重模型（Llama、Gemma、Kimi、Qwen、GPT OSS 等）提供超高速推論。Groq 外掛會同時註冊一個與 OpenAI 相容的聊天提供者，以及一個音訊媒體理解提供者。

屬性	值
提供者 ID	groq
外掛	官方外部套件
驗證環境變數	GROQ_API_KEY
API	與 OpenAI 相容（openai-completions）
基底 URL	https://api.groq.com/openai/v1
音訊轉錄	whisper-large-v3-turbo（預設）
建議的預設聊天模型	groq/llama-3.3-70b-versatile

​

安裝外掛

安裝官方外掛，然後重新啟動閘道：

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 隨附以資訊清單為基礎的 Groq 目錄，其中包含推理與非推理項目。執行 openclaw models list --provider groq 可查看已安裝版本的靜態項目，或查看 console.groq.com/docs/models 以取得 Groq 的權威清單。

模型參照	名稱	推理	輸入	上下文
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 版本演進。openclaw models list --provider groq 會顯示已安裝版本已知的項目；請與 console.groq.com/docs/models 交叉核對，以確認新增或已棄用的模型。

​

推理模型

Groq 推理模型（上表中的 reasoning: true）會將 OpenClaw 共用的 /think 等級對應至 reasoning_effort 的 low、medium 或 high 值。/think off 或 /think none 會從請求中省略 reasoning_effort，而不是傳送停用值。

請參閱思考模式，了解共用的 /think 等級，以及 OpenClaw 如何針對各提供者轉換這些等級。

​

音訊轉錄

Groq 外掛也會註冊一個音訊媒體理解提供者，讓語音訊息可透過共用的 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" }],
      },
    },
  },
}

常駐程式的環境可用性

如果閘道以受管理的服務執行（launchd、systemd、Docker），該程序必須能看見 GROQ_API_KEY，而不能只讓你的互動式 shell 看見。

除非也將該環境匯入 launchd 或 systemd，否則僅在互動式 shell 中匯出的金鑰無法供其常駐程式使用。請在 ~/.openclaw/.env 中或透過 env.shellEnv 設定金鑰，讓閘道程序可以讀取。

自訂 Groq 模型 ID

OpenClaw 在執行階段接受任何 Groq 模型 ID。請使用 Groq 顯示的確切 ID，並在前面加上 groq/。靜態目錄涵蓋常見情況；未列入目錄的 ID 會改用預設的 OpenAI 相容範本。

{
  agents: {
    defaults: {
      model: { primary: "groq/<your-model-id>" },
    },
  },
}

​

相關內容

模型提供者

選擇提供者、模型參照和容錯移轉行為。

思考模式

推理投入程度以及與提供者政策的互動。

設定參考

完整的設定結構描述，包括提供者和音訊設定。

Groq Console

Groq 儀表板、API 文件和定價。