OpenAI

OpenAI предоставляет API для разработчиков для моделей GPT, а Codex также доступен как агент для программирования в рамках плана ChatGPT через клиенты Codex от OpenAI. OpenClaw использует один идентификатор провайдера, openai, для обеих форм аутентификации.

OpenClaw использует openai/* как канонический маршрут моделей OpenAI. Встроенные ходы агента на моделях OpenAI по умолчанию выполняются через нативную среду выполнения Codex app-server; прямая аутентификация по API-ключу OpenAI остается доступной для неагентских поверхностей OpenAI, таких как изображения, эмбеддинги, речь и realtime.

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

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

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

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

Карта имен

Названия похожи, но не взаимозаменяемы:

Это означает, что конфигурация может намеренно содержать ссылки на модели openai/*, тогда как профили аутентификации указывают либо на учетные данные API-ключа, либо на OAuth ChatGPT/Codex. Используйте auth.order.openai для конфигурации; openclaw doctor --fix переписывает устаревшие ссылки на модели Codex, устаревшие идентификаторы профилей аутентификации Codex и устаревший порядок аутентификации Codex на канонический маршрут OpenAI.

Покрытие возможностей 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.5" } } },}

{  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.5

openclaw models list --provider openai

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

{  plugins: { entries: { codex: { enabled: true } } },  agents: {    defaults: {      model: { primary: "openai/gpt-5.5" },    },  },  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

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

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

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

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

Встроенный Plugin openai регистрирует генерацию изображений через инструмент image_generate. Он поддерживает как генерацию изображений по API-ключу OpenAI, так и генерацию изображений через OAuth Codex через одну и ту же ссылку модели 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".

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

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

openclaw infer image generate \  --model openai/gpt-image-1.5 \  --output-format png \  --background transparent \  --prompt "A simple red circle sticker on a transparent background" \  --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-токен доступа и отправляет запросы изображений через backend Codex Responses. Он не пытается сначала использовать OPENAI_API_KEY и не выполняет тихий откат к API-ключу для этого запроса. Настройте models.providers.openai явно с API-ключом, пользовательским базовым URL или конечной точкой Azure, когда нужен прямой маршрут OpenAI Images API. Если эта пользовательская конечная точка изображений находится в доверенной LAN/частной адресации, также задайте browser.ssrfPolicy.dangerouslyAllowPrivateNetwork: true; OpenClaw оставляет частные/внутренние OpenAI-совместимые конечные точки изображений заблокированными, если это явное согласие не присутствует.

Сгенерировать:

/tool image_generate model=openai/gpt-image-2 prompt="A polished launch poster for OpenClaw on macOS" size=3840x2160 count=1

Сгенерировать прозрачный PNG:

/tool image_generate model=openai/gpt-image-1.5 prompt="A simple red circle sticker on a transparent background" outputFormat=png background=transparent

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

/tool image_generate model=openai/gpt-image-2 prompt="Preserve the object shape, change the material to translucent glass" image=/path/to/reference.png size=1024x1536

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

Встроенный Plugin 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 на поверхностях промптов, собранных OpenClaw. Он применяется по id модели, поэтому маршруты OpenClaw/провайдеров, такие как устаревшие ссылки до исправления (устаревшая ссылка Codex GPT-5.5), openrouter/openai/gpt-5.5, opencode/gpt-5.5 и другие совместимые ссылки GPT-5 получают тот же overlay. Более старые модели GPT-4.x не получают его.

Встроенный нативный harness Codex не получает этот GPT-5 overlay OpenClaw через developer instructions сервера приложения Codex. Нативный Codex сохраняет принадлежащее Codex поведение base, model и project-doc, а OpenClaw отключает встроенную personality Codex для нативных threads, чтобы файлы personality рабочей области agent оставались авторитетными. OpenClaw добавляет только runtime-контекст, такой как доставка канала, динамические инструменты OpenClaw, делегирование ACP, контекст рабочей области и OpenClaw Skills.

Вклад GPT-5 добавляет помеченный контракт поведения для сохранения persona, безопасности выполнения, дисциплины инструментов, формы вывода, проверок завершения и верификации на соответствующих промптах, собранных OpenClaw. Поведение ответов, специфичное для каналов, и silent-message остается в общем системном промпте 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
• Использует пути в области deployment (/openai/deployments/{deployment}/...)
• Добавляет ?api-version=... к каждому запросу
• Использует стандартный тайм-аут запроса 600 с для вызовов генерации изображений Azure. Значения timeoutMs для отдельных вызовов по-прежнему переопределяют это значение по умолчанию.

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

Версия API

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

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

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

Имена моделей — это имена deployment

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

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

/tool image_generate model=openai/gpt-image-2-prod prompt="A clean poster" size=1024x1024 count=1

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

Региональная доступность

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

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

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

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

{  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: "strict-agentic" },    },  },}

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