Skip to main content
Groq 使用自定义 LPU 硬件，为开放权重模型（Llama、Gemma、Kimi、Qwen、GPT OSS 等）提供超高速推理。Groq 插件同时注册 OpenAI 兼容的聊天提供商和音频媒体理解提供商。
属性值
提供商 IDgroq
插件官方外部软件包
凭证环境变量GROQ_API_KEY
APIOpenAI 兼容（openai-completions）
基础 URLhttps://api.groq.com/openai/v1
音频转录whisper-large-v3-turbo（默认）
推荐聊天默认值groq/llama-3.3-70b-versatile

​
安装插件

安装官方插件，然后重启 Gateway 网关： 
openclaw plugins install @openclaw/groq-provider
openclaw gateway restart

​
入门指南

1

获取 API key

在 console.groq.com/keys 创建 API key。
2

设置 API key

export GROQ_API_KEY=gsk_...
3

设置默认模型

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

验证目录可访问

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-versatileLlama 3.3 70B Versatile否文本131,072
groq/llama-3.1-8b-instantLlama 3.1 8B Instant否文本131,072
groq/meta-llama/llama-4-scout-17b-16e-instructLlama 4 Scout 17B否文本 + 图像131,072
groq/openai/gpt-oss-120bGPT OSS 120B是文本131,072
groq/openai/gpt-oss-20bGPT OSS 20B是文本131,072
groq/openai/gpt-oss-safeguard-20bSafety GPT OSS 20B是文本131,072
groq/qwen/qwen3-32bQwen3 32B是文本131,072
groq/groq/compoundCompound是文本131,072
groq/groq/compound-miniCompound Mini是文本131,072
目录会随每个 OpenClaw 版本演进。openclaw models list --provider groq 会显示你已安装版本已知的行；请与 console.groq.com/docs/models 交叉核对新添加或已弃用的模型。

​
推理模型

Groq 推理模型（上表中的 reasoning: true）会将 OpenClaw 共享的 /think 级别映射到 low、medium 或 high 的 reasoning_effort 值。/think off 或 /think none 会在请求中省略 reasoning_effort，而不是发送禁用值。 参见 Thinking modes，了解共享的 /think 级别以及 OpenClaw 如何按提供商转换它们。

​
音频转录

Groq 的插件还会注册一个音频媒体理解提供商，以便语音消息可以通过共享的 tools.media.audio 表面进行转录。
属性值
共享配置路径tools.media.audio
默认基础 URLhttps://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 可见。
仅在交互式 shell 中导出的密钥无法帮助 launchd 或 systemd 守护进程，除非该环境也被导入到那里。请在 ~/.openclaw/.env 中或通过 env.shellEnv 设置密钥，使 Gateway 网关进程可以读取它。
OpenClaw 在运行时接受任何 Groq 模型 ID。使用 Groq 显示的确切 ID，并为其加上 groq/ 前缀。静态目录覆盖常见情况；未编入目录的 ID 会回退到默认的 OpenAI 兼容模板。
{
  agents: {
    defaults: {
      model: { primary: "groq/<your-model-id>" },
    },
  },
}

​
相关

模型提供商

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

Thinking modes

推理强度级别和提供商策略交互。

配置参考

完整配置 schema，包括提供商和音频设置。

Groq Console

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