Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

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

​
入门指南

1

获取 API key

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

设置 API key

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-maverick-17b-128e-instructLlama 4 Maverick 17B否文本 + 图像131,072
groq/meta-llama/llama-4-scout-17b-16e-instructLlama 4 Scout 17B否文本 + 图像131,072
groq/llama3-70b-8192Llama 3 70B否文本8,192
groq/llama3-8b-8192Llama 3 8B否文本8,192
groq/gemma2-9b-itGemma 2 9B否文本8,192
groq/mistral-saba-24bMistral Saba 24B否文本32,768
groq/moonshotai/kimi-k2-instructKimi K2 Instruct否文本131,072
groq/moonshotai/kimi-k2-instruct-0905Kimi K2 Instruct 0905否文本262,144
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-qwq-32bQwen QwQ 32B是文本131,072
groq/qwen/qwen3-32bQwen3 32B是文本131,072
groq/deepseek-r1-distill-llama-70bDeepSeek R1 Distill Llama 70B是文本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 控制可见性，但模型始终会进行推理。
请参阅 Thinking modes，了解共享的 /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 可见。
仅放在 ~/.profile 中的 key 无法帮助 launchd 或 systemd 守护进程，除非该环境也导入到那里。请在 ~/.openclaw/.env 中设置 key，或通过 env.shellEnv 设置，使 Gateway 网关进程可以读取它。
OpenClaw 在运行时接受任何 Groq 模型 ID。使用 Groq 显示的确切 ID，并加上 groq/ 前缀。内置目录覆盖常见情况；未编入目录的 ID 会回退到默认的 OpenAI 兼容模板。
{
  agents: {
    defaults: {
      model: { primary: "groq/<your-model-id>" },
    },
  },
}

​
相关

模型提供商

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

Thinking modes

推理强度级别和提供商策略交互。

配置参考

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

Groq Console

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