chore(i18n): refresh uk translations

This commit is contained in:
openclaw-docs-i18n[bot] 2026-04-26 04:34:41 +00:00
parent 062930e294
commit 448677fd38

View File

@ -1,27 +1,27 @@
---
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-26T03:54:37Z"
generated_at: "2026-04-26T04:34:04Z"
model: gpt-5.4
provider: openai
source_hash: 48558dbd8a753f634e4675922ea3e4f01540f6e8ad5dd0049449bf9df3738e73
source_hash: a5acf5972251ee7aa22d1f9222f1a497822fb1f25f29f827702f8b37dda8dadf
source_path: cli/models.md
workflow: 15
---
# `openclaw models`
Виявлення моделей, сканування та конфігурація (модель за замовчуванням, запасні варіанти, профілі автентифікації).
Виявлення моделей, сканування та конфігурація (типова модель, резервні варіанти, профілі автентифікації).
Пов’язано:
- Провайдери + моделі: [Моделі](/uk/providers/models)
- Концепції вибору моделей + слеш-команда `/models`: [Концепція моделей](/uk/concepts/models)
- Налаштування автентифікації провайдера: [Початок роботи](/uk/start/getting-started)
- Постачальники + моделі: [Моделі](/uk/providers/models)
- Концепції вибору моделі + слеш-команда `/models`: [Концепція моделей](/uk/concepts/models)
- Налаштування автентифікації постачальника: [Початок роботи](/uk/start/getting-started)
## Поширені команди
@ -32,66 +32,66 @@ 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`, щоб виконати живі перевірки автентифікації для кожного налаштованого профілю провайдера.
Перевірки — це реальні запити (можуть витрачати токени та спричиняти обмеження швидкості).
`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`.
налаштованого типового агента.
Рядки перевірок можуть походити з профілів автентифікації, облікових даних env або `models.json`.
Примітки:
Нотатки:
- `models set <model-or-alias>` приймає `provider/model` або псевдонім.
- `models list` — лише для читання: команда читає config, профілі автентифікації, наявний стан каталогу
і рядки каталогу, що належать провайдеру, але не переписує
- `models list` працює лише для читання: вона читає config, профілі автентифікації, наявний стан каталогу
та рядки каталогу, що належать постачальнику, але не перезаписує
`models.json`.
- `models list --all --provider <id>` може включати статичні рядки каталогу,
що належать провайдеру, з маніфестів Plugin або вбудованих метаданих каталогу провайдера, навіть якщо ви
ще не пройшли автентифікацію в цього провайдера. Такі рядки все одно показуються як
- `models list --all --provider <id>` може включати статичні рядки каталогу, що належать постачальнику,
з маніфестів Plugin або вбудованих метаданих каталогу постачальника, навіть якщо ви
ще не пройшли автентифікацію в цього постачальника. Такі рядки все одно показуються як
недоступні, доки не буде налаштовано відповідну автентифікацію.
- `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 list` зберігає окремо рідні метадані моделі та обмеження середовища виконання. У табличному
виводі `Ctx` показує `contextTokens/contextWindow`, коли ефективне обмеження середовища виконання
відрізняється від рідного контекстного вікна; рядки 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`
`models scan` читає публічний каталог OpenRouter `:free` і ранжує кандидатів для
використання як запасних варіантів. Сам каталог є публічним, тому сканування лише метаданих не потребує
використання як резервних варіантів. Сам каталог є публічним, тому сканування лише метаданих не потребує
ключа OpenRouter.
За замовчуванням OpenClaw намагається перевірити підтримку інструментів і зображень за допомогою живих викликів моделі.
Якщо ключ OpenRouter не налаштовано, команда використовує запасний варіант — вивід лише метаданих — і пояснює, що для моделей `:free` усе одно потрібен `OPENROUTER_API_KEY` для
перевірок і висновку.
Типово OpenClaw намагається перевірити підтримку інструментів і зображень за допомогою живих викликів моделі.
Якщо ключ OpenRouter не налаштовано, команда використовує резервний варіант — вивід лише метаданих — і пояснює, що для
перевірок та inference моделей `:free` усе одно потрібен `OPENROUTER_API_KEY`.
Параметри:
- `--no-probe` (лише метадані; без пошуку в config/secret)
- `--no-probe` (лише метадані; без пошуку config/секретів)
- `--min-params <b>`
- `--max-age-days <days>`
- `--provider <name>`
- `--max-candidates <n>`
- `--timeout <ms>` (тайм-аут запиту каталогу та тайм-аут для кожної перевірки)
- `--timeout <ms>` (тайм-аут запиту каталогу та тайм-аут кожної перевірки)
- `--concurrency <n>`
- `--yes`
- `--no-input`
@ -99,8 +99,8 @@ OAuth/API key з профілів автентифікації, env або confi
- `--set-image`
- `--json`
`--set-default` і `--set-image` потребують живих перевірок; результати сканування лише метаданих
є інформаційними й не застосовуються до config.
`--set-default` і `--set-image` потребують живих перевірок; результати сканування
лише за метаданими мають інформаційний характер і не застосовуються до config.
### `models status`
@ -108,16 +108,16 @@ OAuth/API key з профілів автентифікації, env або confi
- `--json`
- `--plain`
- `--check` (код виходу 1=прострочено/відсутній, 2=скоро спливає)
- `--check` (код виходу 1=прострочено/відсутнє, 2=скоро спливає)
- `--probe` (жива перевірка налаштованих профілів автентифікації)
- `--probe-provider <name>` (перевірити одного провайдера)
- `--probe-profile <id>` (повторювані або розділені комами ідентифікатори профілів)
- `--probe-provider <name>` (перевірити одного постачальника)
- `--probe-profile <id>` (повторювані або id профілів, розділені комами)
- `--probe-timeout <ms>`
- `--probe-concurrency <n>`
- `--probe-max-tokens <n>`
- `--agent <id>` (ідентифікатор налаштованого агента; має пріоритет над `OPENCLAW_AGENT_DIR`/`PI_CODING_AGENT_DIR`)
- `--agent <id>` (id налаштованого агента; перевизначає `OPENCLAW_AGENT_DIR`/`PI_CODING_AGENT_DIR`)
Категорії стану перевірки:
Категорії стану перевірок:
- `ok`
- `auth`
@ -128,17 +128,17 @@ OAuth/API key з профілів автентифікації, env або confi
- `unknown`
- `no_model`
Випадки деталей/кодів причин перевірки, на які варто очікувати:
Випадки detail/reason-code перевірок, яких слід очікувати:
- `excluded_by_auth_order`: збережений профіль існує, але явний
`auth.order.<provider>` його пропустив, тому перевірка повідомляє про це виключення замість
спроби використати його.
`auth.order.<provider>` його пропустив, тому перевірка повідомляє про виключення замість
спроби його використати.
- `missing_credential`, `invalid_expires`, `expired`, `unresolved_ref`:
профіль наявний, але не відповідає вимогам/не може бути зіставлений.
- `no_model`: автентифікація провайдера існує, але OpenClaw не зміг зіставити
кандидата моделі цього провайдера, який можна перевірити.
профіль присутній, але не придатний/не може бути визначений.
- `no_model`: автентифікація постачальника існує, але OpenClaw не зміг визначити
придатного кандидата моделі для перевірки для цього постачальника.
## Псевдоніми + запасні варіанти
## Псевдоніми + резервні варіанти
```bash
openclaw models aliases list
@ -154,12 +154,15 @@ openclaw models auth setup-token --provider <id>
openclaw models auth paste-token
```
`models auth add` — це інтерактивний помічник автентифікації. Він може запускати потік автентифікації провайдера
(OAuth/API key) або провести вас через ручне вставлення токена залежно від
вибраного провайдера.
`models auth add` — це інтерактивний помічник автентифікації. Він може запускати потік автентифікації постачальника
(OAuth/API key) або провести вас через ручне вставлення токена, залежно від
вибраного постачальника.
`models auth login` запускає потік автентифікації Plugin провайдера (OAuth/API key). Використовуйте
`openclaw plugins list`, щоб побачити, які провайдери встановлено.
`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`.
Приклад:
@ -167,23 +170,23 @@ openclaw models auth paste-token
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`, якщо ви не передасте
- `setup-token` і `paste-token` залишаються універсальними командами для токенів для постачальників,
які надають методи автентифікації за токеном.
- `setup-token` потребує інтерактивного TTY і запускає метод автентифікації постачальника за токеном
(типово використовуючи метод `setup-token` цього постачальника, якщо він його надає).
- `paste-token` приймає рядок токена, створений деінде або автоматизацією.
- `paste-token` потребує `--provider`, запитує значення токена та записує
його до типового id профілю `<provider>:manual`, якщо ви не передасте
`--profile-id`.
- `paste-token --expires-in <duration>` зберігає абсолютний строк дії токена на основі
- `paste-token --expires-in <duration>` зберігає абсолютний час спливання токена на основі
відносної тривалості, наприклад `365d` або `12h`.
- Примітка щодо Anthropic: співробітники Anthropic повідомили нам, що використання Claude CLI у стилі OpenClaw знову дозволено, тому OpenClaw вважає повторне використання Claude CLI і використання `claude -p` санкціонованими для цієї інтеграції, якщо Anthropic не опублікує нову політику.
- `setup-token` / `paste-token` Anthropic залишаються доступними як підтримуваний шлях токена OpenClaw, але тепер OpenClaw надає перевагу повторному використанню Claude CLI і `claude -p`, коли це доступно.
- Нотатка щодо Anthropic: співробітники Anthropic повідомили нам, що використання Claude CLI у стилі OpenClaw знову дозволене, тому OpenClaw вважає повторне використання Claude CLI та `claude -p` санкціонованими для цієї інтеграції, якщо Anthropic не опублікує нову політику.
- `setup-token` / `paste-token` для Anthropic залишаються доступними як підтримуваний шлях токенів OpenClaw, але тепер OpenClaw надає перевагу повторному використанню Claude CLI та `claude -p`, коли це можливо.
## Пов’язано
- [Довідник CLI](/uk/cli)
- [Вибір моделі](/uk/concepts/model-providers)
- [Перемикання моделі при збої](/uk/concepts/model-failover)
- [Відмовостійкість моделей](/uk/concepts/model-failover)