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-scout-17b-16e-instruct`	Llama 4 Scout 17B	否	文本 + 图像	131,072
`groq/openai/gpt-oss-120b`	GPT OSS 120B	yes	text	131,072
`groq/openai/gpt-oss-20b`	GPT OSS 20B	yes	文本	131,072
`groq/openai/gpt-oss-safeguard-20b`	Safety GPT OSS 20B	yes	文本	131,072
`groq/qwen/qwen3-32b`	Qwen3 32B	yes	文本	131,072
`groq/groq/compound`	Compound	yes	文本	131,072
`groq/groq/compound-mini`	Compound Mini	yes	文本	131,072

OpenClaw 将其共享的 /think 级别映射到 Groq 特定于模型的 reasoning_effort 值：

对于 qwen/qwen3-32b，禁用思考会发送 none，启用思考会发送 default。
对于 Groq GPT OSS 推理模型（openai/gpt-oss-*OpenClaw），OpenClaw 会根据 /think 级别发送 low、medium 或 high。禁用思考会省略 reasoning_effort，因为这些模型不支持禁用值。
DeepSeek R1 Distill、Qwen QwQ 和 Compound 使用 Groq 的原生推理表面；Qwen/think 控制可见性，但模型始终在进行推理。

请参阅 Thinking modes 了解共享的 /thinkOpenClaw 级别以及 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 兼容的 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/OpenAI 前缀。捆绑的目录涵盖了常见情况；未编录的 ID 会回退到默认的 OpenAI 兼容模板。

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

” }, }, }, } ```