openclaw/docs
openclaw/docs
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

chore(i18n): refresh uk translations

Browse Source
This commit is contained in:
openclaw-docs-i18n[bot] 2026-05-01 02:36:47 +00:00
parent 9e6c9daabe
commit d761adc8ab
1 changed files with 67 additions and 62 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

129
docs/uk/cli/models.md
View File

@ -1,26 +1,26 @@
---
read_when:
- Ви хочете змінити моделі за замовчуванням або переглянути статус автентифікації провайдера
- Ви хочете просканувати доступні моделі/провайдери й налагодити профілі автентифікації
- Ви хочете змінити моделі за замовчуванням або переглянути стан автентифікації провайдера
- Ви хочете просканувати доступні моделі/провайдерів і налагодити профілі автентифікації
summary: Довідник CLI для `openclaw models` (status/list/set/scan, псевдоніми, резервні варіанти, автентифікація)
title: Моделі
x-i18n:
generated_at: "2026-04-29T17:28:12Z"
generated_at: "2026-05-01T02:36:05Z"
model: gpt-5.5
provider: openai
source_hash: 95e2361989b583f7f52947dad1faaaba44dc6a5f58719cc2e83c13fce7c33adc
source_hash: 538d3e4808329737fdc044dc6e14e5c7c78052e75d8a8b3b257b1ebd821c84d1
source_path: cli/models.md
workflow: 16
---
# `openclaw models`
Виявлення, сканування та конфігурація моделей (модель за замовчуванням, резервні варіанти, профілі автентифікації).
Виявлення, сканування та налаштування моделей (модель за замовчуванням, резервні варіанти, профілі автентифікації).
Пов’язано:
- Провайдери + моделі: [Моделі](/uk/providers/models)
- Концепції вибору моделей + slash-команда `/models`: [Концепція моделей](/uk/concepts/models)
- Концепції вибору моделі + слеш-команда `/models`: [Концепція моделей](/uk/concepts/models)
- Налаштування автентифікації провайдера: [Початок роботи](/uk/start/getting-started)
## Поширені команди
@ -33,17 +33,17 @@ openclaw models scan
```
`openclaw models status` показує визначені значення за замовчуванням/резервні варіанти, а також огляд автентифікації.
Коли доступні знімки використання провайдерів, розділ стану OAuth/API-ключів містить
Коли доступні знімки використання провайдерів, розділ стану OAuth/API-ключів включає
вікна використання провайдерів і знімки квот.
Поточні провайдери вікон використання: Anthropic, GitHub Copilot, Gemini CLI, OpenAI
Codex, MiniMax, Xiaomi і z.ai. Автентифікація використання надходить із провайдерських хуків,
коли вони доступні; інакше OpenClaw повертається до відповідних облікових даних OAuth/API-ключів
із профілів автентифікації, env або конфігурації.
Codex, MiniMax, Xiaomi і z.ai. Автентифікація використання надходить із специфічних для провайдера хуків,
коли вони доступні; інакше OpenClaw повертається до відповідних OAuth/API-ключових
облікових даних із профілів автентифікації, env або конфігурації.
У виводі `--json` `auth.providers` — це огляд провайдерів з урахуванням env/config/store,
тоді як `auth.oauth` — лише стан профілів auth-store.
тоді як `auth.oauth` — лише стан профілю auth-store.
Додайте `--probe`, щоб запустити живі перевірки автентифікації для кожного налаштованого профілю провайдера.
Перевірки — це реальні запити (можуть споживати токени й запускати обмеження швидкості).
Використовуйте `--agent <id>`, щоб перевірити стан моделі/автентифікації налаштованого агента. Якщо опущено,
Використовуйте `--agent <id>`, щоб перевірити стан моделі/автентифікації налаштованого агента. Якщо параметр пропущено,
команда використовує `OPENCLAW_AGENT_DIR`/`PI_CODING_AGENT_DIR`, якщо задано, інакше
налаштованого агента за замовчуванням.
Рядки перевірок можуть надходити з профілів автентифікації, облікових даних env або `models.json`.
@ -51,49 +51,54 @@ Codex, MiniMax, Xiaomi і z.ai. Автентифікація використа
Примітки:
- `models set <model-or-alias>` приймає `provider/model` або псевдонім.
- `models list` лише читає дані: вона читає конфігурацію, профілі автентифікації, наявний стан каталогу
і рядки каталогу, якими володіє провайдер, але не переписує
- `models list` доступна лише для читання: вона читає конфігурацію, профілі автентифікації, наявний стан каталогу
і рядки каталогу, що належать провайдерам, але не переписує
`models.json`.
- Стовпець `Auth` є рівнем провайдера й доступний лише для читання. Він обчислюється з локальних
метаданих профілів автентифікації, маркерів env, налаштованих ключів провайдерів, маркерів локальних провайдерів,
маркерів AWS Bedrock env/profile і синтетичних метаданих автентифікації Plugin;
він не завантажує runtime провайдера, не читає секрети keychain, не викликає API провайдерів
і не доводить точну готовність виконання для кожної моделі.
- `models list --all --provider <id>` може містити статичні рядки каталогу, якими володіє провайдер,
із маніфестів Plugin або вбудованих метаданих каталогу провайдера, навіть якщо ви
метаданих профілю автентифікації, маркерів env, налаштованих ключів провайдерів, маркерів локальних провайдерів,
маркерів env/профілю AWS Bedrock і метаданих синтетичної автентифікації plugin;
він не завантажує runtime провайдера, не читає секрети зі сховища ключів, не викликає
API провайдера й не доводить точну готовність виконання для кожної моделі.
- `models list --all --provider <id>` може включати статичні рядки каталогу, що належать провайдерам,
із маніфестів plugin або вбудованих метаданих каталогу провайдерів, навіть якщо ви
ще не автентифікувалися в цього провайдера. Такі рядки все одно відображаються як
недоступні, доки не буде налаштовано відповідну автентифікацію.
- Широка команда `models list --all` об’єднує рядки каталогу з маніфестів поверх рядків реєстру
без завантаження провайдерських хуків runtime supplement. Швидкі шляхи маніфестів із фільтром за провайдером
- `models list` зберігає чутливість контрольної площини, поки виявлення каталогу провайдера
повільне. Подання за замовчуванням і налаштовані подання після короткого очікування повертаються до налаштованих або
синтетичних рядків моделей і дають виявленню завершитися у
фоні. Використовуйте `--all`, коли вам потрібен точний повний виявлений каталог і
ви готові чекати на виявлення провайдера.
- Широкий `models list --all` об’єднує рядки каталогу маніфестів поверх рядків реєстру
без завантаження хуків доповнення runtime провайдера. Швидкі шляхи маніфестів із фільтром за провайдером
використовують лише провайдерів, позначених як `static`; провайдери, позначені як `refreshable`,
залишаються на основі реєстру/кешу й додають рядки маніфесту як supplement, тоді як
залишаються підтриманими реєстром/кешем і додають рядки маніфесту як доповнення, тоді як
провайдери, позначені як `runtime`, залишаються на виявленні через реєстр/runtime.
- `models list` тримає власні метадані моделі й runtime-обмеження окремо. У табличному
виводі `Ctx` показує `contextTokens/contextWindow`, коли ефективне runtime-обмеження
відрізняється від власного контекстного вікна; JSON-рядки містять `contextTokens`,
коли провайдер надає таке обмеження.
- `models list --provider <id>` фільтрує за id провайдера, наприклад `moonshot` або
`openai-codex`. Вона не приймає відображувані мітки з інтерактивних вибірників провайдера,
наприклад `Moonshot AI`.
- `models list` тримає власні метадані моделі та обмеження runtime окремо. У табличному
виводі `Ctx` показує `contextTokens/contextWindow`, коли ефективне обмеження runtime
відрізняється від власного контекстного вікна; JSON-рядки включають `contextTokens`,
коли провайдер надає це обмеження.
- `models list --provider <id>` фільтрує за ідентифікатором провайдера, наприклад `moonshot` або
`openai-codex`. Вона не приймає відображувані назви з інтерактивних
вибирачів провайдерів, як-от `Moonshot AI`.
- Посилання на моделі розбираються поділом за **першим** `/`. Якщо ID моделі містить `/` (у стилі OpenRouter), додайте префікс провайдера (приклад: `openrouter/moonshotai/kimi-k2`).
- Якщо ви опустите провайдера, OpenClaw спершу визначає введення як псевдонім, потім
як унікальний збіг налаштованого провайдера для цього точного id моделі, і лише потім
- Якщо ви пропустите провайдера, OpenClaw спочатку визначає введення як псевдонім, потім
як унікальний збіг налаштованого провайдера для цього точного ID моделі, і лише потім
повертається до налаштованого провайдера за замовчуванням із попередженням про застарівання.
Якщо цей провайдер більше не надає налаштовану модель за замовчуванням, OpenClaw
повертається до першого налаштованого провайдера/моделі замість показу
застарілого значення за замовчуванням для вилученого провайдера.
повертається до першої налаштованої пари провайдер/модель замість показу
застарілого значення за замовчуванням для видаленого провайдера.
- `models status` може показувати `marker(<value>)` у виводі автентифікації для несекретних заповнювачів (наприклад `OPENAI_API_KEY`, `secretref-managed`, `minimax-oauth`, `oauth:chutes`, `ollama-local`) замість маскування їх як секретів.
### Сканування моделей
`models scan` читає публічний каталог OpenRouter `:free` і ранжує кандидатів для
використання як резервних. Сам каталог є публічним, тому сканування лише метаданих не потребує
використання як резервні варіанти. Сам каталог є публічним, тому сканування лише метаданих не потребують
ключа OpenRouter.
За замовчуванням OpenClaw намагається перевірити підтримку інструментів і зображень живими викликами моделі.
За замовчуванням OpenClaw намагається перевірити підтримку інструментів і зображень живими викликами моделей.
Якщо ключ OpenRouter не налаштовано, команда повертається до виводу лише метаданих
і пояснює, що моделі `:free` усе одно потребують `OPENROUTER_API_KEY` для
перевірок і inference.
і пояснює, що моделі `:free` все одно потребують `OPENROUTER_API_KEY` для
перевірок і інференсу.
Параметри:
@ -102,7 +107,7 @@ Codex, MiniMax, Xiaomi і z.ai. Автентифікація використа
- `--max-age-days <days>`
- `--provider <name>`
- `--max-candidates <n>`
- `--timeout <ms>` (запит каталогу й тайм-аут для кожної перевірки)
- `--timeout <ms>` (запит каталогу та тайм-аут для кожної перевірки)
- `--concurrency <n>`
- `--yes`
- `--no-input`
@ -110,8 +115,8 @@ Codex, MiniMax, Xiaomi і z.ai. Автентифікація використа
- `--set-image`
- `--json`
`--set-default` і `--set-image` потребують живих перевірок; результати сканування
лише метаданих є інформаційними й не застосовуються до конфігурації.
`--set-default` і `--set-image` потребують живих перевірок; результати сканування лише метаданих
є інформаційними й не застосовуються до конфігурації.
### Стан моделей
@ -119,20 +124,20 @@ Codex, MiniMax, Xiaomi і z.ai. Автентифікація використа
- `--json`
- `--plain`
- `--check` (код виходу 1=прострочено/відсутнє, 2=спливає)
- `--check` (код виходу 1=прострочено/відсутнє, 2=скоро спливає)
- `--probe` (жива перевірка налаштованих профілів автентифікації)
- `--probe-provider <name>` (перевірити одного провайдера)
- `--probe-profile <id>` (повторювані або розділені комами id профілів)
- `--probe-profile <id>` (повторювані або розділені комами ID профілів)
- `--probe-timeout <ms>`
- `--probe-concurrency <n>`
- `--probe-max-tokens <n>`
- `--agent <id>` (id налаштованого агента; перевизначає `OPENCLAW_AGENT_DIR`/`PI_CODING_AGENT_DIR`)
- `--agent <id>` (ID налаштованого агента; перевизначає `OPENCLAW_AGENT_DIR`/`PI_CODING_AGENT_DIR`)
`--json` залишає stdout зарезервованим для JSON-навантаження. Діагностика профілів автентифікації, провайдера
і запуску спрямовується до stderr, щоб скрипти могли напряму передавати stdout
`--json` залишає stdout зарезервованим для JSON-навантаження. Діагностика профілю автентифікації, провайдера
та запуску спрямовується до stderr, щоб скрипти могли напряму передавати stdout
в інструменти на кшталт `jq`.
Групи станів перевірки:
Кошики стану перевірок:
- `ok`
- `auth`
@ -143,15 +148,15 @@ Codex, MiniMax, Xiaomi і z.ai. Автентифікація використа
- `unknown`
- `no_model`
Очікувані випадки деталей/кодів причин перевірки:
Очікувані випадки деталей/кодів причин перевірок:
- `excluded_by_auth_order`: збережений профіль існує, але явний
`auth.order.<provider>` його пропустив, тому перевірка повідомляє про виключення замість
спроби використати його.
- `missing_credential`, `invalid_expires`, `expired`, `unresolved_ref`:
профіль присутній, але не придатний/не може бути визначений.
- `no_model`: автентифікація провайдера існує, але OpenClaw не зміг визначити придатного до перевірки
кандидата моделі для цього провайдера.
- `no_model`: автентифікація провайдера існує, але OpenClaw не зміг визначити кандидата моделі,
придатного для перевірки для цього провайдера.
## Псевдоніми + резервні варіанти
@ -169,14 +174,14 @@ openclaw models auth setup-token --provider <id>
openclaw models auth paste-token
```
`models auth add` — це інтерактивний помічник автентифікації. Він може запустити потік автентифікації провайдера
(OAuth/API-ключ) або провести вас до ручного вставлення токена, залежно від
вибраного провайдера.
`models auth add` — це інтерактивний помічник автентифікації. Він може запускати потік автентифікації провайдера
(OAuth/API-ключ) або спрямувати вас до ручного вставлення токена, залежно від
обраного провайдера.
`models auth login` запускає потік автентифікації провайдерського Plugin (OAuth/API-ключ). Використовуйте
`models auth login` запускає потік автентифікації provider plugin (OAuth/API-ключ). Використовуйте
`openclaw plugins list`, щоб побачити, які провайдери встановлено.
Використовуйте `openclaw models auth --agent <id> <subcommand>`, щоб записати результати автентифікації до
сховища конкретного налаштованого агента. Батьківський прапорець `--agent` враховується командами
сховища конкретного налаштованого агента. Батьківський прапорець `--agent` підтримується
`add`, `login`, `setup-token`, `paste-token` і `login-github-copilot`.
Приклади:
@ -190,18 +195,18 @@ openclaw models auth login --provider openai-codex --set-default
- `setup-token` і `paste-token` залишаються універсальними командами токенів для провайдерів,
які надають методи автентифікації токеном.
- `setup-token` потребує інтерактивного TTY і запускає метод token-auth провайдера
(за замовчуванням використовуючи метод `setup-token` цього провайдера, коли він його надає).
- `paste-token` приймає рядок токена, згенерований деінде або з автоматизації.
(за замовчуванням метод `setup-token` цього провайдера, коли він його надає).
- `paste-token` приймає рядок токена, згенерований в іншому місці або автоматизацією.
- `paste-token` потребує `--provider`, запитує значення токена й записує
його до id профілю за замовчуванням `<provider>:manual`, якщо ви не передасте
його до ID профілю за замовчуванням `<provider>:manual`, якщо не передано
`--profile-id`.
- `paste-token --expires-in <duration>` зберігає абсолютний час завершення дії токена з
відносної тривалості, наприклад `365d` або `12h`.
- Примітка Anthropic: співробітники Anthropic повідомили нам, що використання Claude CLI у стилі OpenClaw знову дозволене, тому OpenClaw вважає повторне використання Claude CLI і `claude -p` санкціонованими для цієї інтеграції, якщо Anthropic не опублікує нову політику.
- `paste-token --expires-in <duration>` зберігає абсолютний строк дії токена з
відносної тривалості, як-от `365d` або `12h`.
- Примітка Anthropic: співробітники Anthropic повідомили нам, що використання Claude CLI у стилі OpenClaw знову дозволене, тому OpenClaw вважає повторне використання Claude CLI і використання `claude -p` дозволеними для цієї інтеграції, якщо Anthropic не опублікує нову політику.
- Anthropic `setup-token` / `paste-token` залишаються доступними як підтримуваний шлях токенів OpenClaw, але OpenClaw тепер надає перевагу повторному використанню Claude CLI і `claude -p`, коли вони доступні.
## Пов’язано
- [Довідник CLI](/uk/cli)
- [Вибір моделі](/uk/concepts/model-providers)
- [Failover моделі](/uk/concepts/model-failover)
- [Аварійне перемикання моделі](/uk/concepts/model-failover)