openclaw models

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

Связано:

• Провайдеры + модели: Модели
• Концепции выбора модели + slash-команда /models: Концепция моделей
• Настройка аутентификации провайдера: Начало работы

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

openclaw models statusopenclaw models listopenclaw 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.

Примечания:

• 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 не смог разрешить проверяемого кандидата модели для этого провайдера.

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

openclaw models aliases listopenclaw models fallbacks list

Профили аутентификации

openclaw models auth addopenclaw models auth list [--provider <id>] [--json]openclaw models auth login --provider <id>openclaw models auth login --provider openai --profile-id openai:workopenclaw 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.

Примеры:

openclaw models auth login --provider openai --set-defaultopenclaw models auth login --provider openai --method api-keyopenclaw models auth paste-api-key --provider openaiopenclaw 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
• Выбор модели
• Отказоустойчивое переключение модели