chore(i18n): refresh uk translations
This commit is contained in:
parent
062930e294
commit
448677fd38
@ -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)
|
||||
|
||||
Loading…
Reference in New Issue
Block a user