跳轉到主要內容
Cerebras 在自訂推論硬體上提供高速、相容 OpenAI 的推論。此插件隨附靜態四模型目錄（不進行即時探索）。
屬性值
提供者 idcerebras
外掛官方外部套件（@openclaw/cerebras-provider）
驗證環境變數CEREBRAS_API_KEY
入門設定旗標--auth-choice cerebras-api-key
直接命令列旗標--cerebras-api-key <key>
API相容 OpenAI（openai-completions）
基礎 URLhttps://api.cerebras.ai/v1
預設模型cerebras/zai-glm-4.7

​
安裝插件

openclaw plugins install @openclaw/cerebras-provider
openclaw gateway restart

​
開始使用

1

取得 API 金鑰

在 Cerebras Cloud Console 建立 API 金鑰。
2

執行入門設定

openclaw onboard --auth-choice cerebras-api-key

openclaw onboard --non-interactive \
  --auth-choice cerebras-api-key \
  --cerebras-api-key "$CEREBRAS_API_KEY"

export CEREBRAS_API_KEY=csk-...
3

確認模型可用

openclaw models list --provider cerebras
列出全部四個靜態模型。如果 CEREBRAS_API_KEY 未解析，openclaw models status --json 會在 auth.unusableProfiles 下回報缺少的憑證。

​
非互動式設定

openclaw onboard --non-interactive \
  --mode local \
  --auth-choice cerebras-api-key \
  --cerebras-api-key "$CEREBRAS_API_KEY"

​
內建目錄

全部四個模型都共用 128k 上下文視窗與 8,192 個最大輸出權杖。
模型 ref名稱推理備註
cerebras/zai-glm-4.7Z.ai GLM 4.7是預設模型；預覽推理模型
cerebras/gpt-oss-120bGPT OSS 120B是生產推理模型
cerebras/qwen-3-235b-a22b-instruct-2507Qwen 3 235B Instruct否預覽非推理模型
cerebras/llama3.1-8bLlama 3.1 8B否生產用、偏重速度的模型
Cerebras 將 zai-glm-4.7 和 qwen-3-235b-a22b-instruct-2507 標示為預覽模型，且文件記載 llama3.1-8b 加上 qwen-3-235b-a22b-instruct-2507 將於 2026 年 5 月 27 日棄用。在生產工作負載中依賴它們之前，請先查看 Cerebras 的支援模型頁面。

​
手動設定

大多數設定只需要 API 金鑰。使用明確的 models.providers.cerebras 設定來覆寫模型中繼資料，或以 mode: "merge" 對靜態目錄執行： 
{
  env: { CEREBRAS_API_KEY: "csk-..." },
  agents: {
    defaults: {
      model: { primary: "cerebras/zai-glm-4.7" },
    },
  },
  models: {
    mode: "merge",
    providers: {
      cerebras: {
        baseUrl: "https://api.cerebras.ai/v1",
        apiKey: "${CEREBRAS_API_KEY}",
        api: "openai-completions",
        models: [
          { id: "zai-glm-4.7", name: "Z.ai GLM 4.7" },
          { id: "gpt-oss-120b", name: "GPT OSS 120B" },
        ],
      },
    },
  },
}
如果閘道以背景服務執行（launchd、systemd、Docker），請確保 CEREBRAS_API_KEY 可供該程序使用，例如放在 ~/.openclaw/.env 中或透過 env.shellEnv。只有在互動式 shell 中匯出的金鑰，除非另外匯入環境變數，否則對受管理的服務沒有幫助。

​
相關

模型提供者

選擇提供者、模型 ref，以及容錯移轉行為。

思考模式

兩個具備推理能力的 Cerebras 模型的推理投入層級。

設定參考

Agent 預設值與模型設定。

模型 FAQ

驗證設定檔、切換模型，以及解決「no profile」錯誤。