Modellar CLI¶

Auth profillar rotatsiyasi, cooldown’lar va ularning fallback’lar bilan o‘zaro ta’siri haqida /concepts/model-failover sahifasiga qarang. Provayderlar bo‘yicha qisqa sharh + misollar: /concepts/model-providers.

Model tanlash qanday ishlaydi¶

OpenClaw modelllarni quyidagi tartibda tanlaydi:

1. Asosiy model (agents.defaults.model.primary yoki agents.defaults.model).
2. agents.defaults.model.fallbacks ichidagi fallback modelllar (tartib bo‘yicha).
3. Provayder auth failover keyingi modelga o‘tishdan oldin provayder ichida amalga oshadi.

Bog‘liq:

• agents.defaults.models — OpenClaw foydalanishi mumkin bo‘lgan modelllar ro‘yxati/katalogi (va aliaslar).
• agents.defaults.imageModel — faqat asosiy model rasm qabul qila olmaganda ishlatiladi.
• Har bir agent uchun standart sozlamalar agents.list[].model orqali agents.defaults.model ni override qilishi mumkin (bindinglar bilan birga; qarang /concepts/multi-agent).

Tezkor model tanlovlari (subyektiv)¶

• GLM: kod yozish/tool chaqirish uchun biroz yaxshiroq.
• MiniMax: yozish uslubi va umumiy “vibe” uchun yaxshiroq.

Setup wizard (tavsiya etiladi)¶

Agar konfiguratsiyani qo‘lda tahrirlashni istamasangiz, onboarding wizard’ni ishga tushiring:

openclaw onboard

U keng tarqalgan provayderlar uchun model + auth sozlashni bajaradi, jumladan OpenAI Code (Codex) subscription (OAuth) va Anthropic (API key tavsiya etiladi; claude setup-token ham qo‘llab‑quvvatlanadi).

Config kalitlari (umumiy ko‘rinish)¶

• agents.defaults.model.primary va agents.defaults.model.fallbacks
• agents.defaults.imageModel.primary va agents.defaults.imageModel.fallbacks
• agents.defaults.models (allowlist + aliaslar + provayder parametrlari)
• models.providers (models.json ga yoziladigan maxsus provayderlar)

Model referenslari kichik harflarga normallashtiriladi. z.ai/* kabi provayder aliaslari zai/* ko‘rinishiga normallashtiriladi.

Provayder konfiguratsiyasi misollari (OpenCode Zen bilan birga) quyida: /gateway/configuration.

“Model is not allowed” (va nega javob to‘xtab qoladi)¶

Agar agents.defaults.models o‘rnatilgan bo‘lsa, u /model va sessiya override’lari uchun allowlist ga aylanadi. Foydalanuvchi ushbu allowlist’da yo‘q modelni tanlasa, OpenClaw quyidagini qaytaradi:

Model "provider/model" is not allowed. Use /model to list available models.

Bu xabar odatiy javob yaratilishidan oldin paydo bo‘ladi, shuning uchun go‘yoki “javob bermadi” degan taassurot qoldirishi mumkin. Yechim:

• Modelni agents.defaults.models ga qo‘shing, yoki
• Allowlist’ni tozalang (agents.defaults.models ni olib tashlang), yoki
• /model list dan model tanlang.

Allowlist konfiguratsiyasi misoli:

{
  agent: {
    model: { primary: "anthropic/claude-sonnet-4-5" },
    models: {
      "anthropic/claude-sonnet-4-5": { alias: "Sonnet" },
      "anthropic/claude-opus-4-6": { alias: "Opus" },
    },
  },
}

Chat ichida modelni almashtirish (/model)¶

Sessiyani qayta ishga tushirmasdan joriy sessiya uchun modelni almashtirishingiz mumkin:

/model
/model list
/model 3
/model openai/gpt-5.2
/model status

Eslatmalar:

• /model (va /model list) — ixcham, raqamlangan tanlash ro‘yxati (model oilasi + mavjud provayderlar).
• /model <#> — shu ro‘yxatdan tanlaydi.
• /model status — batafsil ko‘rinish (auth nomzodlari va, sozlangan bo‘lsa, provayder endpoint baseUrl + api rejimi).
• Model referenslari birinchi / bo‘yicha ajratiladi. /model <ref> kiritishda provider/model dan foydalaning.
• Agar model ID’ning o‘zida / bo‘lsa (OpenRouter uslubida), provayder prefiksini kiritish shart (masalan: /model openrouter/moonshotai/kimi-k2).
• Agar provayder ko‘rsatilmasa, OpenClaw kiritmani alias yoki default provayder uchun model sifatida talqin qiladi (faqat model ID’da / bo‘lmasa ishlaydi).

To‘liq buyruq xatti‑harakati/konfiguratsiyasi: Slash commands.

CLI buyruqlari¶

openclaw models list
openclaw models status
openclaw models set <provider/model>
openclaw models set-image <provider/model>

openclaw models aliases list
openclaw models aliases add <alias> <provider/model>
openclaw models aliases remove <alias>

openclaw models fallbacks list
openclaw models fallbacks add <provider/model>
openclaw models fallbacks remove <provider/model>
openclaw models fallbacks clear

openclaw models image-fallbacks list
openclaw models image-fallbacks add <provider/model>
openclaw models image-fallbacks remove <provider/model>
openclaw models image-fallbacks clear

openclaw models (subbuyruqsiz) — models status uchun qisqa yo‘l.

models list¶

Odatiy holatda sozlangan modelllarni ko‘rsatadi. Foydali flag’lar:

• --all: to‘liq katalog
• --local: faqat lokal provayderlar
• --provider <name>: provayder bo‘yicha filtrlash
• --plain: har qatorda bitta model
• --json: mashina o‘qiy oladigan chiqish

models status¶

Yakuniy aniqlangan asosiy model, fallback’lar, image model va sozlangan provayderlar bo‘yicha auth umumiy ko‘rinishini ko‘rsatadi. Shuningdek, auth store’da topilgan profil­lar uchun OAuth amal qilish muddati holatini ham ko‘rsatadi (odatda 24 soat ichida ogohlantiradi). --plain faqat yakuniy asosiy modelni chiqaradi. OAuth holati har doim ko‘rsatiladi (va --json chiqishiga ham kiritiladi). Agar sozlangan provayderda credential bo‘lmasa, models status Missing auth bo‘limini chiqaradi. JSON chiqishida auth.oauth (ogohlantirish oynasi + profillar) va auth.providers (har bir provayder uchun amaldagi auth) mavjud bo‘ladi. Avtomatlashtirish uchun --check dan foydalaning (mavjud emas/yaroqsiz bo‘lsa chiqish kodi 1, muddati yaqinlashayotgan bo‘lsa 2).

Anthropic uchun afzal auth — Claude Code CLI setup-token (istalgan joyda ishga tushiring; kerak bo‘lsa gateway host’da joylashtiring):

claude setup-token
openclaw models status

Skanerlash (OpenRouter bepul modellari)¶

openclaw models scan OpenRouter’ning bepul model katalogi ni tekshiradi va ixtiyoriy ravishda modellarning tool va image qo‘llab‑quvvatlashini probelashi mumkin.

Asosiy flag’lar:

• --no-probe: live probe’larni o‘tkazib yuboradi (faqat metadata)
• --min-params <b>: minimal parametr hajmi (milliardlarda)
• --max-age-days <days>: eski modelllarni o‘tkazib yuboradi
• --provider <name>: provayder prefiksi bo‘yicha filtr
• --max-candidates <n>: fallback ro‘yxati hajmi
• --set-default: agents.defaults.model.primary ni birinchi tanlovga o‘rnatadi
• --set-image: agents.defaults.imageModel.primary ni birinchi image tanlovga o‘rnatadi

Probelash uchun OpenRouter API key kerak (auth profillardan yoki OPENROUTER_API_KEY). Kalitsiz faqat nomzodlarni ko‘rish uchun --no-probe dan foydalaning.

Skan natijalari quyidagilar bo‘yicha reytinglanadi:

1. Image qo‘llab‑quvvatlashi
2. Tool kechikishi (latency)
3. Kontekst hajmi
4. Parametrlar soni

Input

• OpenRouter /models ro‘yxati (filter :free)
• Auth profillardan yoki OPENROUTER_API_KEY dan OpenRouter API key talab qilinadi (qarang /environment)
• Ixtiyoriy filtrlar: --max-age-days, --min-params, --provider, --max-candidates
• Probe boshqaruvi: --timeout, --concurrency

TTY’da ishga tushirilganda fallback’larni interaktiv tanlashingiz mumkin. Non‑interactive rejimda standart qiymatlarni qabul qilish uchun --yes ni bering.

Models registry (models.json)¶

models.providers dagi maxsus provayderlar agent katalogidagi models.json fayliga yoziladi (standart: ~/.openclaw/agents/<agentId>/models.json). Agar models.mode replace ga o‘rnatilmagan bo‘lsa, bu fayl odatiy holatda merge qilinadi.