---
read_when:
    - Ви хочете змінити моделі за замовчуванням або переглянути стан автентифікації провайдера
    - Ви хочете просканувати доступні моделі/провайдерів і налагодити профілі автентифікації
summary: Довідник CLI для `openclaw models` (status/list/set/scan, псевдоніми, резервні варіанти, автентифікація)
title: Моделі
x-i18n:
    generated_at: "2026-04-24T01:05:20Z"
    model: gpt-5.4
    provider: openai
    source_hash: b3cda32db9aa36527c30d8820ce76a94a4ae3e1294fdc850dc1d7948bfa90799
    source_path: cli/models.md
    workflow: 15
---

# `openclaw models`

Виявлення моделей, сканування та конфігурація (модель за замовчуванням, резервні варіанти, профілі автентифікації).

Пов’язано:

- Провайдери + моделі: [Моделі](/uk/providers/models)
- Концепції вибору моделей + slash-команда `/models`: [Концепція моделей](/uk/concepts/models)
- Налаштування автентифікації провайдера: [Початок роботи](/uk/start/getting-started)

## Поширені команди

```bash
openclaw models status
openclaw models list
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`, щоб виконати живі перевірки автентифікації для кожного налаштованого профілю провайдера.
Перевірки — це реальні запити (можуть витрачати токени й спричиняти обмеження частоти).
Використовуйте `--agent <id>`, щоб переглянути стан моделі/автентифікації для налаштованого агента. Якщо параметр не вказано,
команда використовує `OPENCLAW_AGENT_DIR`/`PI_CODING_AGENT_DIR`, якщо вони задані, інакше —
налаштованого агента за замовчуванням.
Рядки перевірок можуть надходити з профілів автентифікації, облікових даних env або `models.json`.

Примітки:

- `models set <model-or-alias>` приймає `provider/model` або псевдонім.
- `models list` працює лише для читання: команда читає config, профілі автентифікації, наявний стан каталогу
  і рядки каталогу, що належать провайдеру, але не переписує
  `models.json`.
- `models list --all` включає вбудовані статичні рядки каталогу, що належать провайдеру, навіть
  якщо ви ще не автентифікувалися в цього провайдера. Ці рядки все одно показуються як недоступні,
  доки не буде налаштовано відповідну автентифікацію.
- `models list --provider <id>` фільтрує за id провайдера, наприклад `moonshot` або
  `openai-codex`. Параметр не приймає відображувані мітки з інтерактивних засобів вибору провайдера,
  наприклад `Moonshot AI`.
- Посилання на моделі розбираються шляхом поділу за **першим** `/`. Якщо ID моделі містить `/` (у стилі OpenRouter), додайте префікс провайдера (приклад: `openrouter/moonshotai/kimi-k2`).
- Якщо ви не вказали провайдера, OpenClaw спочатку визначає вхідне значення як псевдонім, потім —
  як унікальний збіг серед налаштованих провайдерів для цього точного id моделі, і лише після цього
  використовує резервний варіант — налаштованого провайдера за замовчуванням — із попередженням про застарілість.
  Якщо цей провайдер більше не надає налаштовану модель за замовчуванням, OpenClaw
  використовує резервний варіант — першу налаштовану пару provider/model — замість того, щоб показувати
  застаріле значення за замовчуванням для видаленого провайдера.
- `models status` може показувати `marker(<value>)` у виводі автентифікації для несекретних заповнювачів (наприклад, `OPENAI_API_KEY`, `secretref-managed`, `minimax-oauth`, `oauth:chutes`, `ollama-local`) замість маскування їх як секретів.

### `models status`

Параметри:

- `--json`
- `--plain`
- `--check` (код виходу 1=прострочено/відсутній, 2=скоро спливає)
- `--probe` (жива перевірка налаштованих профілів автентифікації)
- `--probe-provider <name>` (перевірити одного провайдера)
- `--probe-profile <id>` (повторювані або розділені комами id профілів)
- `--probe-timeout <ms>`
- `--probe-concurrency <n>`
- `--probe-max-tokens <n>`
- `--agent <id>` (id налаштованого агента; перевизначає `OPENCLAW_AGENT_DIR`/`PI_CODING_AGENT_DIR`)

Категорії стану перевірки:

- `ok`
- `auth`
- `rate_limit`
- `billing`
- `timeout`
- `format`
- `unknown`
- `no_model`

Варіанти detail/reason-code перевірки, яких слід очікувати:

- `excluded_by_auth_order`: збережений профіль існує, але явний
  `auth.order.<provider>` його пропустив, тому перевірка повідомляє про виключення замість
  спроби його використати.
- `missing_credential`, `invalid_expires`, `expired`, `unresolved_ref`:
  профіль присутній, але не придатний/не може бути визначений.
- `no_model`: автентифікація провайдера існує, але OpenClaw не зміг визначити
  придатну для перевірки модель-кандидат для цього провайдера.

## Псевдоніми + резервні варіанти

```bash
openclaw models aliases list
openclaw models fallbacks list
```

## Профілі автентифікації

```bash
openclaw models auth add
openclaw models auth login --provider <id>
openclaw models auth setup-token --provider <id>
openclaw models auth paste-token
```

`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
```

Примітки:

- `setup-token` і `paste-token` залишаються універсальними командами для токенів для провайдерів,
  які надають методи автентифікації через токен.
- `setup-token` вимагає інтерактивного TTY і запускає метод токен-автентифікації провайдера
  (типово — метод `setup-token` цього провайдера, якщо він його надає).
- `paste-token` приймає рядок токена, згенерований в іншому місці або автоматизацією.
- `paste-token` вимагає `--provider`, запитує значення токена й записує
  його до id профілю за замовчуванням `<provider>:manual`, якщо ви не передали
  `--profile-id`.
- `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`, коли це доступно.
