Groq

Groq 使用定制的 LPU 硬件，在开源权重模型（Llama、Gemma、Kimi、Qwen、GPT OSS 等）上提供超快的推理。OpenClaw 包含一个捆绑的 Groq 插件，该插件注册了一个兼容 OpenAI 的聊天提供商和一个音频媒体理解提供商。

属性	值
提供商 ID	`groq`
插件	捆绑，`enabledByDefault: true`
身份验证环境变量	`GROQ_API_KEY`
入门引导标志	`--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 密钥

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

export GROQ_API_KEY=gsk_...

Set a default model

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

Verify the catalog is reachable
Terminal window
```
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-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 的捆绑插件还注册了一个 audio media-understanding 提供商，以便可以通过共享的 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" }],
      },
    },
  },
}

Environment availability for the daemon

如果 Gateway(网关) 作为托管服务（launchd、systemd、Docker）运行，GROQ_API_KEY 对该进程必须可见——而不仅仅是对您的交互式 shell 可见。

Custom Groq 模型 ids

OpenClaw 在运行时接受任何 Groq 模型 ID。请使用 Groq 显示的确切 ID，并为其加上 groq/ 前缀。捆绑的目录涵盖了常见情况；未编目的 ID 会回退到默认的 OpenAI 兼容模板。

{
  agents: {
    defaults: {
      model: { primary: "groq/

” }, }, }, } ```