Перейти к основному содержанию
Вопросы и ответы о моделях и профилях аутентификации. Настройку, сеансы, gateway, каналы и устранение неполадок см. в основном разделе Часто задаваемые вопросы.

​
Модели: значения по умолчанию, выбор, псевдонимы, переключение

Модель OpenClaw по умолчанию — это то, что вы задали как:
agents.defaults.model.primary
Модели указываются в формате provider/model (пример: openai/gpt-5.5 или anthropic/claude-sonnet-4-6). Если пропустить провайдера, OpenClaw сначала пробует псевдоним, затем уникальное совпадение настроенного провайдера для этого точного идентификатора модели, и только после этого откатывается к настроенному провайдеру по умолчанию как к устаревшему пути совместимости. Если этот провайдер больше не предоставляет настроенную модель по умолчанию, OpenClaw откатывается к первой настроенной паре провайдер/модель вместо того, чтобы показывать устаревшую модель по умолчанию от удаленного провайдера. Всё равно следует явно задавать provider/model.
Рекомендуемая по умолчанию: используйте самую сильную модель последнего поколения, доступную в вашем стеке провайдеров. Для агентов с инструментами или недоверенным вводом: отдавайте приоритет мощности модели, а не стоимости. Для обычного чата с низкими рисками: используйте более дешевые резервные модели и маршрутизируйте по роли агента.У MiniMax есть собственная документация: MiniMax и Локальные модели.Практическое правило: используйте лучшую модель, которую можете себе позволить, для задач с высокими рисками, а более дешевую модель — для обычного чата или сводок. Можно маршрутизировать модели по агентам и использовать субагентов для параллелизации долгих задач (каждый субагент потребляет токены). См. Модели и Субагенты.Серьезное предупреждение: более слабые или чрезмерно квантованные модели более уязвимы к prompt injection и небезопасному поведению. См. Безопасность.Дополнительный контекст: Модели.
Используйте команды моделей или редактируйте только поля модели. Избегайте полной замены конфигурации.Безопасные варианты:
  • /model в чате (быстро, для текущего сеанса)
  • openclaw models set ... (обновляет только конфигурацию модели)
  • openclaw configure --section model (интерактивно)
  • отредактировать agents.defaults.model в ~/.openclaw/openclaw.json
Избегайте config.apply с частичным объектом, если не собираетесь заменить всю конфигурацию. Для правок через RPC сначала проверьте с помощью config.schema.lookup и предпочитайте config.patch. Полезная нагрузка lookup дает нормализованный путь, краткую документацию/ограничения схемы и сводки непосредственных дочерних элементов. для частичных обновлений. Если вы перезаписали конфигурацию, восстановите ее из резервной копии или снова запустите openclaw doctor для исправления.Документация: Модели, Настройка, Конфигурация, Doctor.
Да. Ollama — самый простой путь для локальных моделей.Самая быстрая настройка:
  1. Установите Ollama с https://ollama.com/download
  2. Загрузите локальную модель, например ollama pull gemma4
  3. Если вам также нужны облачные модели, выполните ollama signin
  4. Запустите openclaw onboard и выберите Ollama
  5. Выберите Local или Cloud + Local
Примечания:
  • Cloud + Local дает облачные модели плюс ваши локальные модели Ollama
  • облачные модели, такие как kimi-k2.5:cloud, не требуют локальной загрузки
  • для ручного переключения используйте openclaw models list и openclaw models set ollama/<model>
Примечание по безопасности: меньшие или сильно квантованные модели более уязвимы к prompt injection. Мы настоятельно рекомендуем большие модели для любого бота, который может использовать инструменты. Если вы всё же хотите использовать малые модели, включите песочницу и строгие списки разрешенных инструментов.Документация: Ollama, Локальные модели, Провайдеры моделей, Безопасность, Песочница.
  • Эти развертывания могут различаться и со временем меняться; фиксированной рекомендации по провайдеру нет.
  • Проверьте текущую настройку среды выполнения на каждом gateway с помощью openclaw models status.
  • Для агентов с повышенными требованиями к безопасности или инструментами используйте самую сильную доступную модель последнего поколения.
Используйте команду /model как отдельное сообщение:
/model sonnet
/model opus
/model gpt
/model gpt-mini
/model gemini
/model gemini-flash
/model gemini-flash-lite
Это встроенные псевдонимы. Пользовательские псевдонимы можно добавить через agents.defaults.models.Доступные модели можно вывести с помощью /model, /model list или /model status./model (и /model list) показывает компактный нумерованный выбор. Выберите по номеру:
/model 3
Также можно принудительно задать конкретный профиль аутентификации для провайдера (для текущего сеанса):
/model opus@anthropic:default
/model opus@anthropic:work
Совет: /model status показывает, какой агент активен, какой файл auth-profiles.json используется и какой профиль аутентификации будет опробован следующим. Также, когда доступно, он показывает настроенный endpoint провайдера (baseUrl) и режим API (api).Как открепить профиль, заданный через @profile?Повторно выполните /model без суффикса @profile:
/model anthropic/claude-opus-4-6
Если хотите вернуться к значению по умолчанию, выберите его из /model (или отправьте /model <default provider/model>). Используйте /model status, чтобы подтвердить, какой профиль аутентификации активен.
/model provider/model выбирает этот точный маршрут провайдера для сеанса.Например, qianfan/deepseek-v4-flash и deepseek/deepseek-v4-flash — это разные ссылки на модель, хотя обе содержат deepseek-v4-flash. OpenClaw не должен незаметно переключаться с одного провайдера на другого только потому, что совпал идентификатор модели без префикса.Выбранная пользователем ссылка /model также строга для политики отката. Если выбранная пара провайдер/модель недоступна, ответ завершается видимой ошибкой вместо ответа из agents.defaults.model.fallbacks. Настроенные цепочки резервирования по-прежнему применяются к настроенным значениям по умолчанию, основным моделям Cron-заданий и автоматически выбранному резервному состоянию.Если запуск, начатый не из сеансового переопределения, может использовать откат, OpenClaw сначала пробует запрошенную пару провайдер/модель, затем настроенные резервные варианты и только потом настроенную основную модель. Это не позволяет дублирующимся идентификаторам моделей без префикса сразу возвращаться к провайдеру по умолчанию.См. Модели и Отказоустойчивость моделей.
Да. Рассматривайте выбор модели и выбор среды выполнения отдельно:
  • Нативный агент Codex для программирования: задайте agents.defaults.model.primary как openai/gpt-5.5. Войдите через openclaw models auth login --provider openai, когда нужна аутентификация по подписке ChatGPT/Codex.
  • Прямые задачи OpenAI API вне цикла агента: настройте OPENAI_API_KEY для изображений, embeddings, речи, realtime и других поверхностей OpenAI API вне агента.
  • Аутентификация OpenAI agent по API-ключу: используйте /model openai/gpt-5.5 с упорядоченным профилем API-ключа openai.
  • Субагенты: маршрутизируйте задачи программирования к агенту, ориентированному на Codex, с собственной моделью openai/gpt-5.5.
См. Модели и Слеш-команды.
Используйте либо переключатель сеанса, либо значение по умолчанию в конфигурации:
  • Для сеанса: отправьте /fast on, пока сеанс использует openai/gpt-5.5.
  • По умолчанию для модели: задайте agents.defaults.models["openai/gpt-5.5"].params.fastMode как true.
  • Автоматический порог: используйте /fast auto или params.fastMode: "auto", чтобы новые вызовы модели начинались в быстром режиме до автоматического порога, а последующие повторные попытки, откаты, результаты инструментов или продолжения начинались без быстрого режима. Порог по умолчанию — 60 секунд; чтобы изменить его, задайте params.fastAutoOnSeconds для активной модели.
Пример:
{
  agents: {
    defaults: {
      models: {
        "openai/gpt-5.5": {
          params: {
            fastMode: "auto",
            fastAutoOnSeconds: 30,
          },
        },
      },
    },
  },
}
Для OpenAI быстрый режим соответствует service_tier = "priority" в поддерживаемых нативных запросах Responses. Сеансовые переопределения /fast имеют приоритет над значениями по умолчанию из конфигурации. Ходы app-server Codex могут получить tier только в начале хода, поэтому auto применяется к следующему ходу модели, начатому OpenClaw, а не внутри уже выполняющегося хода app-server.См. Режим размышления и быстрый режим и Быстрый режим OpenAI.
Если задан agents.defaults.models, он становится списком разрешенных для /model и любых сеансовых переопределений. Выбор модели, которой нет в этом списке, возвращает:
Model "provider/model" is not allowed. Use /models to list providers, or /models <provider> to list models.
Add it with: openclaw config set agents.defaults.models '{"provider/model":{}}' --strict-json --merge
Эта ошибка возвращается вместо обычного ответа. Исправление: добавьте точную модель в agents.defaults.models, добавьте wildcard провайдера, например "provider/*": {}, для динамических каталогов провайдера, удалите список разрешенных или выберите модель из /model list. Если команда также включала --runtime codex, сначала обновите список разрешенных, а затем повторите ту же команду /model provider/model --runtime codex.
Это означает, что провайдер не настроен (конфигурация провайдера MiniMax или профиль аутентификации не найдены), поэтому модель невозможно разрешить.Контрольный список исправления:
  1. Обновитесь до текущего выпуска OpenClaw (или запустите из исходников main), затем перезапустите gateway.
  2. Убедитесь, что MiniMax настроен (мастером или JSON) либо что аутентификация MiniMax существует в env/профилях аутентификации, чтобы соответствующий провайдер мог быть внедрен (MINIMAX_API_KEY для minimax, MINIMAX_OAUTH_TOKEN или сохраненный OAuth MiniMax для minimax-portal).
  3. Используйте точный идентификатор модели (с учетом регистра) для вашего пути аутентификации: minimax/MiniMax-M3, minimax/MiniMax-M2.7 или minimax/MiniMax-M2.7-highspeed для настройки с API-ключом, либо minimax-portal/MiniMax-M3, minimax-portal/MiniMax-M2.7 или minimax-portal/MiniMax-M2.7-highspeed для настройки с OAuth.
  4. Выполните: 
    openclaw models list
    и выберите из списка (или /model list в чате).
См. MiniMax и Модели.
Да. Используйте MiniMax по умолчанию и переключайте модели для каждого сеанса, когда нужно. Резервные варианты предназначены для ошибок, а не для «сложных задач», поэтому используйте /model или отдельного агента.Вариант A: переключение для сеанса
{
  env: { MINIMAX_API_KEY: "sk-...", OPENAI_API_KEY: "sk-..." },
  agents: {
    defaults: {
      model: { primary: "minimax/MiniMax-M3" },
      models: {
        "minimax/MiniMax-M3": { alias: "minimax" },
        "openai/gpt-5.5": { alias: "gpt" },
      },
    },
  },
}
Затем:
/model gpt
Вариант B: отдельные агенты
  • Агент A по умолчанию: MiniMax
  • Агент B по умолчанию: OpenAI
  • Маршрутизируйте по агенту или используйте /agent для переключения
Документация: Модели, Маршрутизация нескольких агентов, MiniMax, OpenAI.
Да. OpenClaw поставляется с несколькими сокращениями по умолчанию (применяются только когда модель существует в agents.defaults.models):
  • opus → anthropic/claude-opus-4-8
  • sonnet → anthropic/claude-sonnet-4-6
  • gpt → openai/gpt-5.4
  • gpt-mini → openai/gpt-5.4-mini
  • gpt-nano → openai/gpt-5.4-nano
  • gemini → google/gemini-3.1-pro-preview
  • gemini-flash → google/gemini-3-flash-preview
  • gemini-flash-lite → google/gemini-3.1-flash-lite
Если вы зададите собственный псевдоним с тем же именем, будет использоваться ваше значение.
Псевдонимы берутся из agents.defaults.models.<modelId>.alias. Пример:
{
  agents: {
    defaults: {
      model: { primary: "anthropic/claude-opus-4-6" },
      models: {
        "anthropic/claude-opus-4-6": { alias: "opus" },
        "anthropic/claude-sonnet-4-6": { alias: "sonnet" },
      },
    },
  },
}
Затем /model sonnet (или /<alias>, если поддерживается) разрешается в этот ID модели.
OpenRouter (оплата за токены; много моделей):
{
  agents: {
    defaults: {
      model: { primary: "openrouter/anthropic/claude-sonnet-4-6" },
      models: { "openrouter/anthropic/claude-sonnet-4-6": {} },
    },
  },
  env: { OPENROUTER_API_KEY: "sk-or-..." },
}
Z.AI (модели GLM):
{
  agents: {
    defaults: {
      model: { primary: "zai/glm-5" },
      models: { "zai/glm-5": {} },
    },
  },
  env: { ZAI_API_KEY: "..." },
}
Если вы ссылаетесь на провайдера/модель, но обязательный ключ провайдера отсутствует, вы получите ошибку аутентификации во время выполнения (например, No API key found for provider "zai").Ключ API для провайдера не найден после добавления нового агентаОбычно это означает, что у нового агента пустое хранилище аутентификации. Аутентификация задается отдельно для каждого агента и хранится в:
~/.openclaw/agents/<agentId>/agent/auth-profiles.json
Варианты исправления:
  • Запустите openclaw agents add <id> и настройте аутентификацию в мастере.
  • Или скопируйте только переносимые статические профили api_key / token из хранилища аутентификации основного агента в хранилище аутентификации нового агента.
  • Для профилей OAuth войдите из нового агента, когда ему нужна собственная учетная запись; в противном случае OpenClaw может читать данные из агента по умолчанию/основного агента без клонирования refresh-токенов.
Не переиспользуйте agentDir между агентами; это вызывает конфликты аутентификации/сеансов.

​
Отказоустойчивое переключение моделей и “Все модели завершились с ошибкой”

Отказоустойчивое переключение происходит в два этапа:
  1. Ротация профилей аутентификации внутри одного провайдера.
  2. Резервная модель — переход к следующей модели в agents.defaults.model.fallbacks.
Периоды ожидания применяются к сбоящим профилям (экспоненциальная задержка), поэтому OpenClaw может продолжать отвечать, даже когда провайдер ограничивает частоту запросов или временно дает сбой.Корзина ограничений частоты включает не только обычные ответы 429. OpenClaw также считает сообщения вроде Too many concurrent requests, ThrottlingException, concurrency limit reached, workers_ai ... quota limit exceeded, resource exhausted и периодические лимиты окон использования (weekly/monthly limit reached) ограничениями частоты, подходящими для отказоустойчивого переключения.Некоторые ответы, похожие на биллинг, не являются 402, а некоторые HTTP-ответы 402 также остаются в этой временной корзине. Если провайдер возвращает явный текст о биллинге при 401 или 403, OpenClaw все еще может оставить это в дорожке биллинга, но провайдер-специфичные сопоставители текста остаются ограничены провайдером, которому они принадлежат (например, OpenRouter Key limit exceeded). Если сообщение 402 вместо этого похоже на повторяемый лимит окна использования или лимит расходов организации/рабочей области (daily limit reached, resets tomorrow, organization spending limit exceeded), OpenClaw обрабатывает его как rate_limit, а не как длительное отключение из-за биллинга.Ошибки переполнения контекста отличаются: сигнатуры вроде request_too_large, input exceeds the maximum number of tokens, input token count exceeds the maximum number of input tokens, input is too long for the model или ollama error: context length exceeded остаются на пути Compaction/повторной попытки, а не продвигают резервное переключение модели.Текст общих серверных ошибок намеренно уже, чем “все, где есть unknown/error”. OpenClaw действительно обрабатывает временные формы, ограниченные провайдером, такие как простой Anthropic An unknown error occurred, простой OpenRouter Provider returned error, ошибки причин остановки вроде Unhandled stop reason: error, JSON-полезные нагрузки api_error с временным серверным текстом (internal server error, unknown error, 520, upstream error, backend error) и ошибки занятости провайдера, такие как ModelNotReadyException, как сигналы таймаута/перегрузки, подходящие для отказоустойчивого переключения, когда контекст провайдера совпадает. Общий внутренний текст резервного сбоя вроде LLM request failed with an unknown error. остается консервативным и сам по себе не запускает резервное переключение модели.
Это означает, что система попыталась использовать ID профиля аутентификации anthropic:default, но не смогла найти учетные данные для него в ожидаемом хранилище аутентификации.Контрольный список исправления:
  • Подтвердите, где находятся профили аутентификации (новые и устаревшие пути)
    • Текущий: ~/.openclaw/agents/<agentId>/agent/auth-profiles.json
    • Устаревший: ~/.openclaw/agent/* (переносится с помощью openclaw doctor)
  • Подтвердите, что ваша переменная окружения загружена Gateway
    • Если вы задали ANTHROPIC_API_KEY в своей оболочке, но запускаете Gateway через systemd/launchd, он может ее не унаследовать. Поместите ее в ~/.openclaw/.env или включите env.shellEnv.
  • Убедитесь, что редактируете правильного агента
    • В конфигурациях с несколькими агентами может быть несколько файлов auth-profiles.json.
  • Проверьте состояние моделей/аутентификации
    • Используйте openclaw models status, чтобы увидеть настроенные модели и наличие аутентификации у провайдеров.
Контрольный список исправления для “No credentials found for profile anthropic”Это означает, что запуск закреплен за профилем аутентификации Anthropic, но Gateway не может найти его в своем хранилище аутентификации.
  • Используйте Claude CLI
    • Запустите openclaw models auth login --provider anthropic --method cli --set-default на хосте gateway.
  • Если вместо этого вы хотите использовать ключ API
    • Поместите ANTHROPIC_API_KEY в ~/.openclaw/.env на хосте gateway.
    • Очистите любой закрепленный порядок, который принудительно использует отсутствующий профиль: 
      openclaw models auth order clear --provider anthropic
  • Подтвердите, что запускаете команды на хосте gateway
    • В удаленном режиме профили аутентификации находятся на машине gateway, а не на вашем ноутбуке.
Если ваша конфигурация моделей включает Google Gemini как резервный вариант (или вы переключились на сокращение Gemini), OpenClaw попробует его во время резервного переключения модели. Если вы не настроили учетные данные Google, вы увидите No API key found for provider "google".Исправление: либо предоставьте аутентификацию Google, либо удалите/избегайте моделей Google в agents.defaults.model.fallbacks / псевдонимах, чтобы резервное переключение не направляло туда.Запрос LLM отклонен: требуется thinking signature (Google Antigravity)Причина: история сеанса содержит thinking-блоки без подписей (часто из-за прерванного/частичного потока). Google Antigravity требует подписи для thinking-блоков.Исправление: OpenClaw теперь удаляет неподписанные thinking-блоки для Google Antigravity Claude. Если это все еще появляется, начните новый сеанс или задайте /thinking off для этого агента.

​
Профили аутентификации: что это такое и как ими управлять

Связано: /concepts/oauth (потоки OAuth, хранение токенов, шаблоны нескольких учетных записей)
Профиль аутентификации — это именованная запись учетных данных (OAuth или ключ API), привязанная к провайдеру. Профили находятся в:
~/.openclaw/agents/<agentId>/agent/auth-profiles.json
Чтобы просмотреть сохраненные профили без вывода секретов, запустите openclaw models auth list (при необходимости с --provider <id> или --json). Подробнее см. CLI моделей.
OpenClaw использует ID с префиксом провайдера, например:
  • anthropic:default (часто используется, когда нет идентичности email)
  • anthropic:<email> для идентичностей OAuth
  • пользовательские ID, которые вы выбираете (например, anthropic:work)
Да. Конфигурация поддерживает необязательные метаданные для профилей и порядок для каждого провайдера (auth.order.<provider>). Это не хранит секреты; оно сопоставляет ID с провайдером/режимом и задает порядок ротации.OpenClaw может временно пропускать профиль, если он находится в коротком периоде ожидания (ограничения частоты/таймауты/сбои аутентификации) или в более длительном отключенном состоянии (биллинг/недостаточно кредитов). Чтобы проверить это, запустите openclaw models status --json и проверьте auth.unusableProfiles. Настройка: auth.cooldowns.billingBackoffHours*.Периоды ожидания из-за ограничений частоты могут быть привязаны к модели. Профиль, который находится в периоде ожидания для одной модели, все еще может быть пригоден для родственной модели у того же провайдера, тогда как окна биллинга/отключения по-прежнему блокируют весь профиль.Вы также можете задать переопределение порядка для отдельного агента (хранится в auth-state.json этого агента) через CLI:
# Defaults to the configured default agent (omit --agent)
openclaw models auth order get --provider anthropic

# Lock rotation to a single profile (only try this one)
openclaw models auth order set --provider anthropic anthropic:default

# Or set an explicit order (fallback within provider)
openclaw models auth order set --provider anthropic anthropic:work anthropic:default

# Clear override (fall back to config auth.order / round-robin)
openclaw models auth order clear --provider anthropic
Чтобы выбрать конкретного агента:
openclaw models auth order set --provider anthropic --agent main anthropic:default
Чтобы проверить, что действительно будет пробоваться, используйте:
openclaw models status --probe
Если сохраненный профиль исключен из явного порядка, probe сообщает excluded_by_auth_order для этого профиля, а не пытается использовать его молча.
OpenClaw поддерживает оба варианта:
  • OAuth / вход через CLI часто использует доступ по подписке там, где провайдер это поддерживает. Для Anthropic backend Claude CLI в OpenClaw использует Claude Code claude -p; Anthropic сейчас рассматривает это как использование Agent SDK/программный доступ. Anthropic приостановила отдельное изменение кредитов Agent SDK от 15 июня 2026 года, поэтому пока это все еще расходует лимиты использования подписки. Текущее уведомление о паузе см. в статье Anthropic о плане Agent SDK.
  • Ключи API используют биллинг с оплатой за токены.
Мастер явно поддерживает Anthropic Claude CLI, OpenAI Codex OAuth и ключи API.

​
Связанное