跳轉到主要內容

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 內建 Groq Plugin，會註冊 OpenAI 相容的聊天提供者與音訊媒體理解提供者。
屬性值
提供者 idgroq
Plugin內建，enabledByDefault: true
驗證環境變數GROQ_API_KEY
Onboarding 旗標--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 隨附以 manifest 支援的 Groq 目錄，包含推理與非推理項目。執行 openclaw models list --provider groq 查看你安裝版本內建的列，或查看 console.groq.com/docs/models 取得 Groq 的權威清單。
模型參照名稱推理輸入上下文
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-maverick-17b-128e-instructLlama 4 Maverick 17B否文字 + 圖片131,072
groq/meta-llama/llama-4-scout-17b-16e-instructLlama 4 Scout 17B否文字 + 圖片131,072
groq/llama3-70b-8192Llama 3 70B否文字8,192
groq/llama3-8b-8192Llama 3 8B否文字8,192
groq/gemma2-9b-itGemma 2 9B否文字8,192
groq/mistral-saba-24bMistral Saba 24B否文字32,768
groq/moonshotai/kimi-k2-instructKimi K2 Instruct否文字131,072
groq/moonshotai/kimi-k2-instruct-0905Kimi K2 Instruct 0905否文字262,144
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-qwq-32bQwen QwQ 32B是文字131,072
groq/qwen/qwen3-32bQwen3 32B是文字131,072
groq/deepseek-r1-distill-llama-70bDeepSeek R1 Distill Llama 70B是文字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 交叉比對。

​
推理模型

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
預設基礎 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 必須對該行程可見，而不只是對你的互動式 shell 可見。
只存在於 ~/.profile 的金鑰無法幫助 launchd 或 systemd daemon，除非該環境也匯入到那裡。請在 ~/.openclaw/.env 中設定金鑰，或透過 env.shellEnv 設定，讓 Gateway 行程可以讀取。
OpenClaw 在執行階段接受任何 Groq 模型 id。使用 Groq 顯示的確切 id，並加上 groq/ 前綴。內建目錄涵蓋常見情境；未收錄於目錄的 id 會退回使用預設的 OpenAI 相容範本。
{
  agents: {
    defaults: {
      model: { primary: "groq/<your-model-id>" },
    },
  },
}

​
相關內容

模型提供者

選擇提供者、模型參照與故障轉移行為。

思考模式

推理投入等級與提供者政策互動。

設定參考

完整設定 schema，包含提供者與音訊設定。

Groq Console

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