---
read_when:
    - Вы хотите изменить модели по умолчанию или посмотреть состояние аутентификации провайдера
    - Вы хотите просканировать доступные модели/провайдеров и отладить профили аутентификации
summary: Справочник CLI для `openclaw models` (status/list/set/scan, псевдонимы, резервные варианты, аутентификация)
title: Модели
x-i18n:
    generated_at: "2026-06-28T22:44:33Z"
    model: gpt-5.5
    postprocess_version: locale-links-v1
    provider: openai
    source_hash: 15d0a01e0f8f971996359413306a1c694e5a787eaef69b13eb8ac63c2a7c8990
    source_path: cli/models.md
    workflow: 16
---

# `openclaw models`

Обнаружение, сканирование и настройка моделей (модель по умолчанию, резервные варианты, профили аутентификации).

Связано:

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

## Распространенные команды

```bash
openclaw models status
openclaw models list
openclaw models set <model-or-alias>
openclaw models scan
```

`openclaw models status` показывает разрешенные модель по умолчанию и резервные варианты, а также обзор аутентификации.
Когда доступны снимки использования провайдеров, раздел статуса OAuth/API-ключей включает
окна использования провайдеров и снимки квот.
Текущие провайдеры окон использования: Anthropic, GitHub Copilot, Gemini CLI, OpenAI,
MiniMax, Xiaomi и z.ai. Данные аутентификации для использования берутся из хуков конкретного провайдера,
когда они доступны; в противном случае OpenClaw использует подходящие учетные данные OAuth/API-ключей
из профилей аутентификации, env или конфигурации.
В выводе `--json` `auth.providers` — это обзор провайдеров с учетом env/config/store,
а `auth.oauth` — только состояние профилей в хранилище аутентификации.
Добавьте `--probe`, чтобы выполнить живые проверки аутентификации для каждого настроенного профиля провайдера.
Проверки — это реальные запросы (они могут расходовать токены и вызывать ограничения частоты).
Используйте `--agent <id>`, чтобы проверить состояние модели/аутентификации настроенного агента. Если параметр не указан,
команда использует `OPENCLAW_AGENT_DIR`, если он задан, иначе
настроенного агента по умолчанию.
Строки проверок могут поступать из профилей аутентификации, учетных данных env или `models.json`.
Для диагностики OAuth OpenAI ChatGPT/Codex `openclaw models status`,
`openclaw models auth list --provider openai` и
`openclaw config get agents.defaults.model --json` — самый быстрый способ
подтвердить, есть ли у агента пригодный профиль OAuth `openai` для
`openai/*` через нативную среду выполнения Codex. См. [Настройка провайдера OpenAI](/ru/providers/openai#check-and-recover-codex-oauth-routing).

Примечания:

- `models set <model-or-alias>` принимает `provider/model` или псевдоним.
- `models list` доступна только для чтения: она читает конфигурацию, профили аутентификации, существующее состояние каталога
  и строки каталога, принадлежащие провайдеру, но не перезаписывает
  `models.json`.
- Столбец `Auth` относится к уровню провайдера и доступен только для чтения. Он вычисляется на основе локальных
  метаданных профилей аутентификации, маркеров env, настроенных ключей провайдера, маркеров локального провайдера,
  маркеров env/profile AWS Bedrock и синтетических метаданных аутентификации Plugin;
  он не загружает среду выполнения провайдера, не читает секреты keychain, не вызывает API провайдера
  и не доказывает точную готовность выполнения для каждой модели.
- `models list --all --provider <id>` может включать статические строки каталога, принадлежащие провайдеру,
  из манифестов Plugin или встроенных метаданных каталога провайдера, даже если вы
  еще не прошли аутентификацию у этого провайдера. Такие строки все равно отображаются
  как недоступные, пока не будет настроена соответствующая аутентификация.
- `models list` сохраняет отзывчивость плоскости управления, когда обнаружение каталога провайдера
  выполняется медленно. Представления по умолчанию и настроенные представления возвращаются к настроенным или
  синтетическим строкам моделей после короткого ожидания и позволяют обнаружению завершиться в
  фоновом режиме. Используйте `--all`, когда вам нужен точный полный обнаруженный каталог и
  вы готовы ждать обнаружения провайдера.
- Широкий `models list --all` объединяет строки каталога манифеста поверх строк реестра
  без загрузки хуков дополнения среды выполнения провайдера. Быстрые пути манифеста с фильтром по провайдеру
  используют только провайдеров, помеченных как `static`; провайдеры, помеченные как `refreshable`,
  остаются основанными на реестре/кэше и добавляют строки манифеста как дополнения, а
  провайдеры, помеченные как `runtime`, остаются на обнаружении через реестр/среду выполнения.
- `models list` разделяет нативные метаданные модели и ограничения среды выполнения. В табличном
  выводе `Ctx` показывает `contextTokens/contextWindow`, когда эффективное ограничение среды выполнения
  отличается от нативного окна контекста; строки JSON включают `contextTokens`,
  когда провайдер предоставляет это ограничение.
- `models list --provider <id>` фильтрует по id провайдера, например `moonshot` или
  `openai`. Он не принимает отображаемые метки из интерактивных средств выбора провайдера,
  например `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` читает публичный каталог `:free` OpenRouter и ранжирует кандидатов для
использования в качестве резервных вариантов. Сам каталог публичный, поэтому сканирования только метаданных не требуют
ключ OpenRouter.

По умолчанию OpenClaw пытается проверить поддержку инструментов и изображений с помощью живых вызовов моделей.
Если ключ OpenRouter не настроен, команда возвращается к выводу только метаданных
и объясняет, что моделям `:free` все равно требуется `OPENROUTER_API_KEY` для
проверок и инференса.

Параметры:

- `--no-probe` (только метаданные; без поиска конфигурации/секретов)
- `--min-params <b>`
- `--max-age-days <days>`
- `--provider <name>`
- `--max-candidates <n>`
- `--timeout <ms>` (тайм-аут запроса каталога и каждой проверки)
- `--concurrency <n>`
- `--yes`
- `--no-input`
- `--set-default`
- `--set-image`
- `--json`

`--set-default` и `--set-image` требуют живых проверок; результаты сканирования
только метаданных носят информационный характер и не применяются к конфигурации.

### Статус моделей

Параметры:

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

`--json` оставляет stdout только для полезной нагрузки JSON. Диагностика профилей аутентификации, провайдеров
и запуска направляется в stderr, чтобы скрипты могли напрямую передавать stdout
в инструменты вроде `jq`.

Группы статуса проверки:

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

Ожидаемые случаи деталей/кодов причин проверки:

- `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 list [--provider <id>] [--json]
openclaw models auth login --provider <id>
openclaw models auth login --provider openai --profile-id openai:work
openclaw models auth paste-api-key --provider <id>
openclaw models auth setup-token --provider <id>
openclaw models auth paste-token
```

`models auth add` — интерактивный помощник аутентификации. Он может запустить поток аутентификации провайдера
(OAuth/API-ключ) или провести вас через ручную вставку токена, в зависимости от
выбранного провайдера.

`models auth list` перечисляет сохраненные профили аутентификации для выбранного агента без
вывода токена, API-ключа или секретных материалов OAuth. Используйте `--provider <id>`,
чтобы отфильтровать одного провайдера, например `openai`, и `--json` для скриптов.

`models auth login` запускает поток аутентификации Plugin провайдера (OAuth/API-ключ). Используйте
`openclaw plugins list`, чтобы увидеть, какие провайдеры установлены.
Используйте `openclaw models auth --agent <id> <subcommand>`, чтобы записать результаты аутентификации в
хранилище конкретного настроенного агента. Родительский флаг `--agent` учитывается командами
`add`, `list`, `login`, `paste-api-key`, `setup-token`, `paste-token` и
`login-github-copilot`.

Для моделей OpenAI `--provider openai` по умолчанию использует вход в аккаунт ChatGPT/Codex.
Используйте `--method api-key` только когда хотите добавить профиль API-ключа OpenAI,
обычно как резерв для лимитов подписки Codex. Запустите `openclaw doctor --fix`,
чтобы мигрировать более старое устаревшее состояние аутентификации/профилей с префиксом OpenAI Codex в `openai`.

Примеры:

```bash
openclaw models auth login --provider openai --set-default
openclaw models auth login --provider openai --method api-key
openclaw models auth paste-api-key --provider openai
openclaw models auth list --provider openai
```

Примечания:

- `login` принимает `--profile-id <id>` для провайдеров, которые поддерживают именованные
  профили при входе. Используйте это, чтобы разделять несколько входов для одного и того же
  провайдера.
- `paste-api-key` принимает API-ключи, созданные в другом месте, запрашивает значение ключа
  и записывает его в id профиля по умолчанию `<provider>:manual`, если вы не
  передадите `--profile-id`. В автоматизации передавайте ключ через stdin, например
  `printf "%s\n" "$OPENAI_API_KEY" | openclaw models auth paste-api-key --provider openai`.
- `setup-token` и `paste-token` остаются универсальными командами токенов для провайдеров,
  которые предоставляют методы токенной аутентификации.
- `setup-token` требует интерактивный TTY и запускает метод токенной аутентификации провайдера
  (по умолчанию метод `setup-token` этого провайдера, если он его предоставляет).
- `paste-token` принимает строку токена, созданную в другом месте или из автоматизации.
- `paste-token` требует `--provider`, по умолчанию запрашивает значение токена
  и записывает его в id профиля по умолчанию `<provider>:manual`, если вы не передадите
  `--profile-id`.
- В автоматизации передавайте токен через stdin, а не как аргумент, чтобы
  учетные данные провайдера не появлялись в истории shell или списках процессов.
- `paste-token --expires-in <duration>` сохраняет абсолютное истечение срока действия токена из
  относительной длительности, например `365d` или `12h`.
- Для `openai` API-ключи OpenAI и материалы токенов ChatGPT/OAuth —
  разные формы аутентификации. Используйте `paste-api-key` для API-ключей OpenAI `sk-...` и
  `paste-token` только для материалов токенной аутентификации.
- Примечание Anthropic: сотрудники Anthropic сообщили нам, что использование Claude CLI в стиле OpenClaw снова разрешено, поэтому OpenClaw считает повторное использование Claude CLI и использование `claude -p` санкционированными для этой интеграции, если Anthropic не опубликует новую политику.
- Anthropic `setup-token` / `paste-token` остаются доступными как поддерживаемый путь токенов OpenClaw, но теперь OpenClaw предпочитает повторное использование Claude CLI и `claude -p`, когда они доступны.

## Связано

- [Справочник CLI](/ru/cli)
- [Выбор модели](/ru/concepts/model-providers)
- [Отказоустойчивое переключение модели](/ru/concepts/model-failover)