快速开始
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 级别映射到 low、medium 或 high 的 reasoning_effort 值。使用 /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>" }, }, },}