OpenAI

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

OpenClaw використовує openai/* як канонічний маршрут моделей OpenAI. Вбудовані ходи агента на моделях OpenAI типово виконуються через нативне середовище виконання сервера застосунку Codex; пряма автентифікація ключем API OpenAI залишається доступною для неагентних поверхонь OpenAI, як-от зображення, embeddings, мовлення та 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.

Обмежений попередній перегляд GPT-5.6

OpenClaw розпізнає три публічні ідентифікатори моделей GPT-5.6:

• openai/gpt-5.6-sol
• openai/gpt-5.6-terra
• openai/gpt-5.6-luna

Усі три надають reasoning max у поточному каталозі сервера застосунку Codex. Оголошення запуску OpenAI описує Sol як флагманський рівень, Terra як збалансований рівень, а Luna як швидкий рівень із нижчою вартістю. Див. оголошення про запуск GPT-5.6 і посібник із доступу до попереднього перегляду.

Доступ під час попереднього перегляду надається за списком дозволених і може бути наданий окремо для API та Codex. Лише платний план ChatGPT не надає доступу. OpenClaw залишає openai/gpt-5.5 типовим варіантом; вибір посилання GPT-5.6 без доступу повертає помилку доступу від upstream замість мовчазного fallback.

Покриття функцій OpenClaw

Embeddings пам’яті

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

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

Для сумісних з OpenAI кінцевих точок, які потребують асиметричних міток embeddings, задайте queryInputType і documentInputType у memorySearch. OpenClaw передає їх як специфічні для провайдера поля запиту input_type: embeddings запитів використовують 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 app-server

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

1. Упорядковані профілі автентифікації OpenAI для агента, бажано під auth.order.openai. Запустіть openclaw doctor --fix, щоб перенести старі legacy-id профілів автентифікації Codex і legacy-порядок автентифікації Codex.
2. Наявний обліковий запис app-server, наприклад локальний вхід Codex CLI ChatGPT.
3. Лише для локальних запусків stdio app-server: CODEX_API_KEY, потім OPENAI_API_KEY, коли app-server повідомляє про відсутність облікового запису й усе ще потребує автентифікації OpenAI.

Це означає, що локальний вхід підписки ChatGPT/Codex не замінюється лише тому, що процес Gateway також має OPENAI_API_KEY для прямих моделей OpenAI або embeddings. Резервний API-ключ з env використовується лише в локальному stdio-шляху без облікового запису; він не надсилається до WebSocket-з’єднань app-server. Коли вибрано профіль Codex у стилі підписки, OpenClaw також не передає CODEX_API_KEY і OPENAI_API_KEY до дочірнього процесу stdio app-server і надсилає вибрані облікові дані через RPC входу app-server. Коли цей профіль підписки заблоковано лімітом використання 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".

Для запиту з прозорим тлом агенти мають викликати 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 "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 і надсилає запити зображень через бекенд 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. Він застосовується за ідентифікатором моделі, тому маршрути OpenClaw/провайдера, як-от застарілі refs до виправлення (застарілий ref Codex GPT-5.5), openrouter/openai/gpt-5.5, opencode/gpt-5.5 та інші сумісні refs GPT-5, отримують той самий оверлей. Старіші моделі GPT-4.x не отримують його.

Вбудований нативний harness Codex не отримує цей оверлей OpenClaw GPT-5 через інструкції розробника Codex app-server. Нативний Codex зберігає базову поведінку, модель і поведінку документації проєкту, що належать Codex, тоді як OpenClaw вимикає вбудовану особистість Codex для нативних потоків, щоб файли особистості робочого простору агента залишалися авторитетними. OpenClaw додає лише runtime-контекст, як-от доставку каналами, динамічні інструменти OpenClaw, делегування ACP, контекст робочого простору та Skills OpenClaw.

Внесок 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, щоб зафіксувати конкретну preview- або GA-версію 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="A clean poster" size=1024x1024 count=1

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

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

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

Відмінності параметрів

Azure OpenAI і публічний OpenAI не завжди приймають однакові параметри зображень. Azure може відхиляти параметри, які дозволяє публічний OpenAI (наприклад, певні значення background для gpt-image-2), або надавати їх лише для конкретних версій моделей. Ці відмінності походять від Azure і базової моделі, а не від OpenClaw. Якщо запит Azure завершується помилкою валідації, перевірте набір параметрів, який підтримує ваше конкретне розгортання та версія 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" },    },  },}

Пов’язане