Chuyển đến nội dung chính

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 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. OpenClaw bao gồm một Plugin Groq được đóng gói kèm, đăng ký cả nhà cung cấp trò chuyện tương thích OpenAI và nhà cung cấp hiểu phương tiện âm thanh.
Thuộc tínhGiá trị
ID nhà cung cấpgroq
Pluginđược đóng gói kèm, enabledByDefault: true
Biến môi trường xác thựcGROQ_API_KEY
Cờ thiết lập ban đầu--auth-choice groq-api-key
APItương thích 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

Bắt đầu

1

Lấy khóa API

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

Thiết lập khóa API

openclaw onboard --auth-choice groq-api-key
3

Thiết lập mô hình mặc định

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

Xác minh catalog có thể truy cập

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" },
    },
  },
}

Catalog tích hợp sẵn

OpenClaw phát hành kèm catalog 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 được đóng gói kèm cho phiên bản bạn đã cài đặt, hoặc kiểm tra console.groq.com/docs/models để xem danh sách có thẩm quyền 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-maverick-17b-128e-instructLlama 4 Maverick 17Bkhôngvăn bản + hình ảnh131,072
groq/meta-llama/llama-4-scout-17b-16e-instructLlama 4 Scout 17Bkhôngvăn bản + hình ảnh131,072
groq/llama3-70b-8192Llama 3 70Bkhôngvăn bản8,192
groq/llama3-8b-8192Llama 3 8Bkhôngvăn bản8,192
groq/gemma2-9b-itGemma 2 9Bkhôngvăn bản8,192
groq/mistral-saba-24bMistral Saba 24Bkhôngvăn bản32,768
groq/moonshotai/kimi-k2-instructKimi K2 Instructkhôngvăn bản131,072
groq/moonshotai/kimi-k2-instruct-0905Kimi K2 Instruct 0905khôngvăn bản262,144
groq/openai/gpt-oss-120bGPT OSS 120Bvăn bản131,072
groq/openai/gpt-oss-20bGPT OSS 20Bvăn bản131,072
groq/openai/gpt-oss-safeguard-20bSafety GPT OSS 20Bvăn bản131,072
groq/qwen-qwq-32bQwen QwQ 32Bvăn bản131,072
groq/qwen/qwen3-32bQwen3 32Bvăn bản131,072
groq/deepseek-r1-distill-llama-70bDeepSeek R1 Distill Llama 70Bvăn bản131,072
groq/groq/compoundCompoundvăn bản131,072
groq/groq/compound-miniCompound Minivăn bản131,072
Catalog 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; đố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 riêng theo mô hình của Groq:
  • Với qwen/qwen3-32b, suy nghĩ bị tắt sẽ gửi none và suy nghĩ được bật 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. Khi suy nghĩ bị tắt, reasoning_effort sẽ bị bỏ qua vì các mô hình đó không hỗ trợ giá trị tắt.
  • DeepSeek R1 Distill, Qwen QwQ và Compound 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 đóng gói kèm của Groq cũng đăng ký một nhà cung cấp hiểu phương tiện âm thanh để tin nhắn thoại có thể được phiên âm 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 APItương thích OpenAI /audio/transcriptions
Để đặt Groq làm backend âm thanh mặc định:
{
  tools: {
    media: {
      audio: {
        models: [{ provider: "groq" }],
      },
    },
  },
}
Nếu Gateway chạy như một 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.
Một khóa chỉ nằm trong ~/.profile sẽ không giúp 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 mọi ID mô hình Groq khi chạy. Dùng đúng ID do Groq hiển thị và thêm tiền tố groq/. Catalog được đóng gói kèm bao phủ các trường hợp phổ biến; các ID không có trong catalog sẽ rơi về mẫu tương thích OpenAI mặc định.
{
  agents: {
    defaults: {
      model: { primary: "groq/<your-model-id>" },
    },
  },
}

Liên quan

Nhà cung cấp mô hình

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

Chế độ suy nghĩ

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.

Tham chiếu cấu hình

Schema 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á.