OpenClawDocs
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

Providers

Groq

Groq cung cấp khả năng suy luận siêu nhanh trên các mô hình trọng số mở (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 nội dung phương tiện âm thanh.

Thuộc tính Giá trị
ID nhà cung cấp groq
Plugin gói bên ngoài chính thức
Biến môi trường xác thực GROQ_API_KEY
API tương thích với OpenAI (openai-completions)
URL cơ sở https://api.groq.com/openai/v1
Phiên âm âm thanh whisper-large-v3-turbo (mặc định)
Mô hình trò chuyện mặc định đề xuất groq/llama-3.3-70b-versatile

Cài đặt Plugin

Cài đặt Plugin chính thức, sau đó khởi động lại Gateway:

bash
openclaw plugins install @openclaw/groq-provideropenclaw gateway restart

Bắt đầu

  • Lấy khóa API

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

  • Đặt khóa API

    bash
    export GROQ_API_KEY=gsk_...

  • Đặt mô hình mặc định

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

  • Xác minh có thể truy cập danh mục

    bash
    openclaw models list --provider groq

    • Ví dụ về tệp cấu hình

    json5
    {  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 tệp kê khai, bao gồm 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 dà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 từ Groq.

    Tham chiếu mô hình Tên Suy luận Đầu vào Ngữ cảnh
    groq/llama-3.3-70b-versatile Llama 3.3 70B Versatile không văn bản 131,072
    groq/llama-3.1-8b-instant Llama 3.1 8B Instant không văn bản 131,072
    groq/meta-llama/llama-4-scout-17b-16e-instruct Llama 4 Scout 17B không văn bản + hình ảnh 131,072
    groq/openai/gpt-oss-120b GPT OSS 120B có văn bản 131,072
    groq/openai/gpt-oss-20b GPT OSS 20B có văn bản 131,072
    groq/openai/gpt-oss-safeguard-20b Safety GPT OSS 20B có văn bản 131,072
    groq/qwen/qwen3-32b Qwen3 32B có văn bản 131,072
    groq/groq/compound Compound có văn bản 131,072
    groq/groq/compound-mini Compound Mini có văn bản 131,072

    Mô hình suy luận

    Các mô hình suy luận của Groq (reasoning: true trong bảng trên) ánh xạ các mức /think dùng chung của OpenClaw sang các giá trị reasoning_effort là low, medium hoặc high. /think off hoặc /think none sẽ bỏ qua reasoning_effort khỏi yêu cầu thay vì gửi một giá trị vô hiệu hóa.

    Xem Chế độ tư duy để biết các mức /think dùng chung và cách OpenClaw chuyển đổi chúng cho 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 nội dung phương tiện âm thanh để có thể phiên âm tin nhắn thoại thông qua bề mặt dùng chung tools.media.audio.

    Thuộc tính Giá trị
    Đường dẫn cấu hình dùng chung tools.media.audio
    URL cơ sở mặc định https://api.groq.com/openai/v1
    Mô hình mặc định whisper-large-v3-turbo
    Mức ưu tiên tự động 20
    Điểm cuối API /audio/transcriptions tương thích với OpenAI

    Để đặt Groq làm phần phụ trợ âm thanh mặc định:

    json5
    {  tools: {    media: {      audio: {        models: [{ provider: "groq" }],      },    },  },}
    Khả dụng của môi trường đối với tiến trình nền

    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.

    ID mô hình Groq tùy chỉnh

    OpenClaw chấp nhận mọi ID mô hình Groq trong thời gian chạy. Sử dụng chính xác ID do Groq hiển thị và thêm tiền tố groq/. Danh mục tĩnh bao gồm các trường hợp phổ biến; các ID không có trong danh mục sẽ chuyển tiếp sang mẫu tương thích với OpenAI mặc định.

    json5
    {  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 đổi dự phòng.
    Chế độ tư duy

    Các mức nỗ lực suy luận và sự tương tác với chính sách của nhà cung cấp.
    Tham chiếu cấu hình

    Lược đồ cấu hình đầy đủ, bao gồm các cài đặt nhà cung cấp và âm thanh.
    Bảng điều khiển Groq

    Bảng điều khiển, tài liệu API và thông tin giá của Groq.
    Was this useful?
    On this page

    On this page