Groq

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

# 入门指南

openclaw onboard --auth-choice groq-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 的权威列表。

# 推理模型

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 控制可见性，但模型始终会进行推理。

请参阅 Thinking modes，了解共享的 /think 级别以及 OpenClaw 如何按提供商转换它们。

# 音频转录

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

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

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

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

# 相关