Providers
Groq
Groq 使用自訂 LPU 硬體,為開放權重模型(Llama、Gemma、Kimi、Qwen、GPT OSS 等)提供超快速推論。OpenClaw 內建 Groq Plugin,會註冊 OpenAI 相容的聊天提供者與音訊媒體理解提供者。
| 屬性 | 值 |
|---|---|
| 提供者 id | groq |
| Plugin | 內建,enabledByDefault: true |
| 驗證環境變數 | GROQ_API_KEY |
| Onboarding 旗標 | --auth-choice groq-api-key |
| API | OpenAI 相容 (openai-completions) |
| 基礎 URL | https://api.groq.com/openai/v1 |
| 音訊轉錄 | whisper-large-v3-turbo(預設) |
| 建議的聊天預設值 | groq/llama-3.3-70b-versatile |
開始使用
取得 API 金鑰
在 console.groq.com/keys 建立 API 金鑰。
設定 API 金鑰
openclaw onboard --auth-choice groq-api-key
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 隨附以 manifest 支援的 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-maverick-17b-128e-instruct |
Llama 4 Maverick 17B | 否 | 文字 + 圖片 | 131,072 |
groq/meta-llama/llama-4-scout-17b-16e-instruct |
Llama 4 Scout 17B | 否 | 文字 + 圖片 | 131,072 |
groq/llama3-70b-8192 |
Llama 3 70B | 否 | 文字 | 8,192 |
groq/llama3-8b-8192 |
Llama 3 8B | 否 | 文字 | 8,192 |
groq/gemma2-9b-it |
Gemma 2 9B | 否 | 文字 | 8,192 |
groq/mistral-saba-24b |
Mistral Saba 24B | 否 | 文字 | 32,768 |
groq/moonshotai/kimi-k2-instruct |
Kimi K2 Instruct | 否 | 文字 | 131,072 |
groq/moonshotai/kimi-k2-instruct-0905 |
Kimi K2 Instruct 0905 | 否 | 文字 | 262,144 |
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-qwq-32b |
Qwen QwQ 32B | 是 | 文字 | 131,072 |
groq/qwen/qwen3-32b |
Qwen3 32B | 是 | 文字 | 131,072 |
groq/deepseek-r1-distill-llama-70b |
DeepSeek R1 Distill Llama 70B | 是 | 文字 | 131,072 |
groq/groq/compound |
Compound | 是 | 文字 | 131,072 |
groq/groq/compound-mini |
Compound Mini | 是 | 文字 | 131,072 |
推理模型
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 |
| 預設基礎 URL | https://api.groq.com/openai/v1 |
| 預設模型 | whisper-large-v3-turbo |
| 自動優先順序 | 20 |
| API 端點 | OpenAI 相容 /audio/transcriptions |
若要將 Groq 設為預設音訊後端:
{
tools: {
media: {
audio: {
models: [{ provider: "groq" }],
},
},
},
}
daemon 的環境可用性
如果 Gateway 以受管理服務(launchd、systemd、Docker)執行,GROQ_API_KEY 必須對該行程可見,而不只是對你的互動式 shell 可見。
自訂 Groq 模型 id
OpenClaw 在執行階段接受任何 Groq 模型 id。使用 Groq 顯示的確切 id,並加上 groq/ 前綴。內建目錄涵蓋常見情境;未收錄於目錄的 id 會退回使用預設的 OpenAI 相容範本。
{
agents: {
defaults: {
model: { primary: "groq/<your-model-id>" },
},
},
}