跳轉到主要內容

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.

Cerebras 在自訂推論硬體上提供高速、與 OpenAI 相容的推論。OpenClaw 包含一個內建的 Cerebras 提供者 Plugin，並附有靜態四模型目錄。
屬性值
提供者 IDcerebras
Plugin內建，enabledByDefault: true
驗證環境變數CEREBRAS_API_KEY
入門設定旗標--auth-choice cerebras-api-key
直接 CLI 旗標--cerebras-api-key <key>
API與 OpenAI 相容 (openai-completions)
基底 URLhttps://api.cerebras.ai/v1
預設模型cerebras/zai-glm-4.7

​
開始使用

1

取得 API 金鑰

在 Cerebras Cloud Console 建立 API 金鑰。
2

執行入門設定

openclaw onboard --auth-choice cerebras-api-key
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"

​
內建目錄

OpenClaw 隨附靜態 Cerebras 目錄，對應公開的 OpenAI 相容端點。全部四個模型都共用 128k 上下文和 8,192 個最大輸出 Token。
模型參照名稱推理備註
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 的支援模型頁面。

​
手動設定

內建 Plugin 通常表示你只需要 API 金鑰。當你想覆寫模型中繼資料，或在 mode: "merge" 下搭配靜態目錄執行時，請使用明確的 models.providers.cerebras 設定： 
{
  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" },
        ],
      },
    },
  },
}
如果 Gateway 以守護程式執行（launchd、systemd、Docker），請確認 CEREBRAS_API_KEY 可供該程序使用，例如放在 ~/.openclaw/.env 中，或透過 env.shellEnv 提供。只放在 ~/.profile 中的金鑰，除非另外匯入環境變數，否則對受管理的服務沒有幫助。

​
相關

模型提供者

選擇提供者、模型參照和容錯移轉行為。

思考模式

適用於兩個支援推理的 Cerebras 模型的推理投入等級。

設定參考

Agent 預設值和模型設定。

模型常見問題

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