快速开始
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，而不是发送禁用值。
参见 Thinking modes，了解共享的 /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>" }, }, },}