openclaw/docs

Fork 0

openclaw-docs-i18n[bot] 16876e94f8 chore(i18n): refresh uk translations

2026-05-04 10:48:29 +00:00

16 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-05-04T10:47:48Z	gpt-5.5	openai	dc7842f02e29aa0ac2ae88f3d42bba71f1890a58ab22d818dbee0585bc562fea	cli/models.md	16

`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-ключа з профілів автентифікації, env або конфігурації. У виводі --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.
Стовпець Auth є рівня провайдера та доступний лише для читання. Він обчислюється з локальних метаданих профілю автентифікації, маркерів env, налаштованих ключів провайдера, маркерів локального провайдера, маркерів env/profile AWS Bedrock і метаданих синтетичної автентифікації Plugin; він не завантажує runtime провайдера, не читає секрети keychain, не викликає API провайдера і не доводить точну готовність виконання для кожної моделі.
models list --all --provider <id> може містити статичні рядки каталогу, що належать провайдеру, з маніфестів Plugin або bundled метаданих каталогу провайдера, навіть якщо ви ще не автентифікувалися в цього провайдера. Такі рядки все одно показуються як недоступні, доки не буде налаштовано відповідну автентифікацію.
models list зберігає швидкодію контрольної площини, коли виявлення каталогу провайдера повільне. Подання за замовчуванням і налаштовані подання повертаються до налаштованих або синтетичних рядків моделей після короткого очікування й дозволяють виявленню завершитися у фоновому режимі. Використовуйте --all, коли вам потрібен точний повний виявлений каталог і ви готові чекати на виявлення провайдера.
Широке models list --all об’єднує рядки каталогу маніфесту поверх рядків реєстру без завантаження додаткових хуків runtime провайдера. Швидкі шляхи маніфесту з фільтром за провайдером використовують лише провайдерів, позначених static; провайдери, позначені refreshable, залишаються на основі реєстру/кешу й додають рядки маніфесту як доповнення, тоді як провайдери, позначені runtime, залишаються на виявленні реєстру/runtime.
models list тримає власні метадані моделі та обмеження runtime окремими. У табличному виводі Ctx показує contextTokens/contextWindow, коли ефективне обмеження runtime відрізняється від власного контекстного вікна; рядки JSON містять contextTokens, коли провайдер надає це обмеження.
models list --provider <id> фільтрує за 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 (exit 1=expired/missing, 2=expiring)
--probe (жива перевірка налаштованих профілів автентифікації)
--probe-provider <name> (перевірити одного провайдера)
--probe-profile <id> (повторювані або розділені комами id профілів)
--probe-timeout <ms>
--probe-concurrency <n>
--probe-max-tokens <n>
--agent <id> (id налаштованого агента; перевизначає OPENCLAW_AGENT_DIR/PI_CODING_AGENT_DIR)

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

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

ok
auth
rate_limit
billing
timeout
format
unknown
no_model

Очікувані випадки деталей перевірки/кодів причини:

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 list [--provider <id>] [--json]
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 list перелічує збережені профілі автентифікації для вибраного агента без друку токена, API-ключа або секретного матеріалу OAuth. Використовуйте --provider <id>, щоб відфільтрувати одного провайдера, наприклад openai-codex, і --json для скриптів.

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

Приклади:

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