openclaw/docs

Fork 0

openclaw-docs-i18n[bot] 23b2a97c59 chore(i18n): refresh uk translations

2026-04-28 02:12:13 +00:00

15 KiB

Raw Blame History

read_when

summary

title

x-i18n

Ви хочете змінити моделі за замовчуванням або переглянути стан автентифікації провайдера

Ви хочете просканувати доступні моделі/провайдерів і налагодити профілі автентифікації

Довідка CLI для `openclaw models` (status/list/set/scan, псевдоніми, резервні варіанти, автентифікація)

Моделі

generated_at	model	provider	source_hash	source_path	workflow
2026-04-28T02:07:56Z	gpt-5.4	openai	1bcbdaea238068441c0c8ff50c662d6b3e0f6c12dcf606bc1a3b52c1d71601ba	cli/models.md	15

`openclaw models`

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

Пов’язане:

Провайдери + моделі: Моделі
Концепції вибору моделей + slash-команда /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 --provider <id> може включати статичні рядки каталогу, що належать провайдеру, з маніфестів Plugin або вбудованих метаданих каталогу провайдера, навіть якщо ви ще не автентифікувалися у цього провайдера. Такі рядки все одно показуються як недоступні, доки не буде налаштовано відповідну автентифікацію.
Широкий models list --all об’єднує рядки каталогу маніфестів поверх рядків реєстру без завантаження runtime-хуків доповнення провайдера. Швидкі шляхи маніфестів із фільтрацією за провайдером використовують лише провайдерів, позначених як static; провайдери, позначені як refreshable, залишаються прив’язаними до реєстру/кешу та додають рядки маніфесту як доповнення, тоді як провайдери, позначені як runtime, залишаються на пошуку через реєстр/runtime.
models list зберігає власні метадані моделі та runtime-обмеження окремо. У табличному виводі Ctx показує contextTokens/contextWindow, коли ефективне runtime-обмеження відрізняється від власного контекстного вікна; рядки JSON включають contextTokens, коли провайдер надає таке обмеження.
models list --provider <id> фільтрує за ідентифікатором провайдера, наприклад moonshot або openai-codex. Він не приймає відображувані мітки з інтерактивних засобів вибору провайдера, наприклад Moonshot AI.
Посилання на моделі розбираються шляхом поділу за першим /. Якщо ID моделі містить / (у стилі OpenRouter), додайте префікс провайдера (приклад: openrouter/moonshotai/kimi-k2).
Якщо ви не вказали провайдера, OpenClaw спочатку розпізнає введення як псевдонім, потім — як унікальний збіг точного ID моделі серед налаштованих провайдерів, і лише після цього використовує резервний варіант у вигляді налаштованого провайдера за замовчуванням із попередженням про застарівання. Якщо цей провайдер більше не надає налаштовану модель за замовчуванням, OpenClaw використовує резервний варіант — першу налаштовану пару провайдер/модель — замість того, щоб показувати застаріле значення за замовчуванням для видаленого провайдера.
models status може показувати marker(<value>) у виводі автентифікації для незасекречених плейсхолдерів (наприклад, OPENAI_API_KEY, secretref-managed, minimax-oauth, oauth:chutes, ollama-local) замість маскування їх як секретів.

Сканування моделей

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

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

Параметри:

--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 потребують живих перевірок; результати сканування лише за метаданими мають інформаційний характер і не застосовуються до конфігурації.

Стан моделей

Параметри:

--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)

--json зберігає stdout лише для JSON-корисного навантаження. Діагностика профілів автентифікації, провайдерів і запуску спрямовується до stderr, щоб скрипти могли напряму передавати stdout в інструменти на кшталт jq.

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

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 key) або провести вас через ручне вставлення токена — залежно від того, якого провайдера ви виберете.

models auth login запускає потік автентифікації Plugin провайдера (OAuth/API key). Використовуйте openclaw plugins list, щоб побачити, які провайдери встановлено. Використовуйте openclaw models auth --agent <id> <subcommand>, щоб записати результати автентифікації до сховища конкретного налаштованого агента. Батьківський прапорець --agent підтримується в add, login, setup-token, paste-token і login-github-copilot.

Приклади:

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