Groq

Groq 使用自定义 LPU 硬件，为开放权重模型（Llama、Gemma、Kimi、Qwen、GPT OSS 等）提供超快推理。Groq 插件同时注册了一个 OpenAI 兼容的聊天提供商和一个音频媒体理解提供商。

安装插件¶

安装官方插件：

openclaw plugins install @openclaw/groq-provider

安装会自动应用于正在运行的 Gateway；否则将在下次启动时生效。参见应用更改并检查。

快速开始¶

1. 获取 API 密钥

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

2. 设置 API 密钥

export GROQ_API_KEY=gsk_...

3. 设置默认模型

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

4. 验证目录可访问

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 于 2026 年 8 月 16 日停用后，清单仍保留 groq/llama-3.1-8b-instant 和 groq/llama-3.3-70b-versatile 作为隐藏的已弃用兼容性行。对于新配置，请分别使用 groq/openai/gpt-oss-20b 和 groq/openai/gpt-oss-120b。

推理模型¶

Groq 推理模型（上表中 reasoning: true）将 OpenClaw 共享的 /think 级别映射到 reasoning_effort 值 low、medium 或 high。/think off 或 /think none 会从请求中省略 reasoning_effort，而不是发送禁用值。

有关共享的 /think 级别以及 OpenClaw 如何按提供商转换它们，请参阅思考模式。

音频转录¶

Groq 插件还注册了一个音频媒体理解提供商，以便通过共享的 tools.media.audio 接口转录语音消息。

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

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

如果 Gateway 作为托管服务（launchd、systemd、Docker）运行，`GROQ_API_KEY` 必须对该进程可见——而不仅仅对你的交互式 shell 可见。

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

相关¶

模型提供商

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

思考模式

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

配置参考

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

Groq Console

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