OpenAI

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

OpenClaw підтримує три маршрути родини OpenAI. Більшості передплатників ChatGPT/Codex, які хочуть поведінку Codex, слід використовувати нативне середовище виконання app-server Codex. Префікс моделі вибирає назву постачальника/моделі; окреме налаштування середовища виконання вибирає, хто виконує вбудований цикл агента:

• Ключ API - прямий доступ до OpenAI Platform із тарифікацією за використання (openai/* моделі)
• Передплата Codex із нативним середовищем виконання Codex - вхід через ChatGPT/Codex плюс виконання app-server Codex (openai/* моделі плюс agents.defaults.agentRuntime.id: "codex")
• Передплата Codex через PI - вхід через ChatGPT/Codex зі звичайним раннером OpenClaw PI (openai-codex/* моделі)

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

Постачальник, модель, середовище виконання й канал є окремими шарами. Якщо ці мітки змішуються між собою, прочитайте Середовища виконання агентів, перш ніж змінювати конфігурацію.

# Швидкий вибір

# Мапа назв

Назви схожі, але не взаємозамінні:

Це означає, що конфігурація може навмисно містити і openai-codex/*, і codex plugin. Це коректно, коли ви хочете Codex OAuth через PI і також хочете, щоб були доступні нативні елементи керування чатом /codex. openclaw doctor попереджає про таке поєднання, щоб ви могли підтвердити, що воно навмисне; він не переписує його.

# Покриття можливостей 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: "sk-..." },
  agents: { defaults: { model: { primary: "openai/gpt-5.5" } } },
}

openclaw onboard --auth-choice openai-codex

openclaw models auth login --provider openai-codex

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

openclaw config set plugins.entries.codex '{"enabled":true}' --strict-json --merge
openclaw config set agents.defaults.model.primary openai/gpt-5.5
openclaw config set agents.defaults.agentRuntime '{"id":"codex"}' --strict-json

openclaw models list --provider openai-codex

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

openclaw models status
openclaw models auth list --provider openai-codex
openclaw config get agents.defaults.model --json
openclaw config get agents.defaults.agentRuntime --json

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

openclaw models set openai-codex/gpt-5.5
openclaw config validate

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

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

# Нативна автентифікація сервера застосунку Codex

Нативна обв’язка сервера застосунку Codex використовує посилання на моделі openai/* плюс agentRuntime.id: "codex", але її автентифікація все одно базується на обліковому записі. OpenClaw вибирає автентифікацію в такому порядку:

1. Явний профіль автентифікації OpenClaw openai-codex, прив’язаний до агента.
2. Наявний обліковий запис сервера застосунку, наприклад локальний вхід Codex CLI ChatGPT.
3. Лише для локальних запусків stdio сервера застосунку: CODEX_API_KEY, потім OPENAI_API_KEY, коли сервер застосунку повідомляє, що облікового запису немає, але все ще потребує автентифікації OpenAI.

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

# Генерація зображень

Вбудований Plugin 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-сумісні endpoint зберігають налаштовані імена розгортань/моделей.

Те саме налаштування доступне для 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-специфічний псевдонім.

Для встановлень Codex OAuth залишайте те саме посилання openai/gpt-image-2. Коли налаштовано OAuth-профіль openai-codex, OpenClaw розв’язує цей збережений OAuth access token і надсилає запити зображень через бекенд Codex Responses. Він не намагається спершу використати OPENAI_API_KEY і не перемикається непомітно на API-ключ для цього запиту. Налаштуйте models.providers.openai явно з API-ключем, власною базовою URL-адресою або endpoint Azure, коли потрібен прямий маршрут OpenAI Images API . Якщо цей власний endpoint зображень розташований у довіреній LAN/приватній адресі, також задайте browser.ssrfPolicy.dangerouslyAllowPrivateNetwork: true; OpenClaw залишає приватні/внутрішні OpenAI-сумісні endpoint зображень заблокованими, якщо цього opt-in немає.

Згенерувати:

/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.

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

# Внесок підказки GPT-5

OpenClaw додає спільний внесок підказки GPT-5 для запусків сімейства GPT-5 у різних провайдерів. Він застосовується за id моделі, тож openai-codex/gpt-5.5, openai/gpt-5.5, openrouter/openai/gpt-5.5, opencode/gpt-5.5 та інші сумісні посилання GPT-5 отримують те саме накладання. Старіші моделі GPT-4.x його не отримують.

Вбудована нативна обв’язка Codex використовує ту саму поведінку GPT-5 і накладання Heartbeat через developer instructions сервера застосунку Codex, тож сеанси openai/gpt-5.x, примусово проведені через agentRuntime.id: "codex", зберігають ті самі настанови щодо доведення справ до кінця та проактивного Heartbeat, навіть якщо Codex володіє рештою підказки обв’язки.

Внесок GPT-5 додає тегований поведінковий контракт для сталості персони, безпеки виконання, дисципліни інструментів, форми виводу, перевірок завершення та верифікації. Поведінка відповідей для конкретних каналів і тихих повідомлень залишається у спільній системній підказці OpenClaw та політиці вихідної доставки. Настанови GPT-5 завжди ввімкнені для відповідних моделей. Дружній шар стилю взаємодії є окремим і налаштовуваним.

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

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

# Голос і мовлення

{
  messages: {
    tts: {
      providers: {
        openai: { model: "gpt-4o-mini-tts", voice: "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 прив'язує моделі до deployments. Для запитів генерації зображень Azure, маршрутизованих через вбудований провайдер openai, поле model в OpenClaw має бути назвою Azure deployment, яку ви налаштували на порталі 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). Перевірте поточний список регіонів Microsoft перед створенням deployment і підтвердьте, що конкретна модель пропонується у вашому регіоні.

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

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" },
        },
        "openai-codex/gpt-5.5": {
          params: { transport: "auto" },
        },
      },
    },
  },
}

// Disable warm-up
{
  agents: {
    defaults: {
      models: {
        "openai/gpt-5.5": {
          params: { openaiWsWarmup: false },
        },
      },
    },
  },
}

{
  agents: {
    defaults: {
      models: {
        "openai/gpt-5.5": { params: { fastMode: true } },
      },
    },
  },
}

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

# Пов’язане