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/openai/gpt-oss-120b`

安装插件

安装官方插件，然后重启 Gateway：

openclaw plugins install @openclaw/groq-provider
openclaw gateway restart

入门

获取 API 密钥

在 console.groq.com/keys 创建 API 密钥。

设置 API 密钥

export GROQ_API_KEY=gsk_...

设置默认模型

{
  agents: {
    defaults: {
      model: { primary: "groq/openai/gpt-oss-120b" },
    },
  },
}

验证目录是否可访问

openclaw models list --provider groq

配置文件示例

{
  env: { vars: { GROQ_API_KEY: "gsk_..." } },
  agents: {
    defaults: {
      model: { primary: "groq/openai/gpt-oss-120b" },
    },
  },
}

内置目录

OpenClaw 会随附一个由清单支持的 Groq 目录，其中既包含推理模型，也包含非推理模型。运行 openclaw models list --provider groq 可查看你已安装版本的静态条目，或查看 console.groq.com/docs/models 获取 Groq 的权威列表。

模型引用	名称	推理	输入	上下文
`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.6-27b`	Qwen 3.6 27B	是	文本 + 图像	131,072
`groq/groq/compound`	Compound	否	文本	131,072
`groq/groq/compound-mini`	Compound Mini	否	文本	131,072

清单还会保留 groq/llama-3.1-8b-instant 和 groq/llama-3.3-70b-versatile 这两个隐藏的已弃用兼容条目，直到 Groq 于 2026 年 8 月 16 日关闭这些模型。对于新的配置，请分别使用 groq/openai/gpt-oss-20b 和 groq/openai/gpt-oss-120b。

目录会随着每个 OpenClaw 版本演进。openclaw models list --provider groq 会显示你已安装版本已知的条目；请与 console.groq.com/docs/models 交叉核对新添加或已弃用的模型。

推理模型

Groq 推理模型（上表中的 reasoning: true）将 OpenClaw 共享的 /think 等级映射为 reasoning_effort 的 low、medium 或 high 值。/think off 或 /think none 会从请求中省略 reasoning_effort，而不是发送一个禁用值。有关共享的 /think 等级以及 OpenClaw 如何针对每个提供方进行转换，请参阅思考模式。

音频转录

Groq 插件还会注册一个 音频媒体理解提供方，因此语音消息可以通过共享的 tools.media.audio 接口进行转录。

属性	值
共享模型路径	`tools.media.models`
默认基础 URL	`https://api.groq.com/openai/v1`
默认模型	`whisper-large-v3-turbo`
自动优先级	20
API 端点	OpenAI 兼容的 `/audio/transcriptions`

要将 Groq 设为默认音频后端：

{
  tools: {
    media: {
      models: [{ provider: "groq", capabilities: ["audio"] }],
    },
  },
}

守护进程的环境可用性

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

仅在交互式 shell 中导出的密钥对 launchd 或 systemd 守护进程没有帮助，除非该环境也被导入到那里。将密钥设置在 ~/.openclaw/.env 中或通过 env.shellEnv 设置，以便网关进程可以读取。

自定义 Groq 模型 id

OpenClaw 在运行时接受任意 Groq 模型 id。请使用 Groq 显示的精确 id，并在前面加上 groq/。静态目录覆盖常见情况；未收录的 id 会回退到默认的兼容 OpenAI 模板。

{
  agents: {
    defaults: {
      model: { primary: "groq/<your-model-id>" },
    },
  },
}

模型提供方

选择提供方、模型引用和故障转移行为。

思考模式

推理努力级别和提供方策略交互。

配置参考

完整配置架构，包括提供方和音频设置。

Groq 控制台

Groq 仪表板、API 文档和定价。

概览

概念与配置

提供商

安装插件

入门

配置文件示例

内置目录

推理模型

音频转录

相关内容

模型提供方

思考模式

配置参考

Groq 控制台

​安装插件

​入门

​配置文件示例

​内置目录

​推理模型

​音频转录

​相关内容

模型提供方

思考模式

配置参考

Groq 控制台

安装插件

入门

配置文件示例

内置目录

推理模型

音频转录

相关内容