本页内容
本页内容
供应商
Groq
Groq 使用自定义功能对开放权重模型(Llama、Gemma、Kimi、Qwen、GPT OSS 等)提供超快速推理LPU 硬件。 Groq 插件注册了 OpenAI- 兼容的聊天提供程序和音频媒体理解提供程序。
| 属性 | 值 |
|---|---|
| 提供方 id | groq |
| 插件 | 官方外部包 |
| 认证环境变量 | GROQ_API_KEY |
| API | OpenAI-兼容(openai-completions) |
| 基础 URL | https://api.groq.com/openai/v1 |
| 音频转录 | whisper-large-v3-turbo(默认) |
| 建议的聊天默认模型 | groq/openai/gpt-oss-120b |
安装插件
安装官方插件:
安装自动应用于正在运行的网关;否则下次启动时生效。请参阅 应用更改并检查 。
入门
配置文件示例
内置目录
OpenClaw 提供了清单支持的 Groq 推理模型目录。运行 openclaw models list --provider groq 查看您安装的版本的静态行,或检查 console.groq.com/docs/models 以获取 Groq 的权威列表。
| 模型引用 | 名称 | 推理 | 输入 | 上下文 |
|---|---|---|---|---|
groq/openai/gpt-oss-120b |
GPT OSS 120B | 是 | 文本 | 131,072 |
groq/openai/gpt-oss-20b |
GPT OSS 20B | 是 | 文本 | 131,072 |
groq/openai/gpt-oss-safeguard-20b |
安全 GPT OSS 20B | 是 | 文本 | 131,072 |
groq/qwen/qwen3.6-27b |
Qwen 3.6 27B | 是 | 文本 | 131,072 |
推理模型
Groq 的 GPT OSS 推理模型将 OpenClaw 的共享 /think 级别映射到 low、medium 或 high 的 reasoning_effort 值。 /think off 或 /think none 从这些请求中省略 reasoning_effort,而不是发送禁用值。
Qwen 3.6 27B 在 Groq 上仅是文本,并支持两种线推理模式。 /think off 或 /think none 发送 reasoning_effort: "none";每个启用的级别都会发送 "default"。当在 Groq Qwen 模型上启用推理时,OpenClaw 会请求 reasoning_format: "parsed",以便推理保留在思维块中,而不是可见的答案文本。此格式挂钩保持禁用推理和 GPT OSS 请求不变。
有关共享的 /think 等级以及 OpenClaw 如何针对每个提供方进行转换,请参阅 思考模式。
音频转录
Groq 插件还会注册一个 音频媒体理解提供方,因此语音消息可以通过共享的 tools.media.audio 接口进行转录。
| 属性 | 值 |
|---|---|
| 共享模型路径 | tools.media.models |
| 默认基础 URL | https://api.groq.com/openai/v1 |
| 默认模型 | whisper-large-v3-turbo |
| 自动优先级 | 20 |
| API 端点 | OpenAI-兼容/audio/transcriptions |
要将 Groq 设为默认音频后端:
守护进程的环境可用性
如果网关作为受管服务运行(launchd、systemd、Docker),GROQ_API_KEY 必须对该进程可见——而不只是对你的交互式 shell 可见。
自定义 Groq 模型 ID
OpenClaw 在运行时接受任何 Groq 模型 ID。使用 Groq 显示的确切 ID 并添加 groq/ 前缀。静态目录涵盖了常见情况;未编目的 ID 会进入默认的 OpenAI- 兼容模板。