OpenAI

OpenClaw использует один идентификатор провайдера, openai, как для прямой аутентификации по API-ключу, так и для аутентификации по подписке ChatGPT/Codex. openai/* — канонический маршрут модели. Для встроенных обращений агента, когда политика среды выполнения не задана или имеет значение auto, параметры маршрута OpenAI определяют, может ли OpenClaw неявно выбрать встроенную среду выполнения сервера приложений Codex. Сам по себе префикс openai/* не выбирает среду выполнения.

• Модели агентов — openai/* через среду выполнения, выбранную явной конфигурацией agentRuntime или неявной политикой маршрута OpenAI. Для использования подписки ChatGPT/Codex войдите с аутентификацией Codex или настройте профиль аутентификации по API-ключу, если требуется тарификация на основе ключа.
• Неагентские API OpenAI — прямой доступ к OpenAI Platform с оплатой по факту использования через OPENAI_API_KEY или профиль аутентификации по API-ключу openai.
• Устаревшая конфигурация — старые ссылки на модели Codex и идентификаторы профилей исправляются на openai/* с помощью openclaw doctor --fix.

OpenAI явно поддерживает использование OAuth подписки во внешних инструментах и рабочих процессах, таких как OpenClaw.

Отслеживание использования и затрат

OpenClaw разделяет квоту подписки и оплату API Platform:

• OAuth ChatGPT/Codex показывает план подписки, окна квот и баланс кредитов.
• OPENAI_ADMIN_KEY показывает в разделе Использование интерфейса Control UI сообщённые провайдером данные о затратах организации и использовании завершений за 30 дней, включая ежедневные расходы, общее количество запросов и токенов, наиболее используемые модели и категории затрат.
• OPENAI_PROJECT_ID при необходимости ограничивает историю Admin API одним проектом.
• OpenClaw никогда не отправляет OPENAI_API_KEY или профиль вывода openai в API организации; эти учётные данные могут принадлежать пользовательским конечным точкам, Azure или локальным конечным точкам агента.

Явно заданный ключ администратора имеет приоритет над OAuth. Сообщённая провайдером история не объединяется с оценочной стоимостью OpenClaw, рассчитанной на основе сеансов; она может включать активность API других клиентов и корректировки тарификации на стороне провайдера.

Документация OpenAI по панели использования API описывает требования к владельцу организации и явно предоставленному разрешению Usage Dashboard для доступа к данным об использовании.

Провайдер, модель, среда выполнения и канал — отдельные уровни. Если эти обозначения смешиваются, прочитайте раздел Среды выполнения агентов, прежде чем изменять конфигурацию.

Быстрый выбор

Карта наименований

Неявная среда выполнения агента

Когда политика agentRuntime для провайдера/модели не задана или имеет значение auto, принадлежащая OpenAI политика маршрута выбирает неявную среду выполнения на основе фактической конечной точки и адаптера:

Явная нестандартная настройка agentRuntime.id провайдера/модели остаётся определяющей. Например, agentRuntime.id: "openclaw" сохраняет для маршрута, который в иных условиях допускает Codex, среду выполнения OpenClaw, тогда как agentRuntime.id: "codex" требует Codex и завершает работу с ошибкой, если фактический маршрут не объявлен совместимым с Codex. Выбор среды выполнения не изменяет тип учётных данных или тарификацию: аутентификация по API-ключу Platform и аутентификация по подписке ChatGPT/Codex остаются раздельными.

openclaw doctor --fix переносит устаревшие ссылки на модели Codex, устаревшие идентификаторы профилей аутентификации Codex и устаревшие записи порядка аутентификации Codex на канонический маршрут openai. Используйте auth.order.openai для новой конфигурации порядка аутентификации.

Ограниченная предварительная версия GPT-5.6

OpenClaw распознаёт точные идентификаторы моделей openai/gpt-5.6-sol, openai/gpt-5.6-terra и openai/gpt-5.6-luna. В текущем каталоге все три предоставляют рассуждение xhigh и max. OpenAI описывает Sol как флагманский уровень, Terra — как сбалансированный, а Luna — как быстрый и более экономичный уровень. См. анонс выпуска GPT-5.6 и руководство по доступу.

При прямой аутентификации OpenAI по API-ключу идентификатор openai/gpt-5.6 без уточнений является псевдонимом Sol и используется по умолчанию при новой настройке. Нативный каталог Codex не применяет этот псевдоним прямого API на стороне клиента; в зависимости от доступа рабочего пространства он может отображать точные идентификаторы Sol, Terra и Luna. Поэтому при новой настройке OAuth ChatGPT/Codex используется openai/gpt-5.6-sol. Проверьте текущую учётную запись командой:

openclaw models list --provider openai

Доступ организации API и рабочего пространства Codex может различаться. Если GPT-5.6 недоступна, явно выберите GPT-5.5:

openclaw models set openai/gpt-5.5

OpenClaw отображает исходную ошибку доступа и не заменяет автоматически выбранную GPT-5.6 на GPT-5.5.

Охват функций OpenClaw

Эмбеддинги памяти

OpenClaw может использовать OpenAI или совместимую с OpenAI конечную точку эмбеддингов для индексации memory_search и эмбеддингов запросов:

{  agents: {    defaults: {      memorySearch: {        provider: "openai",        model: "text-embedding-3-small",      },    },  },}

Для совместимых с OpenAI конечных точек, которым требуются асимметричные метки эмбеддингов, задайте queryInputType и documentInputType в memorySearch. OpenClaw передаёт их как специфичные для провайдера поля запроса input_type: для эмбеддингов запросов используется queryInputType; для индексируемых фрагментов памяти и пакетной индексации — documentInputType. Полный пример см. в справочнике по настройке памяти.

Начало работы

openclaw onboard --auth-choice openai-api-key

openclaw onboard --openai-api-key "$OPENAI_API_KEY"

openclaw models list --provider openai

{  env: { OPENAI_API_KEY: "example-openai-key-not-real" },  agents: { defaults: { model: { primary: "openai/gpt-5.6" } } },}

{  env: { OPENAI_API_KEY: "example-openai-key-not-real" },  agents: { defaults: { model: { primary: "openai/chat-latest" } } },}

openclaw onboard --auth-choice openai

openclaw models auth login --provider openai

openclaw models auth login --provider openai --device-code

openclaw config set agents.defaults.model.primary openai/gpt-5.6-sol

openclaw models list --provider openai

{  plugins: { entries: { codex: { enabled: true } } },  agents: {    defaults: {      model: { primary: "openai/gpt-5.6-sol" },    },  },}

{  plugins: { entries: { codex: { enabled: true } } },  agents: {    defaults: {      model: { primary: "openai/gpt-5.6-sol" },    },  },  auth: {    order: {      openai: [        "openai:user@example.com",        "openai:api-key-backup",      ],    },  },}

openclaw models statusopenclaw models auth list --provider openaiopenclaw config get agents.defaults.model --jsonopenclaw config get models.providers.openai.agentRuntime --json

openclaw models status --agent <id>openclaw models auth list --agent <id> --provider openai

openclaw doctor --fixopenclaw config validate

openclaw models auth login --provider openaiopenclaw models status --probe --probe-provider openai

openclaw models auth login --provider openai --profile-id openai:ritsukoopenclaw models auth login --provider openai --profile-id openai:lain

{  models: {    providers: {      openai: {        models: [{ id: "gpt-5.5", contextTokens: 160000 }],      },    },  },}

Аутентификация нативного сервера приложений Codex

Нативная среда сервера приложений Codex использует ссылки на модели openai/*, когда её неявно выбирает подходящий точный официальный маршрут HTTPS или когда её явно выбирает agentRuntime.id: "codex" поставщика/модели. Аутентификация по-прежнему привязана к учётной записи. OpenClaw выбирает способ аутентификации в следующем порядке:

1. Упорядоченные профили аутентификации OpenAI для агента, предпочтительно в auth.order.openai. Выполните openclaw doctor --fix, чтобы перенести устаревшие идентификаторы профилей аутентификации Codex и порядок аутентификации.
2. Существующая учётная запись сервера приложений, например локальный вход ChatGPT в Codex CLI. Для изолированного домашнего каталога агента по умолчанию OpenClaw подключает эту нативную учётную запись CLI к серверу приложений через RPC входа; конфигурация, плагины и хранилище цепочек CLI при этом не используются совместно.
3. Только для локальных запусков сервера приложений через stdio и только когда сервер приложений сообщает об отсутствии учётной записи: CODEX_API_KEY, затем OPENAI_API_KEY.

Локальный вход по подписке ChatGPT/Codex не заменяется только потому, что процесс Gateway также содержит OPENAI_API_KEY для прямых моделей OpenAI или векторных представлений. Резервный API-ключ из переменной окружения применяется только в локальном пути stdio без учётной записи; он никогда не отправляется через соединения с сервером приложений по WebSocket. Когда выбран профиль Codex на основе подписки, OpenClaw также исключает CODEX_API_KEY и OPENAI_API_KEY из окружения запускаемого дочернего процесса сервера приложений stdio и вместо этого передаёт выбранные учётные данные через RPC входа сервера приложений.

Когда этот профиль подписки блокируется из-за ограничения использования Codex, OpenClaw отмечает профиль заблокированным до указанного Codex времени сброса и позволяет порядку аутентификации перейти к следующему профилю openai:*, не изменяя выбранную модель и не выходя из среды Codex. После наступления времени сброса профиль подписки снова становится доступным.

Генерация изображений

Встроенный плагин openai регистрирует генерацию изображений через инструмент image_generate. Он поддерживает генерацию изображений как с API-ключом OpenAI, так и через Codex OAuth, используя одну и ту же ссылку на модель openai/gpt-image-2.

{  agents: {    defaults: {      imageGenerationModel: { primary: "openai/gpt-image-2" },    },  },}

gpt-image-2 используется по умолчанию для генерации изображений по тексту и редактирования изображений в OpenAI. gpt-image-1.5, gpt-image-1 и gpt-image-1-mini по-прежнему можно использовать как явные переопределения модели. Используйте openai/gpt-image-1.5 для вывода PNG/WebP с прозрачным фоном; текущий API gpt-image-2 отклоняет background: "transparent".

Для запроса с прозрачным фоном вызовите image_generate с model: "openai/gpt-image-1.5", outputFormat: "png" или "webp", а также background: "transparent"; более старый параметр поставщика openai.background по-прежнему принимается. OpenClaw также защищает общедоступные маршруты OpenAI и OpenAI Codex OAuth, заменяя прозрачные запросы с openai/gpt-image-2 по умолчанию на gpt-image-1.5; Azure и пользовательские конечные точки, совместимые с OpenAI, сохраняют настроенные имена развёртываний/моделей.

Та же настройка доступна для запусков CLI без интерфейса:

openclaw infer image generate \  --model openai/gpt-image-1.5 \  --output-format png \  --background transparent \  --prompt "Простая наклейка с красным кругом на прозрачном фоне" \  --json

При работе с входным файлом используйте те же флаги --output-format и --background вместе с openclaw infer image edit. --openai-background остаётся доступным как псевдоним, специфичный для OpenAI. Используйте --quality low|medium|high|auto, чтобы управлять качеством и стоимостью OpenAI Images. Используйте --openai-moderation low|auto, чтобы передать подсказку модерации OpenAI из image generate или image edit.

Для установок с ChatGPT/Codex OAuth сохраните ту же ссылку openai/gpt-image-2. Когда настроен профиль OAuth openai, OpenClaw получает сохранённый токен доступа OAuth и отправляет запросы изображений через серверную часть Codex Responses; он не пытается сначала использовать OPENAI_API_KEY и не переключается без уведомления на API-ключ. Явно настройте models.providers.openai с API-ключом, пользовательским базовым URL или конечной точкой Azure, если вместо этого требуется прямой маршрут OpenAI Images API. Если эта пользовательская конечная точка изображений находится в доверенной локальной сети или по частному адресу, также задайте browser.ssrfPolicy.dangerouslyAllowPrivateNetwork: true; OpenClaw блокирует частные и внутренние конечные точки изображений, совместимые с OpenAI, если это явное разрешение отсутствует.

Генерация:

/tool image_generate model=openai/gpt-image-2 prompt="Профессиональный постер запуска OpenClaw в macOS" size=3840x2160 count=1

Генерация прозрачного PNG:

/tool image_generate model=openai/gpt-image-1.5 prompt="Простая наклейка с красным кругом на прозрачном фоне" outputFormat=png background=transparent

Редактирование:

/tool image_generate model=openai/gpt-image-2 prompt="Сохранить форму объекта, изменить материал на полупрозрачное стекло" image=/path/to/reference.png size=1024x1536

Генерация видео

Встроенный плагин openai регистрирует генерацию видео через инструмент video_generate.

Запросы OpenAI на преобразование изображения в видео используют POST /v1/videos с изображением input_reference. Для редактирования одного видео используется POST /v1/videos/edits, а загруженное видео передаётся в поле video.

{  agents: {    defaults: {      videoGenerationModel: { primary: "openai/sora-2" },    },  },}

Дополнение к промпту GPT-5

OpenClaw добавляет общее дополнение к промпту GPT-5 для моделей семейства GPT-5 у провайдера openai (включая устаревшие ссылки Codex до исправления, которые нормализуются в openai/*). Другие провайдеры, также предоставляющие идентификаторы моделей семейства GPT-5, например маршруты OpenRouter или opencode, не получают это наложение: оно зависит от идентификатора провайдера openai, а не только от идентификатора модели. Более старые модели GPT-4.x никогда его не получают.

Нативная обвязка app-server Codex не получает через инструкции разработчика контракт поведения для персоны и дисциплины использования инструментов или дружественное наложение стиля взаимодействия; нативный Codex сохраняет собственное базовое поведение Codex, поведение модели и документации проекта, а OpenClaw отключает встроенную личность Codex для нативных потоков, чтобы файлы личности в рабочем пространстве агента оставались главным источником. OpenClaw добавляет в нативные потоки Codex только контекст среды выполнения: доставку по каналам, динамические инструменты OpenClaw, делегирование ACP, контекст рабочего пространства и Skills OpenClaw. Текст рекомендаций по Heartbeat из этого же дополнения — единственное исключение: нативные циклы Heartbeat Codex получают его в виде отдельных инструкций по совместной работе, а не через общий механизм дополнения к промпту.

Дополнение GPT-5 добавляет размеченный контракт поведения для сохранения персоны, безопасности выполнения, дисциплины использования инструментов, формата вывода, проверок завершения и верификации в соответствующих промптах, сформированных OpenClaw. Зависящее от канала поведение ответов и беззвучных сообщений остаётся в общем системном промпте OpenClaw и политике исходящей доставки. Дружественный слой стиля взаимодействия настраивается отдельно.

{  agents: {    defaults: {      promptOverlays: {        gpt5: { personality: "friendly" },      },    },  },}

openclaw config set agents.defaults.promptOverlays.gpt5.personality off

Голос и речь

{  messages: {    tts: {      providers: {        openai: { model: "gpt-4o-mini-tts", speakerVoice: "coral" },      },    },  },}

{  tools: {    media: {      audio: {        models: [          {            type: "provider",            provider: "openai",            model: "gpt-4o-transcribe",          },        ],      },    },  },}

Конечные точки Azure OpenAI

Встроенный провайдер openai может использовать ресурс Azure OpenAI для генерации изображений путём переопределения базового URL. На пути генерации изображений OpenClaw обнаруживает имена хостов Azure в models.providers.openai.baseUrl и автоматически переключается на формат запросов Azure.

Используйте Azure OpenAI, если:

• У вас уже есть подписка Azure OpenAI, квота или корпоративное соглашение
• Вам нужны региональное хранение данных или средства контроля соответствия требованиям, предоставляемые Azure
• Вы хотите сохранить трафик внутри существующего клиента Azure

Конфигурация

Для генерации изображений Azure через встроенный провайдер openai направьте models.providers.openai.baseUrl на свой ресурс Azure и задайте в apiKey ключ Azure OpenAI (не ключ OpenAI Platform):

{  models: {    providers: {      openai: {        baseUrl: "https://<your-resource>.openai.azure.com",        apiKey: "<azure-openai-api-key>",      },    },  },}

OpenClaw распознаёт следующие суффиксы хостов Azure для маршрута генерации изображений Azure:

• *.openai.azure.com
• *.services.ai.azure.com
• *.cognitiveservices.azure.com

Для запросов генерации изображений на распознанном хосте Azure OpenClaw:

• Отправляет заголовок api-key вместо Authorization: Bearer
• Использует пути, привязанные к развёртыванию (/openai/deployments/{deployment}/...)
• Добавляет ?api-version=... к каждому запросу
• Использует тайм-аут запроса по умолчанию 600 с для вызовов генерации изображений Azure. Значения timeoutMs отдельных вызовов по-прежнему переопределяют это значение по умолчанию.

Другие базовые URL (общедоступный OpenAI, прокси-серверы, совместимые с OpenAI) сохраняют стандартный формат запросов изображений OpenAI.

Версия API

Задайте AZURE_OPENAI_API_VERSION, чтобы закрепить конкретную предварительную или общедоступную версию Azure для пути генерации изображений Azure:

export AZURE_OPENAI_API_VERSION="2024-12-01-preview"

Если переменная не задана, по умолчанию используется 2024-12-01-preview.

Имена моделей — это имена развёртываний

Azure OpenAI связывает модели с развёртываниями. Для запросов генерации изображений Azure, маршрутизируемых через встроенный провайдер openai, поле model в OpenClaw должно содержать имя развёртывания Azure, настроенное на портале Azure, а не идентификатор общедоступной модели OpenAI.

Если вы создадите развёртывание с именем gpt-image-2-prod, обслуживающее gpt-image-2:

/tool image_generate model=openai/gpt-image-2-prod prompt="Чистый плакат" size=1024x1024 count=1

То же правило имени развёртывания применяется к любому вызову генерации изображений, маршрутизируемому через встроенный провайдер openai.

Доступность по регионам

В настоящее время генерация изображений Azure доступна только в некоторых регионах (например, eastus2, swedencentral, polandcentral, westus3, uaenorth). Перед созданием развёртывания проверьте актуальный список регионов Microsoft и убедитесь, что нужная модель доступна в вашем регионе.

Различия параметров

Azure OpenAI и общедоступный OpenAI не всегда принимают одинаковые параметры изображений. Azure может отклонять параметры, разрешённые общедоступным OpenAI (например, некоторые значения background для gpt-image-2), или предоставлять их только в определённых версиях моделей. Эти различия обусловлены Azure и базовой моделью, а не OpenClaw. Если запрос Azure завершается ошибкой проверки, проверьте на портале Azure набор параметров, поддерживаемых конкретным развёртыванием и версией API.

Расширенная конфигурация

Приведённые ниже примеры params для отдельных моделей формируют встроенный запрос провайдера OpenClaw. Их настройка считается явно заданным поведением запроса, поэтому маршрут auto, который в иных условиях подходит, остаётся в OpenClaw вместо неявного выбора Codex. Нативная среда app-server Codex управляет собственным транспортом и параметрами запросов; явный agentRuntime.id: "codex" завершается отказом, если действующий маршрут не объявлен совместимым с Codex.

{  agents: {    defaults: {      models: {        "openai/gpt-5.5": {          params: { transport: "auto" },        },      },    },  },}

{  agents: {    defaults: {      models: {        "openai/gpt-5.5": { params: { fastMode: "auto", fastAutoOnSeconds: 30 } },      },    },  },}

{  agents: {    defaults: {      models: {        "openai/gpt-5.5": { params: { serviceTier: "priority" } },      },    },  },}

{  agents: {    defaults: {      models: {        "azure-openai-responses/gpt-5.5": {          params: { responsesServerCompaction: true },        },      },    },  },}

{  agents: {    defaults: {      models: {        "openai/gpt-5.5": {          params: {            responsesServerCompaction: true,            responsesCompactThreshold: 120000,          },        },      },    },  },}

{  agents: {    defaults: {      models: {        "openai/gpt-5.5": {          params: { responsesServerCompaction: false },        },      },    },  },}

{  agents: {    defaults: {      embeddedAgent: { executionContract: "default" },    },  },}

Связанные материалы