docs/docs/uk/cli/models.md

read_when	summary	title	x-i18n
Ви хочете змінити моделі за замовчуванням або переглянути статус автентифікації провайдера Ви хочете просканувати доступні моделі/провайдерів і налагодити профілі автентифікації	Довідник CLI для `openclaw models` (`status`/`list`/`set`/`scan`, псевдоніми, резервні варіанти, автентифікація)	Моделі	generated_at model provider source_hash source_path workflow 2026-04-25T09:52:27Z gpt-5.4 openai 2c8040159e23789221357dd60232012759ee540ebfd3e5d192a0a09419d40c9a cli/models.md 15

openclaw models

Виявлення моделей, сканування та налаштування (модель за замовчуванням, резервні варіанти, профілі автентифікації).

Пов’язане:

• Провайдери + моделі: Моделі
• Концепції вибору моделі + слеш-команда /models: Концепція моделей
• Налаштування автентифікації провайдера: Початок роботи

Поширені команди

openclaw models status
openclaw models list
openclaw models set <model-or-alias>
openclaw models scan

openclaw models status показує визначені модель за замовчуванням/резервні варіанти, а також огляд автентифікації. Коли доступні знімки використання провайдерів, розділ статусу OAuth/API-ключів містить вікна використання провайдерів і знімки квот. Поточні провайдери з вікнами використання: Anthropic, GitHub Copilot, Gemini CLI, OpenAI Codex, MiniMax, Xiaomi і z.ai. Дані автентифікації для використання надходять із хуків, специфічних для провайдера, коли вони доступні; інакше OpenClaw використовує резервний варіант і зіставляє облікові дані OAuth/API-ключів із профілів автентифікації, змінних середовища або конфігурації. У виводі --json auth.providers — це огляд провайдера з урахуванням env/config/store, тоді як auth.oauth — це лише стан профілів сховища автентифікації. Додайте --probe, щоб виконати живі перевірки автентифікації для кожного налаштованого профілю провайдера. Перевірки — це реальні запити (можуть споживати токени та викликати обмеження частоти). Використовуйте --agent <id>, щоб перевірити стан моделі/автентифікації налаштованого агента. Якщо параметр не вказано, команда використовує OPENCLAW_AGENT_DIR/PI_CODING_AGENT_DIR, якщо їх задано, інакше — налаштованого агента за замовчуванням. Рядки перевірок можуть надходити з профілів автентифікації, облікових даних env або models.json.

Примітки:

• models set <model-or-alias> приймає provider/model або псевдонім.
• models list працює лише для читання: вона читає конфігурацію, профілі автентифікації, наявний стан каталогу та рядки каталогу, що належать провайдеру, але не переписує models.json.
• models list --all включає вбудовані статичні рядки каталогу, що належать провайдеру, навіть якщо ви ще не автентифікувалися в цього провайдера. Такі рядки все одно показуються як недоступні, доки не буде налаштовано відповідну автентифікацію.
• models list зберігає відокремленими власні метадані моделі та фактичні обмеження середовища виконання. У табличному виводі Ctx показує contextTokens/contextWindow, коли ефективне обмеження середовища виконання відрізняється від власного контекстного вікна; рядки JSON містять contextTokens, коли провайдер надає це обмеження.
• models list --provider <id> фільтрує за ідентифікатором провайдера, наприклад moonshot або openai-codex. Він не приймає відображувані мітки з інтерактивних засобів вибору провайдера, наприклад Moonshot AI.
• Посилання на моделі розбираються шляхом розділення за першим /. Якщо ідентифікатор моделі містить / (у стилі OpenRouter), вкажіть префікс провайдера (приклад: openrouter/moonshotai/kimi-k2).
• Якщо ви пропускаєте провайдера, OpenClaw спочатку визначає вхідне значення як псевдонім, потім — як унікальний збіг налаштованого провайдера для цього точного ідентифікатора моделі, і лише після цього використовує резервний варіант — налаштованого провайдера за замовчуванням — із попередженням про застарівання. Якщо цей провайдер більше не надає налаштовану модель за замовчуванням, OpenClaw використовує резервний варіант — першу налаштовану пару провайдер/модель — замість того, щоб показувати застаріле значення за замовчуванням для видаленого провайдера.
• models status може показувати marker(<value>) у виводі автентифікації для незасекречених заповнювачів (наприклад, OPENAI_API_KEY, secretref-managed, minimax-oauth, oauth:chutes, ollama-local) замість маскування їх як секретів.

models scan

models scan читає публічний каталог OpenRouter :free і ранжує кандидатів для використання як резервних варіантів. Сам каталог є публічним, тому сканування лише метаданих не потребує ключа OpenRouter.

За замовчуванням OpenClaw намагається перевірити підтримку інструментів і зображень за допомогою живих викликів моделей. Якщо ключ OpenRouter не налаштовано, команда використовує резервний варіант — вивід лише метаданих — і пояснює, що для моделей :free усе одно потрібен OPENROUTER_API_KEY для перевірок і висновування.

Параметри:

• --no-probe (лише метадані; без пошуку конфігурації/секретів)
• --min-params <b>
• --max-age-days <days>
• --provider <name>
• --max-candidates <n>
• --timeout <ms> (тайм-аут запиту до каталогу та тайм-аут кожної перевірки)
• --concurrency <n>
• --yes
• --no-input
• --set-default
• --set-image
• --json

--set-default і --set-image потребують живих перевірок; результати сканування лише метаданих є інформаційними й не застосовуються до конфігурації.

models status

Параметри:

• --json
• --plain
• --check (код виходу 1=прострочено/відсутнє, 2=незабаром спливає)
• --probe (жива перевірка налаштованих профілів автентифікації)
• --probe-provider <name> (перевірити одного провайдера)
• --probe-profile <id> (повторювані або розділені комами ідентифікатори профілів)
• --probe-timeout <ms>
• --probe-concurrency <n>
• --probe-max-tokens <n>
• --agent <id> (ідентифікатор налаштованого агента; перевизначає OPENCLAW_AGENT_DIR/PI_CODING_AGENT_DIR)

Категорії статусу перевірки:

• ok
• auth
• rate_limit
• billing
• timeout
• format
• unknown
• no_model

Варіанти detail/reason-code перевірки, яких слід очікувати:

• excluded_by_auth_order: збережений профіль існує, але явний auth.order.<provider> його пропустив, тому перевірка повідомляє про виключення замість спроби його використати.
• missing_credential, invalid_expires, expired, unresolved_ref: профіль присутній, але не підходить/не може бути визначений.
• no_model: автентифікація провайдера існує, але OpenClaw не зміг визначити придатного для перевірки кандидата моделі для цього провайдера.

Псевдоніми + резервні варіанти

openclaw models aliases list
openclaw models fallbacks list

Профілі автентифікації

openclaw models auth add
openclaw models auth login --provider <id>
openclaw models auth setup-token --provider <id>
openclaw models auth paste-token

models auth add — це інтерактивний помічник автентифікації. Він може запускати потік автентифікації провайдера (OAuth/API-ключ) або провести вас через ручне вставлення токена залежно від вибраного провайдера.

models auth login запускає потік автентифікації плагіна провайдера (OAuth/API-ключ). Використовуйте openclaw plugins list, щоб побачити, які провайдери встановлено.

Приклади:

openclaw models auth login --provider openai-codex --set-default

Примітки:

• setup-token і paste-token залишаються універсальними командами для роботи з токенами для провайдерів, які надають методи автентифікації через токен.
• setup-token вимагає інтерактивний TTY і запускає метод автентифікації через токен провайдера (за замовчуванням використовується метод setup-token цього провайдера, якщо він доступний).
• paste-token приймає рядок токена, згенерований в іншому місці або засобами автоматизації.
• paste-token вимагає --provider, запитує значення токена і записує його до ідентифікатора профілю за замовчуванням <provider>:manual, якщо ви не передасте --profile-id.
• paste-token --expires-in <duration> зберігає абсолютний строк дії токена на основі відносної тривалості, такої як 365d або 12h.
• Примітка щодо Anthropic: співробітники Anthropic повідомили нам, що використання Claude CLI у стилі OpenClaw знову дозволене, тому OpenClaw розглядає повторне використання Claude CLI та використання claude -p як санкціоновані для цієї інтеграції, якщо Anthropic не опублікує нову політику.
• Anthropic setup-token / paste-token залишаються доступними як підтримуваний шлях токена OpenClaw, але тепер OpenClaw надає перевагу повторному використанню Claude CLI і claude -p, коли це можливо.

Пов’язане

• Довідник CLI
• Вибір моделі
• Відмовостійкість моделей