diff --git a/docs/uk/cli/models.md b/docs/uk/cli/models.md index 64072df39..e6312c2e5 100644 --- a/docs/uk/cli/models.md +++ b/docs/uk/cli/models.md @@ -1,26 +1,26 @@ --- read_when: - - Ви хочете змінити типові моделі або переглянути стан автентифікації провайдера - - Ви хочете просканувати доступні моделі/провайдери та налагодити профілі автентифікації -summary: Довідник CLI для `openclaw models` (status/list/set/scan, псевдоніми, запасні варіанти, автентифікація) + - Ви хочете змінити моделі за замовчуванням або переглянути стан автентифікації провайдера + - Ви хочете просканувати доступні моделі/провайдерів і налагодити профілі автентифікації +summary: Довідник CLI для `openclaw models` (status/list/set/scan, псевдоніми, резервні варіанти, автентифікація) title: Моделі x-i18n: - generated_at: "2026-04-23T20:48:08Z" + generated_at: "2026-04-24T01:05:20Z" model: gpt-5.4 provider: openai - source_hash: d0d244da9793efc520827d35e7dbf8fd643b11d1bf52d0e202cf5c93e693e2bc + source_hash: b3cda32db9aa36527c30d8820ce76a94a4ae3e1294fdc850dc1d7948bfa90799 source_path: cli/models.md workflow: 15 --- # `openclaw models` -Виявлення, сканування та конфігурація моделей (типова модель, запасні варіанти, профілі автентифікації). +Виявлення моделей, сканування та конфігурація (модель за замовчуванням, резервні варіанти, профілі автентифікації). -Пов’язане: +Пов’язано: - Провайдери + моделі: [Моделі](/uk/providers/models) -- Концепції вибору моделі + slash-команда `/models`: [Концепція моделей](/uk/concepts/models) +- Концепції вибору моделей + slash-команда `/models`: [Концепція моделей](/uk/concepts/models) - Налаштування автентифікації провайдера: [Початок роботи](/uk/start/getting-started) ## Поширені команди @@ -32,39 +32,42 @@ openclaw models set openclaw models scan ``` -`openclaw models status` показує визначені типові/запасні варіанти, а також огляд автентифікації. -Коли доступні знімки використання провайдера, розділ стану OAuth/API key включає +`openclaw models status` показує визначені значення за замовчуванням/резервні варіанти, а також огляд автентифікації. +Коли доступні знімки використання провайдера, розділ стану OAuth/API-key містить вікна використання провайдера та знімки квот. Поточні провайдери з вікнами використання: Anthropic, GitHub Copilot, Gemini CLI, OpenAI -Codex, MiniMax, Xiaomi і z.ai. Автентифікація використання надходить зі -специфічних для провайдера хуків, коли вони доступні; інакше OpenClaw використовує запасний варіант, зіставляючи OAuth/API key +Codex, MiniMax, Xiaomi і z.ai. Автентифікація використання надходить зі специфічних для провайдера хуків, +коли вони доступні; інакше OpenClaw використовує резервний варіант і підбирає OAuth/API-key облікові дані з профілів автентифікації, env або config. -У виводі `--json` `auth.providers` — це огляд провайдерів -з урахуванням env/config/store, тоді як `auth.oauth` — це лише стан профілів сховища автентифікації. -Додайте `--probe`, щоб запустити живі перевірки автентифікації для кожного налаштованого профілю провайдера. -Перевірки — це реальні запити (можуть витрачати токени й активувати обмеження частоти). -Використовуйте `--agent `, щоб переглянути стан моделі/автентифікації налаштованого агента. Якщо параметр не вказано, -команда використовує `OPENCLAW_AGENT_DIR`/`PI_CODING_AGENT_DIR`, якщо вони встановлені, інакше — -налаштованого типового агента. -Рядки перевірки можуть походити з профілів автентифікації, облікових даних env або `models.json`. +У виводі `--json` `auth.providers` — це огляд провайдерів з урахуванням env/config/store, +тоді як `auth.oauth` — це лише стан профілів сховища автентифікації. +Додайте `--probe`, щоб виконати живі перевірки автентифікації для кожного налаштованого профілю провайдера. +Перевірки — це реальні запити (можуть витрачати токени й спричиняти обмеження частоти). +Використовуйте `--agent `, щоб переглянути стан моделі/автентифікації для налаштованого агента. Якщо параметр не вказано, +команда використовує `OPENCLAW_AGENT_DIR`/`PI_CODING_AGENT_DIR`, якщо вони задані, інакше — +налаштованого агента за замовчуванням. +Рядки перевірок можуть надходити з профілів автентифікації, облікових даних env або `models.json`. Примітки: - `models set ` приймає `provider/model` або псевдонім. -- `models list --all` включає статичні рядки каталогу вбудованих провайдерів, навіть - якщо ви ще не автентифікувалися в цього провайдера. Ці рядки все одно показуватимуться - як недоступні, доки не буде налаштовано відповідну автентифікацію. +- `models list` працює лише для читання: команда читає config, профілі автентифікації, наявний стан каталогу + і рядки каталогу, що належать провайдеру, але не переписує + `models.json`. +- `models list --all` включає вбудовані статичні рядки каталогу, що належать провайдеру, навіть + якщо ви ще не автентифікувалися в цього провайдера. Ці рядки все одно показуються як недоступні, + доки не буде налаштовано відповідну автентифікацію. - `models list --provider ` фільтрує за id провайдера, наприклад `moonshot` або - `openai-codex`. Він не приймає відображувані мітки з інтерактивних - засобів вибору провайдера, як-от `Moonshot AI`. -- Посилання на моделі аналізуються розбиттям за **першим** `/`. Якщо ID моделі містить `/` (у стилі OpenRouter), додайте префікс провайдера (приклад: `openrouter/moonshotai/kimi-k2`). -- Якщо ви не вказуєте провайдера, OpenClaw спочатку визначає введення як псевдонім, потім — - як унікальний збіг exact model id серед налаштованих провайдерів, і лише після цього - використовує запасний варіант — налаштований типовий провайдер — із попередженням про застарілість. - Якщо цей провайдер більше не надає налаштовану типову модель, OpenClaw - використовує запасний варіант — перший налаштований провайдер/модель — замість того, щоб показувати - застаріле типове значення від видаленого провайдера. -- `models status` може показувати `marker()` у виводі автентифікації для несекретних заповнювачів (наприклад `OPENAI_API_KEY`, `secretref-managed`, `minimax-oauth`, `oauth:chutes`, `ollama-local`) замість маскування їх як секретів. + `openai-codex`. Параметр не приймає відображувані мітки з інтерактивних засобів вибору провайдера, + наприклад `Moonshot AI`. +- Посилання на моделі розбираються шляхом поділу за **першим** `/`. Якщо ID моделі містить `/` (у стилі OpenRouter), додайте префікс провайдера (приклад: `openrouter/moonshotai/kimi-k2`). +- Якщо ви не вказали провайдера, OpenClaw спочатку визначає вхідне значення як псевдонім, потім — + як унікальний збіг серед налаштованих провайдерів для цього точного id моделі, і лише після цього + використовує резервний варіант — налаштованого провайдера за замовчуванням — із попередженням про застарілість. + Якщо цей провайдер більше не надає налаштовану модель за замовчуванням, OpenClaw + використовує резервний варіант — першу налаштовану пару provider/model — замість того, щоб показувати + застаріле значення за замовчуванням для видаленого провайдера. +- `models status` може показувати `marker()` у виводі автентифікації для несекретних заповнювачів (наприклад, `OPENAI_API_KEY`, `secretref-managed`, `minimax-oauth`, `oauth:chutes`, `ollama-local`) замість маскування їх як секретів. ### `models status` @@ -72,7 +75,7 @@ Codex, MiniMax, Xiaomi і z.ai. Автентифікація використа - `--json` - `--plain` -- `--check` (код виходу 1=прострочено/відсутнє, 2=скоро спливає) +- `--check` (код виходу 1=прострочено/відсутній, 2=скоро спливає) - `--probe` (жива перевірка налаштованих профілів автентифікації) - `--probe-provider ` (перевірити одного провайдера) - `--probe-profile ` (повторювані або розділені комами id профілів) @@ -92,17 +95,17 @@ Codex, MiniMax, Xiaomi і z.ai. Автентифікація використа - `unknown` - `no_model` -Варіанти деталей/кодів причин перевірки, на які варто очікувати: +Варіанти detail/reason-code перевірки, яких слід очікувати: - `excluded_by_auth_order`: збережений профіль існує, але явний `auth.order.` його пропустив, тому перевірка повідомляє про виключення замість спроби його використати. - `missing_credential`, `invalid_expires`, `expired`, `unresolved_ref`: - профіль присутній, але не відповідає вимогам/не може бути визначений. + профіль присутній, але не придатний/не може бути визначений. - `no_model`: автентифікація провайдера існує, але OpenClaw не зміг визначити придатну для перевірки модель-кандидат для цього провайдера. -## Псевдоніми + запасні варіанти +## Псевдоніми + резервні варіанти ```bash openclaw models aliases list @@ -118,14 +121,14 @@ openclaw models auth setup-token --provider openclaw models auth paste-token ``` -`models auth add` — це інтерактивний помічник автентифікації. Він може запустити потік автентифікації провайдера +`models auth add` — це інтерактивний помічник автентифікації. Він може запускати потік автентифікації провайдера (OAuth/API key) або провести вас через ручне вставлення токена, залежно від -обраного провайдера. +вибраного провайдера. `models auth login` запускає потік автентифікації Plugin провайдера (OAuth/API key). Використовуйте `openclaw plugins list`, щоб побачити, які провайдери встановлено. -Приклад: +Приклади: ```bash openclaw models auth login --provider openai-codex --set-default @@ -134,14 +137,14 @@ openclaw models auth login --provider openai-codex --set-default Примітки: - `setup-token` і `paste-token` залишаються універсальними командами для токенів для провайдерів, - які надають методи токенової автентифікації. -- `setup-token` вимагає інтерактивного TTY і запускає метод токенової автентифікації провайдера - (типово використовуючи метод `setup-token` цього провайдера, якщо він його надає). -- `paste-token` приймає рядок токена, згенерований в іншому місці або через автоматизацію. -- `paste-token` вимагає `--provider`, запитує значення токена та записує - його до типового id профілю `:manual`, якщо ви не передасте + які надають методи автентифікації через токен. +- `setup-token` вимагає інтерактивного TTY і запускає метод токен-автентифікації провайдера + (типово — метод `setup-token` цього провайдера, якщо він його надає). +- `paste-token` приймає рядок токена, згенерований в іншому місці або автоматизацією. +- `paste-token` вимагає `--provider`, запитує значення токена й записує + його до id профілю за замовчуванням `:manual`, якщо ви не передали `--profile-id`. -- `paste-token --expires-in ` зберігає абсолютний строк дії токена з - відносної тривалості, такої як `365d` або `12h`. +- `paste-token --expires-in ` зберігає абсолютний час спливання токена на основі + відносної тривалості, наприклад `365d` або `12h`. - Примітка щодо Anthropic: співробітники Anthropic повідомили нам, що використання Claude CLI у стилі OpenClaw знову дозволене, тому OpenClaw вважає повторне використання Claude CLI і використання `claude -p` санкціонованими для цієї інтеграції, якщо Anthropic не опублікує нову політику. -- `setup-token` / `paste-token` для Anthropic залишаються доступними як підтримуваний токеновий шлях OpenClaw, але тепер OpenClaw віддає перевагу повторному використанню Claude CLI і `claude -p`, коли це доступно. +- `setup-token` / `paste-token` для Anthropic залишаються доступними як підтримуваний шлях токенів OpenClaw, але тепер OpenClaw надає перевагу повторному використанню Claude CLI і `claude -p`, коли це доступно.