Providers

Cerebras

Cerebras استنتاج پرسرعت سازگار با OpenAI را روی سخت‌افزار استنتاج سفارشی ارائه می‌کند. Plugin ارائه‌دهنده Cerebras شامل یک کاتالوگ ایستای چهارمدلی است.

ویژگی	مقدار
شناسه ارائه‌دهنده	`cerebras`
Plugin	بسته رسمی خارجی
متغیر محیطی احراز هویت	`CEREBRAS_API_KEY`
پرچم راه‌اندازی اولیه	`--auth-choice cerebras-api-key`
پرچم مستقیم CLI	`--cerebras-api-key <key>`
API	سازگار با OpenAI (`openai-completions`)
نشانی پایه	`https://api.cerebras.ai/v1`
مدل پیش‌فرض	`cerebras/zai-glm-4.7`

نصب Plugin

Plugin رسمی را نصب کنید، سپس Gateway را راه‌اندازی مجدد کنید:

bash

openclaw plugins install @openclaw/cerebras-provideropenclaw gateway restart

شروع به کار

Get an API key

یک کلید API در کنسول ابری Cerebras ایجاد کنید.

Run onboarding

Onboarding

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

Direct flag

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

Env only

export CEREBRAS_API_KEY=csk-...

Verify models are available

bash

openclaw models list --provider cerebras

فهرست باید هر چهار مدل ایستا را شامل شود. اگر CEREBRAS_API_KEY حل نشود، openclaw models status --json اعتبارنامه گمشده را زیر auth.unusableProfiles گزارش می‌کند.

راه‌اندازی غیرتعاملی

bash

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

کاتالوگ داخلی

OpenClaw یک کاتالوگ ایستای Cerebras ارائه می‌کند که نقطه پایانی عمومی سازگار با OpenAI را بازتاب می‌دهد. هر چهار مدل زمینه ۱۲۸هزار و حداکثر ۸٬۱۹۲ توکن خروجی دارند.

ارجاع مدل	نام	استدلال	یادداشت‌ها
`cerebras/zai-glm-4.7`	Z.ai GLM 4.7	بله	مدل پیش‌فرض؛ مدل استدلالی پیش‌نمایش
`cerebras/gpt-oss-120b`	GPT OSS 120B	بله	مدل استدلالی تولیدی
`cerebras/qwen-3-235b-a22b-instruct-2507`	Qwen 3 235B Instruct	خیر	مدل غیر استدلالی پیش‌نمایش
`cerebras/llama3.1-8b`	Llama 3.1 8B	خیر	مدل تولیدی متمرکز بر سرعت

پیکربندی دستی

این Plugin معمولا یعنی فقط به کلید API نیاز دارید. وقتی می‌خواهید فراداده مدل را بازنویسی کنید یا در برابر کاتالوگ ایستا با mode: "merge" اجرا کنید، از پیکربندی صریح models.providers.cerebras استفاده کنید:

json5

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