Skip to main content
Groq 使用自定义 LPU 硬件，在开放权重模型（Llama、Gemma、Kimi、Qwen、GPT OSS 等）上提供超快推理。OpenClaw 包含一个内置的 Groq 插件，注册了一个兼容 OpenAI 的聊天提供方和一个音频媒体理解提供方。
属性值
提供方 IDgroq
插件内置，enabledByDefault: true
认证环境变量GROQ_API_KEY
上手标志--auth-choice groq-api-key
API兼容 OpenAI（openai-completions）
基础 URLhttps://api.groq.com/openai/v1
音频转录whisper-large-v3-turbo（默认）
建议的聊天默认值groq/llama-3.3-70b-versatile

​
开始使用

1

获取 API 密钥

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

设置 API 密钥

openclaw onboard --auth-choice groq-api-key
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 交叉核对新添加或已弃用的模型。

​
推理模型

OpenClaw 会将其共享的 /think 等级映射到 Groq 各模型特定的 reasoning_effort 值：
  • 对于 qwen/qwen3-32b，禁用思考会发送 none，启用思考会发送 default。
  • 对于 Groq GPT OSS 推理模型（openai/gpt-oss-*），OpenClaw 会根据 /think 等级发送 low、medium 或 high。禁用思考时会省略 reasoning_effort，因为这些模型不支持禁用值。
  • DeepSeek R1 Distill、Qwen QwQ 和 Compound 使用 Groq 的原生推理接口；/think 只控制可见性，但模型始终会进行推理。
有关共享的 /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 设置，以便网关进程可以读取。
OpenClaw 在运行时接受任何 Groq 模型 id。使用 Groq 显示的精确 id，并在前面加上 groq/。内置目录覆盖常见场景；未收录的 id 会回退到默认的兼容 OpenAI 模板。
{
  agents: {
    defaults: {
      model: { primary: "groq/<your-model-id>" },
    },
  },
}

​
相关内容

模型提供方

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

思考模式

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

配置参考

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

Groq 控制台

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