ارائه‌دهندگان مدل

مرجعی برای ارائه‌دهندگان LLM/مدل (نه کانال‌های چت مانند WhatsApp/Telegram). برای قواعد انتخاب مدل، مدل‌ها را ببینید.

# قواعد سریع

# رفتار ارائه‌دهنده متعلق به Plugin

بیشتر منطق اختصاصی ارائه‌دهنده در Pluginهای ارائه‌دهنده (registerProvider(...)) قرار دارد، در حالی که OpenClaw حلقه استنتاج عمومی را نگه می‌دارد. Pluginها مالک راه‌اندازی اولیه، کاتالوگ‌های مدل، نگاشت متغیرهای محیطی احراز هویت، نرمال‌سازی انتقال/پیکربندی، پاک‌سازی طرح‌واره ابزار، طبقه‌بندی جایگزینی، تازه‌سازی OAuth، گزارش‌دهی مصرف، پروفایل‌های تفکر/استدلال و موارد بیشتر هستند.

فهرست کامل قلاب‌های SDK ارائه‌دهنده و مثال‌های Pluginهای همراه در Pluginهای ارائه‌دهنده قرار دارد. ارائه‌دهنده‌ای که به اجراکننده درخواست کاملا سفارشی نیاز دارد، یک سطح توسعه جداگانه و عمیق‌تر است.

# چرخش کلید API

# ارائه‌دهندگان داخلی (کاتالوگ pi-ai)

OpenClaw همراه با کاتالوگ pi-ai عرضه می‌شود. این ارائه‌دهندگان به پیکربندی models.providers نیازی ندارند؛ فقط احراز هویت را تنظیم کنید و یک مدل انتخاب کنید.

# OpenAI

• ارائه‌دهنده: openai
• احراز هویت: OPENAI_API_KEY
• چرخش اختیاری: OPENAI_API_KEYS، OPENAI_API_KEY_1، OPENAI_API_KEY_2، به‌همراه OPENCLAW_LIVE_OPENAI_KEY (بازنویسی تکی)
• مدل‌های نمونه: openai/gpt-5.5، openai/gpt-5.4-mini
• اگر یک نصب یا کلید API خاص رفتار متفاوتی دارد، در دسترس بودن حساب/مدل را با openclaw models list --provider openai بررسی کنید.
• CLI: openclaw onboard --auth-choice openai-api-key
• انتقال پیش‌فرض auto است (ابتدا WebSocket، با جایگزین SSE)
• برای هر مدل از طریق agents.defaults.models["openai/<model>"].params.transport بازنویسی کنید ("sse"، "websocket" یا "auto")
• گرم‌سازی WebSocket مربوط به OpenAI Responses به‌صورت پیش‌فرض از طریق params.openaiWsWarmup فعال است (true/false)
• پردازش اولویتی OpenAI می‌تواند از طریق agents.defaults.models["openai/<model>"].params.serviceTier فعال شود
• /fast و params.fastMode درخواست‌های مستقیم Responses مربوط به openai/* را روی api.openai.com به service_tier=priority نگاشت می‌کنند
• وقتی به‌جای کلید مشترک /fast یک سطح صریح می‌خواهید، از params.serviceTier استفاده کنید
• سرآیندهای انتساب پنهان OpenClaw (originator، version، User-Agent) فقط روی ترافیک بومی OpenAI به api.openai.com اعمال می‌شوند، نه پروکسی‌های عمومی سازگار با OpenAI
• مسیرهای بومی OpenAI همچنین store مربوط به Responses، راهنمایی‌های کش پرامپت، و شکل‌دهی بارسازه سازگار با استدلال OpenAI را نگه می‌دارند؛ مسیرهای پروکسی این کار را نمی‌کنند
• openai/gpt-5.3-codex-spark عمدا در OpenClaw پنهان شده است، چون درخواست‌های زنده API مربوط به OpenAI آن را رد می‌کنند و کاتالوگ فعلی Codex آن را ارائه نمی‌دهد

{
  agents: { defaults: { model: { primary: "openai/gpt-5.5" } } },
}

# Anthropic

• ارائه‌دهنده: anthropic
• احراز هویت: ANTHROPIC_API_KEY
• چرخش اختیاری: ANTHROPIC_API_KEYS، ANTHROPIC_API_KEY_1، ANTHROPIC_API_KEY_2، به‌همراه OPENCLAW_LIVE_ANTHROPIC_KEY (بازنویسی تکی)
• مدل نمونه: anthropic/claude-opus-4-6
• CLI: openclaw onboard --auth-choice apiKey
• درخواست‌های عمومی مستقیم Anthropic از کلید مشترک /fast و params.fastMode پشتیبانی می‌کنند، شامل ترافیک احراز هویت‌شده با کلید API و OAuth که به api.anthropic.com فرستاده می‌شود؛ OpenClaw آن را به service_tier مربوط به Anthropic نگاشت می‌کند (auto در برابر standard_only)
• پیکربندی ترجیحی Claude CLI ارجاع مدل را کانونی نگه می‌دارد و پشتانه CLI را جداگانه انتخاب می‌کند: anthropic/claude-opus-4-7 با agents.defaults.agentRuntime.id: "claude-cli". ارجاع‌های قدیمی claude-cli/claude-opus-4-7 همچنان برای سازگاری کار می‌کنند.

{
  agents: { defaults: { model: { primary: "anthropic/claude-opus-4-6" } } },
}

# OAuth مربوط به OpenAI Codex

• ارائه‌دهنده: openai-codex
• احراز هویت: OAuth (ChatGPT)
• ارجاع مدل PI: openai-codex/gpt-5.5
• ارجاع هارنس بومی سرور برنامه Codex: openai/gpt-5.5 با agents.defaults.agentRuntime.id: "codex"
• مستندات هارنس بومی سرور برنامه Codex: هارنس Codex
• ارجاع‌های مدل قدیمی: codex/gpt-*
• مرز Plugin: openai-codex/* Plugin مربوط به OpenAI را بارگذاری می‌کند؛ Plugin بومی سرور برنامه Codex فقط توسط زمان اجرای هارنس Codex یا ارجاع‌های قدیمی codex/* انتخاب می‌شود.
• CLI: openclaw onboard --auth-choice openai-codex یا openclaw models auth login --provider openai-codex
• انتقال پیش‌فرض auto است (ابتدا WebSocket، با جایگزین SSE)
• برای هر مدل PI از طریق agents.defaults.models["openai-codex/<model>"].params.transport بازنویسی کنید ("sse"، "websocket" یا "auto")
• params.serviceTier همچنین روی درخواست‌های بومی Codex Responses (chatgpt.com/backend-api) ارسال می‌شود
• سرآیندهای انتساب پنهان OpenClaw (originator، version، User-Agent) فقط روی ترافیک بومی Codex به chatgpt.com/backend-api پیوست می‌شوند، نه پروکسی‌های عمومی سازگار با OpenAI
• همان کلید مشترک /fast و پیکربندی params.fastMode را مانند openai/* مستقیم به اشتراک می‌گذارد؛ OpenClaw آن را به service_tier=priority نگاشت می‌کند
• openai-codex/gpt-5.5 از contextWindow = 400000 بومی کاتالوگ Codex و contextTokens = 272000 پیش‌فرض زمان اجرا استفاده می‌کند؛ سقف زمان اجرا را با models.providers.openai-codex.models[].contextTokens بازنویسی کنید
• نکته سیاستی: OAuth مربوط به OpenAI Codex صراحتا برای ابزارها/گردش‌کارهای خارجی مانند OpenClaw پشتیبانی می‌شود.
• برای مسیر رایج اشتراک به‌همراه زمان اجرای بومی Codex، با احراز هویت openai-codex وارد شوید اما openai/gpt-5.5 را به‌همراه agents.defaults.agentRuntime.id: "codex" پیکربندی کنید.
• فقط وقتی می‌خواهید مسیر OAuth/اشتراک Codex از طریق PI باشد، از openai-codex/gpt-5.5 استفاده کنید؛ وقتی تنظیم کلید API و کاتالوگ محلی شما مسیر API عمومی را ارائه می‌دهد، از openai/gpt-5.5 بدون بازنویسی زمان اجرای Codex استفاده کنید.
• ارجاع‌های قدیمی‌تر openai-codex/gpt-5.1*، openai-codex/gpt-5.2* و openai-codex/gpt-5.3* پنهان شده‌اند، چون حساب‌های OAuth مربوط به ChatGPT/Codex آن‌ها را رد می‌کنند؛ به‌جای آن از openai-codex/gpt-5.5 یا مسیر زمان اجرای بومی Codex استفاده کنید.

{
  plugins: { entries: { codex: { enabled: true } } },
  agents: {
    defaults: {
      model: { primary: "openai/gpt-5.5" },
      agentRuntime: { id: "codex" },
    },
  },
}

{
  models: {
    providers: {
      "openai-codex": {
        models: [{ id: "gpt-5.5", contextTokens: 160000 }],
      },
    },
  },
}

# گزینه‌های میزبانی‌شده دیگر به سبک اشتراک

# OpenCode

• احراز هویت: OPENCODE_API_KEY (یا OPENCODE_ZEN_API_KEY)
• ارائه‌دهنده زمان اجرای Zen: opencode
• ارائه‌دهنده زمان اجرای Go: opencode-go
• مدل‌های نمونه: opencode/claude-opus-4-6، opencode-go/kimi-k2.6
• CLI: openclaw onboard --auth-choice opencode-zen یا openclaw onboard --auth-choice opencode-go

{
  agents: { defaults: { model: { primary: "opencode/claude-opus-4-6" } } },
}

# Google Gemini (کلید API)

• ارائه‌دهنده: google
• احراز هویت: GEMINI_API_KEY
• چرخش اختیاری: GEMINI_API_KEYS، GEMINI_API_KEY_1، GEMINI_API_KEY_2، fallback برای GOOGLE_API_KEY، و OPENCLAW_LIVE_GEMINI_KEY (بازنویسی تکی)
• مدل‌های نمونه: google/gemini-3.1-pro-preview، google/gemini-3-flash-preview
• سازگاری: پیکربندی قدیمی OpenClaw که از google/gemini-3.1-flash-preview استفاده می‌کند به google/gemini-3-flash-preview نرمال‌سازی می‌شود
• نام مستعار: google/gemini-3.1-pro پذیرفته می‌شود و به شناسه زنده Gemini API گوگل، یعنی google/gemini-3.1-pro-preview، نرمال‌سازی می‌شود
• CLI: openclaw onboard --auth-choice gemini-api-key
• تفکر: /think adaptive از تفکر پویا گوگل استفاده می‌کند. Gemini 3/3.1 مقدار ثابت thinkingLevel را حذف می‌کند؛ Gemini 2.5 مقدار thinkingBudget: -1 را ارسال می‌کند.
• اجراهای مستقیم Gemini همچنین agents.defaults.models["google/<model>"].params.cachedContent (یا cached_content قدیمی) را می‌پذیرند تا یک هندل بومی ارائه‌دهنده از نوع cachedContents/... را ارسال کنند؛ برخوردهای کش Gemini به‌صورت cacheRead در OpenClaw نمایش داده می‌شوند

# Google Vertex و Gemini CLI

• ارائه‌دهندگان: google-vertex، google-gemini-cli
• احراز هویت: Vertex از gcloud ADC استفاده می‌کند؛ Gemini CLI از جریان OAuth خودش استفاده می‌کند

OAuth در Gemini CLI به‌عنوان بخشی از Plugin همراه google ارائه می‌شود.

brew install gemini-cli

npm install -g @google/gemini-cli

openclaw plugins enable google

openclaw models auth login --provider google-gemini-cli --set-default

پاسخ‌های JSON در Gemini CLI از response پردازش می‌شوند؛ مصرف به stats fallback می‌کند و stats.cached به cacheRead در OpenClaw نرمال‌سازی می‌شود.

# Z.AI (GLM)

• ارائه‌دهنده: zai
• احراز هویت: ZAI_API_KEY
• مدل نمونه: zai/glm-5.1
• CLI: openclaw onboard --auth-choice zai-api-key
  • نام‌های مستعار: z.ai/* و z-ai/* به zai/* نرمال‌سازی می‌شوند
  • zai-api-key endpoint متناظر Z.AI را به‌صورت خودکار تشخیص می‌دهد؛ zai-coding-global، zai-coding-cn، zai-global، و zai-cn یک سطح مشخص را اجبار می‌کنند

# Vercel AI Gateway

• ارائه‌دهنده: vercel-ai-gateway
• احراز هویت: AI_GATEWAY_API_KEY
• مدل‌های نمونه: vercel-ai-gateway/anthropic/claude-opus-4.6، vercel-ai-gateway/moonshotai/kimi-k2.6
• CLI: openclaw onboard --auth-choice ai-gateway-api-key

# Kilo Gateway

• ارائه‌دهنده: kilocode
• احراز هویت: KILOCODE_API_KEY
• مدل نمونه: kilocode/kilo/auto
• CLI: openclaw onboard --auth-choice kilocode-api-key
• URL پایه: https://api.kilo.ai/api/gateway/
• کاتالوگ fallback ایستا همراه با kilocode/kilo/auto ارائه می‌شود؛ کشف زنده https://api.kilo.ai/api/gateway/models می‌تواند کاتالوگ زمان اجرا را بیشتر گسترش دهد.
• مسیریابی دقیق upstream پشت kilocode/kilo/auto متعلق به Kilo Gateway است و در OpenClaw hard-code نشده است.

برای جزئیات راه‌اندازی، /providers/kilocode را ببینید.

# Pluginهای ارائه‌دهنده همراه دیگر

# نکات خاصی که دانستنشان مفید است

# ارائه‌دهنده‌ها از طریق models.providers (URL سفارشی/پایه)

از models.providers (یا models.json) برای افزودن ارائه‌دهنده‌های سفارشی یا پروکسی‌های سازگار با OpenAI/Anthropic استفاده کنید.

بسیاری از Pluginهای ارائه‌دهنده‌ی بسته‌بندی‌شده‌ی زیر از قبل یک کاتالوگ پیش‌فرض منتشر می‌کنند. ورودی‌های صریح models.providers.<id> را فقط زمانی استفاده کنید که می‌خواهید URL پایه، سرآیندها یا فهرست مدل پیش‌فرض را بازنویسی کنید.

بررسی‌های قابلیت مدل در Gateway همچنین فراداده‌ی صریح models.providers.<id>.models[] را می‌خوانند. اگر یک مدل سفارشی یا پروکسی تصویر می‌پذیرد، روی آن مدل input: ["text", "image"] را تنظیم کنید تا WebChat و مسیرهای پیوست با مبدأ node، تصویرها را به‌جای ارجاع‌های رسانه‌ای فقط‌متنی، به‌عنوان ورودی‌های بومی مدل ارسال کنند.

# Moonshot AI (Kimi)

Moonshot به‌عنوان یک Plugin ارائه‌دهنده‌ی بسته‌بندی‌شده عرضه می‌شود. به‌صورت پیش‌فرض از ارائه‌دهنده‌ی داخلی استفاده کنید و فقط زمانی یک ورودی صریح models.providers.moonshot اضافه کنید که لازم است URL پایه یا فراداده‌ی مدل را بازنویسی کنید:

• ارائه‌دهنده: moonshot
• احراز هویت: MOONSHOT_API_KEY
• مدل نمونه: moonshot/kimi-k2.6
• CLI: openclaw onboard --auth-choice moonshot-api-key یا openclaw onboard --auth-choice moonshot-api-key-cn

شناسه‌های مدل Kimi K2:

• moonshot/kimi-k2.6
• moonshot/kimi-k2.5
• moonshot/kimi-k2-thinking
• moonshot/kimi-k2-thinking-turbo
• moonshot/kimi-k2-turbo

{
  agents: {
    defaults: { model: { primary: "moonshot/kimi-k2.6" } },
  },
  models: {
    mode: "merge",
    providers: {
      moonshot: {
        baseUrl: "https://api.moonshot.ai/v1",
        apiKey: "${MOONSHOT_API_KEY}",
        api: "openai-completions",
        models: [{ id: "kimi-k2.6", name: "Kimi K2.6" }],
      },
    },
  },
}

# کدنویسی Kimi

Kimi Coding از endpoint سازگار با Anthropic مربوط به Moonshot AI استفاده می‌کند:

• ارائه‌دهنده: kimi
• احراز هویت: KIMI_API_KEY
• مدل نمونه: kimi/kimi-code

{
  env: { KIMI_API_KEY: "sk-..." },
  agents: {
    defaults: { model: { primary: "kimi/kimi-code" } },
  },
}

شناسه مدل قدیمی kimi/k2p5 همچنان به‌عنوان شناسه مدل سازگار پذیرفته می‌شود.

# Volcano Engine (Doubao)

Volcano Engine (火山引擎) دسترسی به Doubao و مدل‌های دیگر را در چین فراهم می‌کند.

• ارائه‌دهنده: volcengine (کدنویسی: volcengine-plan)
• احراز هویت: VOLCANO_ENGINE_API_KEY
• مدل نمونه: volcengine-plan/ark-code-latest
• CLI: openclaw onboard --auth-choice volcengine-api-key

{
  agents: {
    defaults: { model: { primary: "volcengine-plan/ark-code-latest" } },
  },
}

فرایند راه‌اندازی به‌طور پیش‌فرض از سطح کدنویسی استفاده می‌کند، اما کاتالوگ عمومی volcengine/* نیز هم‌زمان ثبت می‌شود.

در انتخابگرهای مدلِ راه‌اندازی/پیکربندی، گزینه احراز هویت Volcengine هر دو ردیف volcengine/* و volcengine-plan/* را ترجیح می‌دهد. اگر این مدل‌ها هنوز بارگذاری نشده باشند، OpenClaw به‌جای نمایش انتخابگر خالی محدود به ارائه‌دهنده، به کاتالوگ فیلترنشده برمی‌گردد.

# BytePlus (International)

BytePlus ARK دسترسی به همان مدل‌های Volcano Engine را برای کاربران بین‌المللی فراهم می‌کند.

• ارائه‌دهنده: byteplus (کدنویسی: byteplus-plan)
• احراز هویت: BYTEPLUS_API_KEY
• مدل نمونه: byteplus-plan/ark-code-latest
• CLI: openclaw onboard --auth-choice byteplus-api-key

{
  agents: {
    defaults: { model: { primary: "byteplus-plan/ark-code-latest" } },
  },
}

فرایند راه‌اندازی به‌طور پیش‌فرض از سطح کدنویسی استفاده می‌کند، اما کاتالوگ عمومی byteplus/* نیز هم‌زمان ثبت می‌شود.

در انتخابگرهای مدلِ راه‌اندازی/پیکربندی، گزینه احراز هویت BytePlus هر دو ردیف byteplus/* و byteplus-plan/* را ترجیح می‌دهد. اگر این مدل‌ها هنوز بارگذاری نشده باشند، OpenClaw به‌جای نمایش انتخابگر خالی محدود به ارائه‌دهنده، به کاتالوگ فیلترنشده برمی‌گردد.

# Synthetic

Synthetic مدل‌های سازگار با Anthropic را پشت ارائه‌دهنده synthetic فراهم می‌کند:

• ارائه‌دهنده: synthetic
• احراز هویت: SYNTHETIC_API_KEY
• مدل نمونه: synthetic/hf:MiniMaxAI/MiniMax-M2.5
• CLI: openclaw onboard --auth-choice synthetic-api-key

{
  agents: {
    defaults: { model: { primary: "synthetic/hf:MiniMaxAI/MiniMax-M2.5" } },
  },
  models: {
    mode: "merge",
    providers: {
      synthetic: {
        baseUrl: "https://api.synthetic.new/anthropic",
        apiKey: "${SYNTHETIC_API_KEY}",
        api: "anthropic-messages",
        models: [{ id: "hf:MiniMaxAI/MiniMax-M2.5", name: "MiniMax M2.5" }],
      },
    },
  },
}

# MiniMax

MiniMax از طریق models.providers پیکربندی می‌شود، چون از نقاط پایانی سفارشی استفاده می‌کند:

• MiniMax OAuth (سراسری): --auth-choice minimax-global-oauth
• MiniMax OAuth (چین): --auth-choice minimax-cn-oauth
• کلید API MiniMax (سراسری): --auth-choice minimax-global-api
• کلید API MiniMax (چین): --auth-choice minimax-cn-api
• احراز هویت: MINIMAX_API_KEY برای minimax؛ MINIMAX_OAUTH_TOKEN یا MINIMAX_API_KEY برای minimax-portal

برای جزئیات راه‌اندازی، گزینه‌های مدل، و قطعه‌های پیکربندی، /providers/minimax را ببینید.

تفکیک قابلیت‌های متعلق به Plugin:

• پیش‌فرض‌های متن/گفت‌وگو روی minimax/MiniMax-M2.7 باقی می‌مانند
• تولید تصویر minimax/image-01 یا minimax-portal/image-01 است
• درک تصویر، MiniMax-VL-01 متعلق به Plugin در هر دو مسیر احراز هویت MiniMax است
• جست‌وجوی وب روی شناسه ارائه‌دهنده minimax باقی می‌ماند

# LM Studio

LM Studio به‌صورت یک Plugin ارائه‌دهنده همراه عرضه می‌شود که از API بومی استفاده می‌کند:

• ارائه‌دهنده: lmstudio
• احراز هویت: LM_API_TOKEN
• نشانی پایه پیش‌فرض برای استنتاج: http://localhost:1234/v1

سپس یک مدل تنظیم کنید (با یکی از شناسه‌هایی که http://localhost:1234/api/v1/models برمی‌گرداند جایگزین کنید):

{
  agents: {
    defaults: { model: { primary: "lmstudio/openai/gpt-oss-20b" } },
  },
}

OpenClaw برای کشف + بارگذاری خودکار از /api/v1/models و /api/v1/models/load بومی LM Studio استفاده می‌کند، و به‌طور پیش‌فرض برای استنتاج از /v1/chat/completions استفاده می‌شود. اگر می‌خواهید بارگذاری JIT، TTL، و حذف خودکار LM Studio مالک چرخه عمر مدل باشند، models.providers.lmstudio.params.preload: false را تنظیم کنید. برای راه‌اندازی و عیب‌یابی، /providers/lmstudio را ببینید.

# Ollama

Ollama به‌صورت یک Plugin ارائه‌دهنده همراه عرضه می‌شود و از API بومی Ollama استفاده می‌کند:

• ارائه‌دهنده: ollama
• احراز هویت: لازم نیست (سرور محلی)
• مدل نمونه: ollama/llama3.3
• نصب: https://ollama.com/download

# Install Ollama, then pull a model:
ollama pull llama3.3

{
  agents: {
    defaults: { model: { primary: "ollama/llama3.3" } },
  },
}

وقتی با OLLAMA_API_KEY فعال‌سازی را انتخاب کنید، Ollama به‌صورت محلی در http://127.0.0.1:11434 شناسایی می‌شود، و Plugin ارائه‌دهنده همراه، Ollama را مستقیماً به openclaw onboard و انتخابگر مدل اضافه می‌کند. برای راه‌اندازی، حالت ابری/محلی، و پیکربندی سفارشی، /providers/ollama را ببینید.

# vLLM

vLLM به‌صورت یک Plugin ارائه‌دهنده همراه برای سرورهای محلی/خودمیزبانِ سازگار با OpenAI عرضه می‌شود:

• ارائه‌دهنده: vllm
• احراز هویت: اختیاری (به سرور شما بستگی دارد)
• نشانی پایه پیش‌فرض: http://127.0.0.1:8000/v1

برای فعال‌سازی کشف خودکار به‌صورت محلی (اگر سرور شما احراز هویت را اجباری نمی‌کند، هر مقداری کار می‌کند):

export VLLM_API_KEY="vllm-local"

سپس یک مدل تنظیم کنید (با یکی از شناسه‌هایی که /v1/models برمی‌گرداند جایگزین کنید):

{
  agents: {
    defaults: { model: { primary: "vllm/your-model-id" } },
  },
}

برای جزئیات، /providers/vllm را ببینید.

# SGLang

SGLang به‌صورت یک Plugin ارائه‌دهنده همراه برای سرورهای سریع خودمیزبانِ سازگار با OpenAI عرضه می‌شود:

• ارائه‌دهنده: sglang
• احراز هویت: اختیاری (به سرور شما بستگی دارد)
• نشانی پایه پیش‌فرض: http://127.0.0.1:30000/v1

برای فعال‌سازی کشف خودکار به‌صورت محلی (اگر سرور شما احراز هویت را اجباری نمی‌کند، هر مقداری کار می‌کند):

export SGLANG_API_KEY="sglang-local"

سپس یک مدل تنظیم کنید (با یکی از شناسه‌هایی که /v1/models برمی‌گرداند جایگزین کنید):

{
  agents: {
    defaults: { model: { primary: "sglang/your-model-id" } },
  },
}

برای جزئیات، /providers/sglang را ببینید.

# پراکسی‌های محلی (LM Studio، vLLM، LiteLLM، و غیره)

نمونه (سازگار با OpenAI):

{
  agents: {
    defaults: {
      model: { primary: "lmstudio/my-local-model" },
      models: { "lmstudio/my-local-model": { alias: "Local" } },
    },
  },
  models: {
    providers: {
      lmstudio: {
        baseUrl: "http://localhost:1234/v1",
        apiKey: "${LM_API_TOKEN}",
        api: "openai-completions",
        timeoutSeconds: 300,
        models: [
          {
            id: "my-local-model",
            name: "Local Model",
            reasoning: false,
            input: ["text"],
            cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 },
            contextWindow: 200000,
            maxTokens: 8192,
          },
        ],
      },
    },
  },
}

# نمونه‌های CLI

openclaw onboard --auth-choice opencode-zen
openclaw models set opencode/claude-opus-4-6
openclaw models list

همچنین ببینید: پیکربندی برای نمونه‌های کامل پیکربندی.

# مرتبط

• مرجع پیکربندی - کلیدهای پیکربندی مدل
• جابه‌جایی خودکار مدل - زنجیره‌های جایگزین و رفتار تلاش دوباره
• مدل‌ها - پیکربندی مدل و نام‌های مستعار
• ارائه‌دهنده‌ها - راهنماهای راه‌اندازی برای هر ارائه‌دهنده