Chuyển đến nội dung chính
Groq cung cấp suy luận siêu nhanh trên các mô hình open-weight (Llama, Gemma, Kimi, Qwen, GPT OSS, và nhiều mô hình khác) bằng phần cứng LPU tùy chỉnh. Plugin Groq đăng ký cả nhà cung cấp trò chuyện tương thích với OpenAI và nhà cung cấp hiểu phương tiện âm thanh.
Thuộc tínhGiá trị
ID nhà cung cấpgroq
Plugingói bên ngoài chính thức
Biến môi trường xác thựcGROQ_API_KEY
APItương thích với OpenAI (openai-completions)
URL cơ sởhttps://api.groq.com/openai/v1
Phiên âm âm thanhwhisper-large-v3-turbo (mặc định)
Mặc định trò chuyện được đề xuấtgroq/llama-3.3-70b-versatile

​
Cài đặt Plugin

Cài đặt Plugin chính thức, sau đó khởi động lại Gateway: 
openclaw plugins install @openclaw/groq-provider
openclaw gateway restart

​
Bắt đầu

1

Get an API key

Tạo một khóa API tại console.groq.com/keys.
2

Set the API key

export GROQ_API_KEY=gsk_...
3

Set a default model

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

Verify the catalog is reachable

openclaw models list --provider groq

​
Ví dụ tệp cấu hình

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

​
Danh mục tích hợp sẵn

OpenClaw cung cấp danh mục Groq dựa trên manifest với cả các mục có suy luận và không suy luận. Chạy openclaw models list --provider groq để xem các hàng tĩnh cho phiên bản đã cài đặt của bạn, hoặc kiểm tra console.groq.com/docs/models để xem danh sách chính thức của Groq.
Tham chiếu mô hìnhTênSuy luậnĐầu vàoNgữ cảnh
groq/llama-3.3-70b-versatileLlama 3.3 70B Versatilekhôngvăn bản131,072
groq/llama-3.1-8b-instantLlama 3.1 8B Instantkhôngvăn bản131,072
groq/meta-llama/llama-4-scout-17b-16e-instructLlama 4 Scout 17Bkhôngvăn bản + hình ảnh131,072
groq/openai/gpt-oss-120bGPT OSS 120Bcóvăn bản131,072
groq/openai/gpt-oss-20bGPT OSS 20Bcóvăn bản131,072
groq/openai/gpt-oss-safeguard-20bSafety GPT OSS 20Bcóvăn bản131,072
groq/qwen/qwen3-32bQwen3 32Bcóvăn bản131,072
groq/groq/compoundCompoundcóvăn bản131,072
groq/groq/compound-miniCompound Minicóvăn bản131,072
Danh mục phát triển theo từng bản phát hành OpenClaw. openclaw models list --provider groq hiển thị các hàng mà phiên bản đã cài đặt của bạn biết đến; đối chiếu với console.groq.com/docs/models để xem các mô hình mới được thêm hoặc đã ngừng dùng.

​
Mô hình suy luận

OpenClaw ánh xạ các mức /think dùng chung của mình sang các giá trị reasoning_effort dành riêng cho mô hình của Groq:
  • Với qwen/qwen3-32b, tắt suy nghĩ sẽ gửi none và bật suy nghĩ sẽ gửi default.
  • Với các mô hình suy luận Groq GPT OSS (openai/gpt-oss-*), OpenClaw gửi low, medium, hoặc high dựa trên mức /think. Tắt suy nghĩ sẽ bỏ qua reasoning_effort vì các mô hình đó không hỗ trợ giá trị tắt.
  • DeepSeek R1 Distill, Qwen QwQ, và Compound sử dụng bề mặt suy luận gốc của Groq; /think kiểm soát khả năng hiển thị nhưng mô hình luôn suy luận.
Xem Chế độ suy nghĩ để biết các mức /think dùng chung và cách OpenClaw chuyển đổi chúng theo từng nhà cung cấp.

​
Phiên âm âm thanh

Plugin của Groq cũng đăng ký một nhà cung cấp hiểu phương tiện âm thanh để có thể phiên âm tin nhắn thoại thông qua bề mặt tools.media.audio dùng chung.
Thuộc tínhGiá trị
Đường dẫn cấu hình dùng chungtools.media.audio
URL cơ sở mặc địnhhttps://api.groq.com/openai/v1
Mô hình mặc địnhwhisper-large-v3-turbo
Độ ưu tiên tự động20
Điểm cuối API/audio/transcriptions tương thích với OpenAI
Để đặt Groq làm backend âm thanh mặc định: 
{
  tools: {
    media: {
      audio: {
        models: [{ provider: "groq" }],
      },
    },
  },
}
Nếu Gateway chạy dưới dạng dịch vụ được quản lý (launchd, systemd, Docker), GROQ_API_KEY phải hiển thị với tiến trình đó, không chỉ với shell tương tác của bạn.
Khóa chỉ được export trong shell tương tác sẽ không giúp ích cho daemon launchd hoặc systemd trừ khi môi trường đó cũng được nhập vào đó. Đặt khóa trong ~/.openclaw/.env hoặc qua env.shellEnv để tiến trình Gateway có thể đọc được.
OpenClaw chấp nhận bất kỳ ID mô hình Groq nào tại runtime. Dùng đúng ID mà Groq hiển thị và thêm tiền tố groq/. Danh mục tĩnh bao phủ các trường hợp phổ biến; các ID không có trong danh mục sẽ dùng mẫu tương thích với OpenAI mặc định.
{
  agents: {
    defaults: {
      model: { primary: "groq/<your-model-id>" },
    },
  },
}

​
Liên quan

Model providers

Chọn nhà cung cấp, tham chiếu mô hình, và hành vi chuyển đổi dự phòng.

Thinking modes

Các mức nỗ lực suy luận và tương tác với chính sách nhà cung cấp.

Configuration reference

Sơ đồ cấu hình đầy đủ bao gồm thiết lập nhà cung cấp và âm thanh.

Groq Console

Bảng điều khiển Groq, tài liệu API, và giá.