提供商
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 |
安装插件
安装官方插件，然后重启 Gateway 网关：
openclaw plugins install @openclaw/groq-provideropenclaw gateway restart入门指南
获取 API key
在 console.groq.com/keys 创建 API key。
设置 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 随附一个由清单支持的 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 |
推理模型
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" }], }, }, },}守护进程的环境可用性
如果 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>" }, }, },}