CLI моделей

​

Порядок вибору

• agents.defaults.models — це список дозволених моделей, які може використовувати OpenClaw, разом із псевдонімами. Використовуйте записи provider/*, щоб дозволити всі виявлені моделі провайдера без окремого переліку кожної з них.
• agents.defaults.utilityModel — необов’язкова дешевша модель для коротких внутрішніх завдань, як-от згенеровані назви сеансів панелі керування, назви підтримуваних гілок/тем каналів і опис перебігу виконання. Налаштування agents.list[].utilityModel для окремого агента має вищий пріоритет. Якщо значення не задано, OpenClaw використовує оголошену основним провайдером типову малу модель, якщо вона існує (OpenAI → gpt-5.6-luna, Anthropic → claude-haiku-4-5), інакше — основну модель агента; задайте порожній рядок, щоб вимкнути маршрутизацію службових завдань. Службові завдання є окремими викликами моделі й можуть надсилати обмежений вміст завдання вибраному провайдеру моделі.
• agents.defaults.imageModel використовується лише тоді, коли основна модель не може приймати зображення.
• agents.defaults.pdfModel використовується інструментом pdf. Якщо значення не задано, інструмент спочатку переходить до imageModel, а потім — до визначеної моделі сеансу або типової моделі.
• agents.defaults.imageGenerationModel, musicGenerationModel і videoGenerationModel забезпечують роботу спільних інструментів створення медіавмісту. Якщо значення не задано, кожен інструмент визначає типовий провайдер із підтримкою автентифікації: спочатку поточний типовий провайдер, потім решта зареєстрованих провайдерів для цієї можливості в порядку ідентифікаторів провайдерів. Задайте agents.defaults.mediaGenerationAutoProviderFallback: false, щоб вимкнути таке міжпровайдерне визначення, зберігши явні резервні варіанти.
• Налаштування agents.list[].model для окремого агента (разом із прив’язками) має вищий пріоритет за agents.defaults.model — див. Маршрутизація між кількома агентами.

​

Джерело вибору та строгість резервного перемикання

• Зміна agents.defaults.model.primary не перезаписує наявні закріплення сеансів. Якщо стан повідомляє This session is pinned to X; config primary Y will apply to new/unpinned sessions., виконайте /model default, щоб скинути закріплення.
• Засоби CLI для вибору типової моделі та списку дозволених моделей враховують models.mode: "replace", показуючи лише models.providers.*.models, а не повний вбудований каталог.
• Засіб вибору моделі в Control UI запитує в Gateway його налаштоване подання моделей: agents.defaults.models, якщо це значення задано (включно із записами-символами узагальнення provider/*), інакше — models.providers.*.models разом із провайдерами, що мають придатну автентифікацію. Повний вбудований каталог призначений лише для явних режимів перегляду (models.list з view: "all" або openclaw models list --all).
• Інтерфейси інвентаризації провайдерів використовують models.list з view: "provider-config", щоб показувати створені джерелом рядки models.providers.*.models без застосування списків дозволених моделей із засобу вибору.

​

Коротка політика щодо моделей

• Встановіть як основну найпотужнішу доступну вам модель останнього покоління.
• Використовуйте резервні варіанти для завдань, чутливих до вартості або затримки, і менш критичних чатів.
• Для агентів із підтримкою інструментів або недовірених вхідних даних уникайте старіших чи слабших рівнів моделей.

​

Початкове налаштування

openclaw onboard

​

«Модель не дозволена» (і чому відповіді припиняються)

Модель "provider/model" не дозволена. Використовуйте /models, щоб переглянути список провайдерів, або /models <provider>, щоб переглянути список моделей.
Додайте її за допомогою: openclaw config set agents.defaults.models '{"provider/model":{}}' --strict-json --merge

{
  agents: {
    defaults: {
      models: {
        "openai/*": {},
        "vllm/*": {},
      },
    },
  },
}

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

openclaw config set agents.defaults.models '{"openai/gpt-5.4":{}}' --strict-json --merge

​

/model у чаті

/model
/model list
/model 3
/model openai/gpt-5.4
/model default
/model status

• /model і /model list показують компактний нумерований список вибору (сімейство моделей + доступні провайдери); /model <#> вибирає з нього. У Discord це відкриває розкривні списки провайдерів і моделей із кроком Submit; у Telegram вибір зі списку діє лише в межах сеансу й ніколи не перезаписує постійне типове значення агента в openclaw.json. /models add застаріла й повертає повідомлення замість реєстрації моделей із чату.
• /model негайно зберігає новий вибір для сеансу. Якщо агент неактивний, наступний запуск одразу його використовує; якщо запуск уже активний, перемикання ставиться в чергу до наступної безпечної точки повторної спроби (або пізнішої, якщо вже почалася робота інструментів чи виведення відповіді).
• /model default очищає вибір для сеансу, щоб він знову успадковував налаштовану основну модель.
• Вибране користувачем посилання /model є строгим для цього сеансу: якщо воно стає недоступним, відповідь завершується з явною помилкою замість непомітного переходу ланцюжком резервних варіантів через agents.defaults.model.fallbacks. Налаштовані типові значення й основні моделі завдань cron і надалі використовують ланцюжки резервних варіантів.
• /model status — це докладне подання: кандидати автентифікації для кожного провайдера, а також (якщо налаштовано) кінцева точка провайдера baseUrl і режим api.
• Посилання на моделі розбираються поділом за першим /; введіть provider/model. Якщо сам ідентифікатор моделі містить / (у стилі OpenRouter), додайте префікс провайдера, наприклад /model openrouter/moonshotai/kimi-k2. Якщо провайдера не вказано, OpenClaw пробує: (1) збіг псевдоніма, (2) збіг унікального налаштованого провайдера для цього точного ідентифікатора моделі без префікса, (3) налаштованого типового провайдера (застарілий резервний варіант) — а якщо цей провайдер більше не надає налаштовану типову модель, натомість першу налаштовану пару провайдер/модель, щоб не показувати застаріле типове значення видаленого провайдера.
• Посилання на моделі нормалізуються до нижнього регістру; ідентифікатори провайдерів в інших аспектах мають точно збігатися, тому використовуйте ідентифікатор, оголошений плагіном.

​

CLI

openclaw models status
openclaw models list
openclaw models set <provider/model>
openclaw models set-image <provider/model>
openclaw models scan
openclaw models aliases list|add|remove
openclaw models fallbacks list|add|remove|clear
openclaw models image-fallbacks list|add|remove|clear
openclaw models auth list|add|login|paste-api-key|paste-token|setup-token|order

​

Реєстр моделей (models.json)

​

Пов’язане

• Середовища виконання агентів — OpenClaw, Codex та інші середовища виконання циклу агента
• Довідник конфігурації — ключі конфігурації моделей
• Генерування зображень — конфігурація моделі зображень
• Перемикання моделей у разі збою — ланцюжки резервних варіантів
• Провайдери моделей — маршрутизація провайдерів і автентифікація
• Довідник CLI моделей — повний довідник команд і прапорців
• Генерування музики — конфігурація музичної моделі
• Генерування відео — конфігурація відеомоделі