Providers

Groq

Groq 使用自訂 LPU 硬體,為開放權重模型(Llama、Gemma、Kimi、Qwen、GPT OSS 等)提供超快速推論。OpenClaw 內建 Groq Plugin,會註冊 OpenAI 相容的聊天提供者與音訊媒體理解提供者。

屬性
提供者 id groq
Plugin 內建,enabledByDefault: true
驗證環境變數 GROQ_API_KEY
Onboarding 旗標 --auth-choice groq-api-key
API OpenAI 相容 (openai-completions)
基礎 URL https://api.groq.com/openai/v1
音訊轉錄 whisper-large-v3-turbo(預設)
建議的聊天預設值 groq/llama-3.3-70b-versatile

開始使用

  • 取得 API 金鑰

    console.groq.com/keys 建立 API 金鑰。

  • 設定 API 金鑰

    openclaw onboard --auth-choice groq-api-key
    
    export GROQ_API_KEY=gsk_...
    
  • 設定預設模型

    {
      agents: {
        defaults: {
          model: { primary: "groq/llama-3.3-70b-versatile" },
        },
      },
    }
    
  • 確認目錄可連線

    openclaw models list --provider groq
    
  • 設定檔範例

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

    內建目錄

    OpenClaw 隨附以 manifest 支援的 Groq 目錄,包含推理與非推理項目。執行 openclaw models list --provider groq 查看你安裝版本內建的列,或查看 console.groq.com/docs/models 取得 Groq 的權威清單。

    模型參照 名稱 推理 輸入 上下文
    groq/llama-3.3-70b-versatile Llama 3.3 70B Versatile 文字 131,072
    groq/llama-3.1-8b-instant Llama 3.1 8B Instant 文字 131,072
    groq/meta-llama/llama-4-maverick-17b-128e-instruct Llama 4 Maverick 17B 文字 + 圖片 131,072
    groq/meta-llama/llama-4-scout-17b-16e-instruct Llama 4 Scout 17B 文字 + 圖片 131,072
    groq/llama3-70b-8192 Llama 3 70B 文字 8,192
    groq/llama3-8b-8192 Llama 3 8B 文字 8,192
    groq/gemma2-9b-it Gemma 2 9B 文字 8,192
    groq/mistral-saba-24b Mistral Saba 24B 文字 32,768
    groq/moonshotai/kimi-k2-instruct Kimi K2 Instruct 文字 131,072
    groq/moonshotai/kimi-k2-instruct-0905 Kimi K2 Instruct 0905 文字 262,144
    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 Safety GPT OSS 20B 文字 131,072
    groq/qwen-qwq-32b Qwen QwQ 32B 文字 131,072
    groq/qwen/qwen3-32b Qwen3 32B 文字 131,072
    groq/deepseek-r1-distill-llama-70b DeepSeek R1 Distill Llama 70B 文字 131,072
    groq/groq/compound Compound 文字 131,072
    groq/groq/compound-mini Compound Mini 文字 131,072

    推理模型

    OpenClaw 會將共用的 /think 等級對應到 Groq 模型特定的 reasoning_effort 值:

    • 對於 qwen/qwen3-32b,停用思考時會傳送 none,啟用思考時會傳送 default
    • 對於 Groq GPT OSS 推理模型 (openai/gpt-oss-*),OpenClaw 會根據 /think 等級傳送 lowmediumhigh。停用思考時會省略 reasoning_effort,因為這些模型不支援停用值。
    • DeepSeek R1 Distill、Qwen QwQ 與 Compound 使用 Groq 原生推理介面;/think 控制可見性,但模型始終會推理。

    請參閱 思考模式,了解共用的 /think 等級,以及 OpenClaw 如何依提供者轉譯它們。

    音訊轉錄

    Groq 的內建 Plugin 也會註冊音訊媒體理解提供者,讓語音訊息可以透過共用的 tools.media.audio 介面進行轉錄。

    屬性
    共用設定路徑 tools.media.audio
    預設基礎 URL https://api.groq.com/openai/v1
    預設模型 whisper-large-v3-turbo
    自動優先順序 20
    API 端點 OpenAI 相容 /audio/transcriptions

    若要將 Groq 設為預設音訊後端:

    {
      tools: {
        media: {
          audio: {
            models: [{ provider: "groq" }],
          },
        },
      },
    }
    
    daemon 的環境可用性

    如果 Gateway 以受管理服務(launchd、systemd、Docker)執行,GROQ_API_KEY 必須對該行程可見,而不只是對你的互動式 shell 可見。

    自訂 Groq 模型 id

    OpenClaw 在執行階段接受任何 Groq 模型 id。使用 Groq 顯示的確切 id,並加上 groq/ 前綴。內建目錄涵蓋常見情境;未收錄於目錄的 id 會退回使用預設的 OpenAI 相容範本。

    {
      agents: {
        defaults: {
          model: { primary: "groq/<your-model-id>" },
        },
      },
    }
    

    相關內容