Перейти до основного вмісту

​
OpenAI

OpenAI надає API для розробників для моделей GPT. OpenClaw підтримує два варіанти автентифікації:
  • API-ключ — прямий доступ до OpenAI Platform з оплатою за використання (моделі openai/*)
  • Підписка Codex — вхід через ChatGPT/Codex із доступом за підпискою (моделі openai-codex/*)
OpenAI явно підтримує використання OAuth за підпискою в зовнішніх інструментах і робочих процесах, таких як OpenClaw.

​
Початок роботи

Виберіть бажаний спосіб автентифікації та виконайте кроки налаштування.
Найкраще підходить для: прямого доступу до API та оплати за використання.
1

Отримайте свій API-ключ

Створіть або скопіюйте API-ключ на панелі керування OpenAI Platform.
2

Запустіть онбординг

openclaw onboard --auth-choice openai-api-key
Або передайте ключ напряму:
openclaw onboard --openai-api-key "$OPENAI_API_KEY"
3

Перевірте, що модель доступна

openclaw models list --provider openai

​
Підсумок маршрутів

Посилання на модельМаршрутАвтентифікація
openai/gpt-5.4Прямий API OpenAI PlatformOPENAI_API_KEY
openai/gpt-5.4-proПрямий API OpenAI PlatformOPENAI_API_KEY
Вхід через ChatGPT/Codex маршрутизується через openai-codex/*, а не openai/*.

​
Приклад конфігурації

{
  env: { OPENAI_API_KEY: "sk-..." },
  agents: { defaults: { model: { primary: "openai/gpt-5.4" } } },
}
OpenClaw не надає openai/gpt-5.3-codex-spark у прямому маршруті API. Живі запити до OpenAI API відхиляють цю модель. Spark доступний лише в Codex.

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

Вбудований Plugin openai реєструє генерацію зображень через інструмент image_generate.
МожливістьЗначення
Модель за замовчуваннямopenai/gpt-image-1
Максимум зображень на запит4
Режим редагуванняУвімкнено (до 5 еталонних зображень)
Перевизначення розміруПідтримується
Співвідношення сторін / роздільна здатністьНе передаються до OpenAI Images API
{
  agents: {
    defaults: {
      imageGenerationModel: { primary: "openai/gpt-image-1" },
    },
  },
}
Див. Генерація зображень, щоб дізнатися про спільні параметри інструмента, вибір провайдера та поведінку failover.

​
Генерація відео

Вбудований Plugin openai реєструє генерацію відео через інструмент video_generate.
МожливістьЗначення
Модель за замовчуваннямopenai/sora-2
РежимиТекст у відео, зображення у відео, редагування одного відео
Вхідні еталони1 зображення або 1 відео
Перевизначення розміруПідтримується
Інші перевизначенняaspectRatio, resolution, audio, watermark ігноруються з попередженням інструмента
{
  agents: {
    defaults: {
      videoGenerationModel: { primary: "openai/sora-2" },
    },
  },
}
Див. Генерація відео, щоб дізнатися про спільні параметри інструмента, вибір провайдера та поведінку failover.

​
Накладення особистості

OpenClaw додає невелике специфічне для OpenAI накладення промпта для запусків openai/* і openai-codex/*. Це накладення робить асистента теплим, орієнтованим на співпрацю, лаконічним і трохи більш емоційно виразним, не замінюючи базовий системний промпт.
ЗначенняЕфект
"friendly" (типово)Увімкнути специфічне для OpenAI накладення
"on"Псевдонім для "friendly"
"off"Використовувати лише базовий промпт OpenClaw
{
  plugins: {
    entries: {
      openai: { config: { personality: "friendly" } },
    },
  },
}
Під час виконання значення не чутливі до регістру, тож і "Off", і "off" вимикають накладення.

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

Вбудований Plugin openai реєструє синтез мовлення для поверхні messages.tts.
ПараметрШлях конфігураціїТипово
Модельmessages.tts.providers.openai.modelgpt-4o-mini-tts
Голосmessages.tts.providers.openai.voicecoral
Швидкістьmessages.tts.providers.openai.speed(не встановлено)
Інструкціїmessages.tts.providers.openai.instructions(не встановлено, лише gpt-4o-mini-tts)
Форматmessages.tts.providers.openai.responseFormatopus для голосових нотаток, mp3 для файлів
API-ключmessages.tts.providers.openai.apiKeyВикористовує OPENAI_API_KEY як запасний варіант
Base URLmessages.tts.providers.openai.baseUrlhttps://api.openai.com/v1
Доступні моделі: gpt-4o-mini-tts, tts-1, tts-1-hd. Доступні голоси: alloy, ash, ballad, cedar, coral, echo, fable, juniper, marin, onyx, nova, sage, shimmer, verse.
{
  messages: {
    tts: {
      providers: {
        openai: { model: "gpt-4o-mini-tts", voice: "coral" },
      },
    },
  },
}
Установіть OPENAI_TTS_BASE_URL, щоб перевизначити базовий URL для TTS, не впливаючи на кінцеву точку chat API.
Вбудований Plugin openai реєструє транскрипцію в реальному часі для Plugin Voice Call.
ПараметрШлях конфігураціїТипово
Модельplugins.entries.voice-call.config.streaming.providers.openai.modelgpt-4o-transcribe
Тривалість тиші...openai.silenceDurationMs800
Поріг VAD...openai.vadThreshold0.5
API-ключ...openai.apiKeyВикористовує OPENAI_API_KEY як запасний варіант
Використовує WebSocket-з’єднання з wss://api.openai.com/v1/realtime з аудіо G.711 u-law.
Вбудований Plugin openai реєструє голос у реальному часі для Plugin Voice Call.
ПараметрШлях конфігураціїТипово
Модельplugins.entries.voice-call.config.realtime.providers.openai.modelgpt-realtime
Голос...openai.voicealloy
Temperature...openai.temperature0.8
Поріг VAD...openai.vadThreshold0.5
Тривалість тиші...openai.silenceDurationMs500
API-ключ...openai.apiKeyВикористовує OPENAI_API_KEY як запасний варіант
Підтримує Azure OpenAI через ключі конфігурації azureEndpoint і azureDeployment. Підтримує двонапрямлений виклик інструментів. Використовує аудіоформат G.711 u-law.

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

OpenClaw використовує пріоритет WebSocket із запасним переходом на SSE ("auto") як для openai/*, так і для openai-codex/*.У режимі "auto" OpenClaw:
  • Повторює одну ранню невдалу спробу WebSocket перед переходом на SSE
  • Після збою позначає WebSocket як деградований приблизно на 60 секунд і використовує SSE під час охолодження
  • Додає стабільні заголовки ідентичності сесії та ходу для повторних спроб і повторних підключень
  • Нормалізує лічильники використання (input_tokens / prompt_tokens) між варіантами транспорту
ЗначенняПоведінка
"auto" (типово)Спочатку WebSocket, запасний перехід на SSE
"sse"Примусово лише SSE
"websocket"Примусово лише WebSocket
{
  agents: {
    defaults: {
      models: {
        "openai-codex/gpt-5.4": {
          params: { transport: "auto" },
        },
      },
    },
  },
}
Пов’язана документація OpenAI:
OpenClaw типово вмикає прогрів WebSocket для openai/*, щоб зменшити затримку першого ходу.
// Вимкнути прогрів
{
  agents: {
    defaults: {
      models: {
        "openai/gpt-5.4": {
          params: { openaiWsWarmup: false },
        },
      },
    },
  },
}
OpenClaw надає спільний перемикач швидкого режиму для openai/* і openai-codex/*:
  • Чат/UI: /fast status|on|off
  • Конфігурація: agents.defaults.models["<provider>/<model>"].params.fastMode
Коли ввімкнено, OpenClaw зіставляє швидкий режим із пріоритетною обробкою OpenAI (service_tier = "priority"). Наявні значення service_tier зберігаються, а швидкий режим не переписує reasoning або text.verbosity.
{
  agents: {
    defaults: {
      models: {
        "openai/gpt-5.4": { params: { fastMode: true } },
        "openai-codex/gpt-5.4": { params: { fastMode: true } },
      },
    },
  },
}
Перевизначення на рівні сесії мають пріоритет над конфігурацією. Очищення перевизначення сесії в інтерфейсі Sessions повертає сесію до налаштованого типового значення.
API OpenAI надає пріоритетну обробку через service_tier. Установіть її для кожної моделі в OpenClaw:
{
  agents: {
    defaults: {
      models: {
        "openai/gpt-5.4": { params: { serviceTier: "priority" } },
        "openai-codex/gpt-5.4": { params: { serviceTier: "priority" } },
      },
    },
  },
}
Підтримувані значення: auto, default, flex, priority.
serviceTier передається лише до нативних кінцевих точок OpenAI (api.openai.com) і нативних кінцевих точок Codex (chatgpt.com/backend-api). Якщо ви маршрутизуєте будь-якого з провайдерів через проксі, OpenClaw залишає service_tier без змін.
Для прямих моделей OpenAI Responses (openai/* на api.openai.com) OpenClaw автоматично вмикає серверну Compaction:
  • Примусово встановлює store: true (якщо лише сумісність моделі не встановлює supportsStore: false)
  • Додає context_management: [{ type: "compaction", compact_threshold: ... }]
  • Типове значення compact_threshold: 70% від contextWindow (або 80000, якщо недоступно)
Корисно для сумісних кінцевих точок, таких як Azure OpenAI Responses:
{
  agents: {
    defaults: {
      models: {
        "azure-openai-responses/gpt-5.4": {
          params: { responsesServerCompaction: true },
        },
      },
    },
  },
}
responsesServerCompaction керує лише додаванням context_management. Прямі моделі OpenAI Responses усе одно примусово встановлюють store: true, якщо сумісність не задає supportsStore: false.
Для запусків сімейства GPT-5 на openai/* і openai-codex/* OpenClaw може використовувати суворіший вбудований контракт виконання:
{
  agents: {
    defaults: {
      embeddedPi: { executionContract: "strict-agentic" },
    },
  },
}
Із strict-agentic OpenClaw:
  • Більше не вважає хід лише з планом успішним прогресом, коли доступна дія інструмента
  • Повторює хід із вказівкою діяти негайно
  • Автоматично вмикає update_plan для суттєвої роботи
  • Показує явний заблокований стан, якщо модель продовжує планувати без дії
Застосовується лише до запусків сімейства GPT-5 OpenAI та Codex. Інші провайдери й старіші сімейства моделей зберігають типову поведінку.
OpenClaw по-різному обробляє прямі кінцеві точки OpenAI, Codex і Azure OpenAI та загальні сумісні з OpenAI проксі /v1:Нативні маршрути (openai/*, openai-codex/*, Azure OpenAI):
  • Зберігають reasoning: { effort: "none" } без змін, коли міркування явно вимкнено
  • Типово використовують суворий режим для схем інструментів
  • Додають приховані заголовки атрибуції лише на перевірених нативних хостах
  • Зберігають формування запитів, характерне лише для OpenAI (service_tier, store, сумісність reasoning, підказки кешу промптів)
Проксі/сумісні маршрути:
  • Використовують м’якшу поведінку сумісності
  • Не примушують до суворих схем інструментів або нативних заголовків
Azure OpenAI використовує нативний транспорт і нативну поведінку сумісності, але не отримує приховані заголовки атрибуції.

​
Пов’язане

Вибір моделі

Вибір провайдерів, посилань на моделі та поведінки failover.

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

Спільні параметри інструмента зображень і вибір провайдера.

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

Спільні параметри інструмента відео і вибір провайдера.

OAuth і автентифікація

Докладніше про автентифікацію та правила повторного використання облікових даних.