openclaw/docs

Fork 0

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

2026-04-24 01:05:56 +00:00

11 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-24T01:05:20Z	gpt-5.4	openai	b3cda32db9aa36527c30d8820ce76a94a4ae3e1294fdc850dc1d7948bfa90799	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-key містить вікна використання провайдера та знімки квот. Поточні провайдери з вікнами використання: Anthropic, GitHub Copilot, Gemini CLI, OpenAI Codex, MiniMax, Xiaomi і z.ai. Автентифікація використання надходить зі специфічних для провайдера хуків, коли вони доступні; інакше OpenClaw використовує резервний варіант і підбирає OAuth/API-key облікові дані з профілів автентифікації, env або config. У виводі --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 працює лише для читання: команда читає config, профілі автентифікації, наявний стан каталогу і рядки каталогу, що належать провайдеру, але не переписує models.json.
models list --all включає вбудовані статичні рядки каталогу, що належать провайдеру, навіть якщо ви ще не автентифікувалися в цього провайдера. Ці рядки все одно показуються як недоступні, доки не буде налаштовано відповідну автентифікацію.
models list --provider <id> фільтрує за id провайдера, наприклад moonshot або openai-codex. Параметр не приймає відображувані мітки з інтерактивних засобів вибору провайдера, наприклад Moonshot AI.
Посилання на моделі розбираються шляхом поділу за першим /. Якщо ID моделі містить / (у стилі OpenRouter), додайте префікс провайдера (приклад: openrouter/moonshotai/kimi-k2).
Якщо ви не вказали провайдера, OpenClaw спочатку визначає вхідне значення як псевдонім, потім — як унікальний збіг серед налаштованих провайдерів для цього точного id моделі, і лише після цього використовує резервний варіант — налаштованого провайдера за замовчуванням — із попередженням про застарілість. Якщо цей провайдер більше не надає налаштовану модель за замовчуванням, OpenClaw використовує резервний варіант — першу налаштовану пару provider/model — замість того, щоб показувати застаріле значення за замовчуванням для видаленого провайдера.
models status може показувати marker(<value>) у виводі автентифікації для несекретних заповнювачів (наприклад, OPENAI_API_KEY, secretref-managed, minimax-oauth, oauth:chutes, ollama-local) замість маскування їх як секретів.

`models status`

Параметри:

--json
--plain
--check (код виходу 1=прострочено/відсутній, 2=скоро спливає)
--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)

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

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 login --provider openai-codex --set-default