OpenClaw Groq 提供商配置指南

Groq 借助定制化的 LPU 硬件，为开源模型（Llama、Gemma、Mistral 等）提供超高速推理能力。OpenClaw 通过其兼容 OpenAI 的 API 接入 Groq 服务。

• 提供商标识：groq
• 鉴权方式：GROQ_API_KEY
• API 类型：兼容 OpenAI

快速开始

1. 从 console.groq.com/keys 获取 API 密钥。
2. 设置 API 密钥：

export GROQ_API_KEY="gsk_..."

1. 设置默认模型：

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

配置文件示例

{
  env: { GROQ_API_KEY: "gsk_..." },
  agents: {
    defaults: {
      model: { primary: "groq / llama-3.3-70b-versatile" },
    },
  },
}

音频转录

Groq 还提供基于 Whisper 的高速音频转录能力。当配置为媒体理解提供商时，OpenClaw 会使用 Groq 的 whisper-large-v3-turbo 模型来转录语音消息。

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

环境说明

如果网关以守护进程（launchd/systemd）的方式运行，请确保 GROQ_API_KEY 对该进程可见（例如，放在 ~/.openclaw/.env 中，或是通过 env.shellEnv 配置）。

可用模型

Groq 的模型目录会频繁更新。你可以运行 openclaw models list | grep groq 查看当前可用的模型，或是查看 console.groq.com/docs/models。 热门选择包括：

• Llama 3.3 70B Versatile — 通用型，大上下文窗口
• Llama 3.1 8B Instant — 高速，轻量级
• Gemma 2 9B — 紧凑，高效
• Mixtral 8x7B — MoE 架构，推理能力出色

相关链接

• Groq 控制台
• API 文档
• 模型列表
• 定价