diff --git a/docs/uk/cli/models.md b/docs/uk/cli/models.md index 9e6ab36a6..ae5706c72 100644 --- a/docs/uk/cli/models.md +++ b/docs/uk/cli/models.md @@ -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 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 `, щоб перевірити стан моделі/автентифікації налаштованого агента. Якщо параметр не вказано, команда використовує `OPENCLAW_AGENT_DIR`/`PI_CODING_AGENT_DIR`, якщо вони задані, інакше — -налаштованого агента за замовчуванням. -Рядки перевірки можуть надходити з профілів автентифікації, облікових даних env або `models.json`. +налаштованого типового агента. +Рядки перевірок можуть походити з профілів автентифікації, облікових даних env або `models.json`. -Примітки: +Нотатки: - `models set ` приймає `provider/model` або псевдонім. -- `models list` — лише для читання: команда читає config, профілі автентифікації, наявний стан каталогу - і рядки каталогу, що належать провайдеру, але не переписує +- `models list` працює лише для читання: вона читає config, профілі автентифікації, наявний стан каталогу + та рядки каталогу, що належать постачальнику, але не перезаписує `models.json`. -- `models list --all --provider ` може включати статичні рядки каталогу, - що належать провайдеру, з маніфестів Plugin або вбудованих метаданих каталогу провайдера, навіть якщо ви - ще не пройшли автентифікацію в цього провайдера. Такі рядки все одно показуються як +- `models list --all --provider ` може включати статичні рядки каталогу, що належать постачальнику, + з маніфестів Plugin або вбудованих метаданих каталогу постачальника, навіть якщо ви + ще не пройшли автентифікацію в цього постачальника. Такі рядки все одно показуються як недоступні, доки не буде налаштовано відповідну автентифікацію. -- `models list` зберігає окремо власні метадані моделі та обмеження виконання. У табличному - виводі `Ctx` показує `contextTokens/contextWindow`, коли ефективне обмеження виконання - відрізняється від власного контекстного вікна; рядки JSON включають `contextTokens`, - коли провайдер показує це обмеження. -- `models list --provider ` фільтрує за ідентифікатором провайдера, наприклад `moonshot` або - `openai-codex`. Команда не приймає відображувані мітки з інтерактивних засобів - вибору провайдера, наприклад `Moonshot AI`. -- Посилання на моделі аналізуються розділенням за **першим** `/`. Якщо ідентифікатор моделі містить `/` (у стилі OpenRouter), додайте префікс провайдера (приклад: `openrouter/moonshotai/kimi-k2`). -- Якщо ви не вказуєте провайдера, OpenClaw спочатку зіставляє введення як псевдонім, потім — - як унікальний збіг налаштованого провайдера для цього точного ідентифікатора моделі, і лише після цього - використовує запасний варіант — налаштованого провайдера за замовчуванням із попередженням про застарівання. - Якщо цей провайдер більше не показує налаштовану модель за замовчуванням, OpenClaw - використовує запасний варіант — перший налаштований провайдер/модель, замість того щоб показувати - застаріле значення за замовчуванням для видаленого провайдера. -- `models status` може показувати `marker()` у виводі автентифікації для незасекречених заповнювачів (наприклад `OPENAI_API_KEY`, `secretref-managed`, `minimax-oauth`, `oauth:chutes`, `ollama-local`) замість маскування їх як секретів. +- `models list` зберігає окремо рідні метадані моделі та обмеження середовища виконання. У табличному + виводі `Ctx` показує `contextTokens/contextWindow`, коли ефективне обмеження середовища виконання + відрізняється від рідного контекстного вікна; рядки JSON включають `contextTokens`, + коли постачальник надає це обмеження. +- `models list --provider ` фільтрує за id постачальника, наприклад `moonshot` або + `openai-codex`. Він не приймає відображувані мітки з інтерактивних засобів вибору постачальника, + наприклад `Moonshot AI`. +- Посилання на моделі розбираються шляхом поділу за **першим** `/`. Якщо ID моделі містить `/` (у стилі OpenRouter), додайте префікс постачальника (приклад: `openrouter/moonshotai/kimi-k2`). +- Якщо ви пропускаєте постачальника, OpenClaw спочатку визначає вхідне значення як псевдонім, потім — + як унікальний збіг точного id моделі серед налаштованих постачальників, і лише після цього + використовує резервний варіант — налаштованого типового постачальника — з попередженням про застарілість. + Якщо цей постачальник більше не надає налаштовану типову модель, OpenClaw + використовує резервний варіант і переходить до першого налаштованого постачальника/моделі замість показу + застарілого типового значення від видаленого постачальника. +- `models status` може показувати `marker()` у виводі автентифікації для незасекречених заповнювачів (наприклад, `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 ` - `--max-age-days ` - `--provider ` - `--max-candidates ` -- `--timeout ` (тайм-аут запиту каталогу та тайм-аут для кожної перевірки) +- `--timeout ` (тайм-аут запиту каталогу та тайм-аут кожної перевірки) - `--concurrency ` - `--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 ` (перевірити одного провайдера) -- `--probe-profile ` (повторювані або розділені комами ідентифікатори профілів) +- `--probe-provider ` (перевірити одного постачальника) +- `--probe-profile ` (повторювані або id профілів, розділені комами) - `--probe-timeout ` - `--probe-concurrency ` - `--probe-max-tokens ` -- `--agent ` (ідентифікатор налаштованого агента; має пріоритет над `OPENCLAW_AGENT_DIR`/`PI_CODING_AGENT_DIR`) +- `--agent ` (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.` його пропустив, тому перевірка повідомляє про це виключення замість - спроби використати його. + `auth.order.` його пропустив, тому перевірка повідомляє про виключення замість + спроби його використати. - `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 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 `, щоб записати результати автентифікації до +сховища конкретного налаштованого агента. Батьківський прапорець `--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`, запитує значення токена й записує - його до ідентифікатора профілю за замовчуванням `:manual`, якщо ви не передасте +- `setup-token` і `paste-token` залишаються універсальними командами для токенів для постачальників, + які надають методи автентифікації за токеном. +- `setup-token` потребує інтерактивного TTY і запускає метод автентифікації постачальника за токеном + (типово використовуючи метод `setup-token` цього постачальника, якщо він його надає). +- `paste-token` приймає рядок токена, створений деінде або автоматизацією. +- `paste-token` потребує `--provider`, запитує значення токена та записує + його до типового id профілю `:manual`, якщо ви не передасте `--profile-id`. -- `paste-token --expires-in ` зберігає абсолютний строк дії токена на основі +- `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`, коли це доступно. +- Нотатка щодо 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)