OpenAI

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

• Моделі агентів — openai/* через середовище виконання, вибране явною конфігурацією agentRuntime або неявною політикою маршруту OpenAI. Увійдіть за допомогою автентифікації Codex, щоб використовувати передплату ChatGPT/Codex, або налаштуйте профіль автентифікації за ключем API, якщо потрібна тарифікація за ключем.
• Неагентні API OpenAI — прямий доступ до OpenAI Platform із тарифікацією за використання, через OPENAI_API_KEY або профіль автентифікації за ключем API openai.
• Застаріла конфігурація — посилання codex/* і openai-codex/* виправляються на openai/* разом з обмеженим моделлю agentRuntime.id: "codex" за допомогою 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" залишає в OpenClaw маршрут, який за інших умов відповідав би вимогам Codex, тоді як agentRuntime.id: "codex" вимагає Codex і завершується відмовою, якщо фактичний маршрут не оголошено сумісним із Codex. Вибір середовища виконання не змінює тип облікових даних або тарифікацію: автентифікація за ключем API Platform та автентифікація за передплатою ChatGPT/Codex залишаються окремими.

openclaw doctor --fix переносить застарілі посилання на моделі codex/* і openai-codex/*, застарілі ідентифікатори профілів автентифікації Codex і застарілі записи порядку автентифікації Codex до канонічного маршруту openai. Перенесені посилання на моделі отримують обмежений моделлю agentRuntime.id: "codex"; використовуйте 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. Після настання часу скидання профіль підписки знову стає придатним.

Генерування зображень

Вбудований 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 та OAuth OpenAI Codex, переписуючи типові прозорі запити 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. Використовуйте --openai-moderation low|auto, щоб передати підказку модерації OpenAI з image generate або image edit.

Для встановлень з OAuth ChatGPT/Codex зберігайте те саме посилання openai/gpt-image-2. Коли налаштовано профіль OAuth openai, OpenClaw визначає збережений токен доступу OAuth і надсилає запити зображень через серверну частину Codex Responses; він не намагається спочатку використати OPENAI_API_KEY і не переходить непомітно на ключ API. Явно налаштуйте models.providers.openai із ключем API, власною базовою URL-адресою або кінцевою точкою Azure, коли натомість потрібен прямий маршрут API зображень OpenAI. Якщо ця власна кінцева точка зображень розташована в довіреній LAN або за приватною адресою, також установіть 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

Генерування відео

Вбудований 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 у провайдера 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 завершується помилкою перевірки, перегляньте набір параметрів, підтримуваний конкретним розгортанням і версією API, на порталі Azure.

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

Наведені нижче приклади params для окремих моделей формують запит вбудованого провайдера OpenClaw. Їх налаштування є явно заданою поведінкою запиту, тому маршрут auto, який за інших умов відповідає вимогам, залишається в OpenClaw замість неявного вибору Codex. Нативний серверний каркас застосунку 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" },    },  },}

Пов’язане