​

OpenAI

​

Стиль взаємодії за замовчуванням

• "friendly": значення за замовчуванням; увімкнути специфічне для OpenAI накладання.
• "off": вимкнути накладання і використовувати лише базовий промпт OpenClaw.

• Застосовується до моделей openai/*.
• Застосовується до моделей openai-codex/*.
• Не впливає на інших провайдерів.

{
  plugins: {
    entries: {
      openai: {
        config: {
          personality: "friendly",
        },
      },
    },
  },
}

​

Вимкнення накладання промпту OpenAI

{
  plugins: {
    entries: {
      openai: {
        config: {
          personality: "off",
        },
      },
    },
  },
}

openclaw config set plugins.entries.openai.config.personality off

​

Варіант A: API key OpenAI (OpenAI Platform)

​

Налаштування CLI

openclaw onboard --auth-choice openai-api-key
# або неінтерактивно
openclaw onboard --openai-api-key "$OPENAI_API_KEY"

​

Фрагмент конфігурації

{
  env: { OPENAI_API_KEY: "sk-..." },
  agents: { defaults: { model: { primary: "openai/gpt-5.4" } } },
}

​

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

• Модель зображень за замовчуванням: openai/gpt-image-1
• Генерація: до 4 зображень за запит
• Режим редагування: увімкнено, до 5 еталонних зображень
• Підтримує size
• Поточне специфічне для OpenAI обмеження: OpenClaw наразі не передає перевизначення aspectRatio або resolution до OpenAI Images API

{
  agents: {
    defaults: {
      imageGenerationModel: {
        primary: "openai/gpt-image-1",
      },
    },
  },
}

​

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

• Модель відео за замовчуванням: openai/sora-2
• Режими: текст у відео, зображення у відео, а також потоки з одним еталонним відео для редагування
• Поточні обмеження: 1 зображення або 1 еталонний відеовхід
• Поточне специфічне для OpenAI обмеження: OpenClaw наразі не передає перевизначення aspectRatio або resolution до нативного відео API OpenAI

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

​

Варіант B: підписка OpenAI Code (Codex)

​

Налаштування CLI (Codex OAuth)

# Запустити Codex OAuth у майстрі
openclaw onboard --auth-choice openai-codex

# Або запустити OAuth напряму
openclaw models auth login --provider openai-codex

​

Фрагмент конфігурації (підписка Codex)

{
  agents: { defaults: { model: { primary: "openai-codex/gpt-5.4" } } },
}

• openai-codex/gpt-5.3-codex-spark

​

Обмеження вікна контексту Codex

• нативне contextWindow: 1050000
• обмеження contextTokens під час виконання за замовчуванням: 272000

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

​

Транспорт за замовчуванням

• "sse": примусово використовувати SSE
• "websocket": примусово використовувати WebSocket
• "auto": спробувати WebSocket, а потім перейти до SSE

• Realtime API with WebSocket
• Streaming API responses (SSE)

{
  agents: {
    defaults: {
      model: { primary: "openai-codex/gpt-5.4" },
      models: {
        "openai-codex/gpt-5.4": {
          params: {
            transport: "auto",
          },
        },
      },
    },
  },
}

​

Прогрів OpenAI WebSocket

​

Вимкнення прогріву

{
  agents: {
    defaults: {
      models: {
        "openai/gpt-5.4": {
          params: {
            openaiWsWarmup: false,
          },
        },
      },
    },
  },
}

​

Явне ввімкнення прогріву

{
  agents: {
    defaults: {
      models: {
        "openai/gpt-5.4": {
          params: {
            openaiWsWarmup: true,
          },
        },
      },
    },
  },
}

​

Пріоритетна обробка OpenAI і Codex

{
  agents: {
    defaults: {
      models: {
        "openai/gpt-5.4": {
          params: {
            serviceTier: "priority",
          },
        },
        "openai-codex/gpt-5.4": {
          params: {
            serviceTier: "priority",
          },
        },
      },
    },
  },
}

• прямий openai/* має бути спрямований на api.openai.com
• openai-codex/* має бути спрямований на chatgpt.com/backend-api
• якщо ви маршрутизуєте будь-якого з цих провайдерів через інший base URL або проксі, OpenClaw залишає service_tier без змін

​

Швидкий режим OpenAI

• Chat/UI: /fast status|on|off
• Конфігурація: agents.defaults.models["<provider>/<model>"].params.fastMode

• прямі виклики openai/* Responses до api.openai.com надсилають service_tier = "priority"
• виклики openai-codex/* Responses до chatgpt.com/backend-api також надсилають service_tier = "priority"
• наявні значення service_tier у payload зберігаються
• швидкий режим не переписує reasoning або text.verbosity

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

​

Нативні маршрути OpenAI порівняно з OpenAI-compatible маршрутами

• нативні маршрути openai/*, openai-codex/* і Azure OpenAI зберігають reasoning: { effort: "none" } без змін, коли ви явно вимикаєте reasoning
• для нативних маршрутів сімейства OpenAI схеми інструментів за замовчуванням переводяться в строгий режим
• приховані заголовки атрибуції OpenClaw (originator, version і User-Agent) додаються лише на перевірених нативних хостах OpenAI (api.openai.com) і нативних хостах Codex (chatgpt.com/backend-api)
• нативні маршрути OpenAI/Codex зберігають формування запитів, специфічне для OpenAI, таке як service_tier, store у Responses, payload-и сумісності OpenAI reasoning і підказки кешу промптів
• OpenAI-compatible маршрути у стилі проксі зберігають більш вільну поведінку сумісності та не примусово вмикають строгі схеми інструментів, нативне формування запитів або приховані заголовки атрибуції OpenAI/Codex

​

Серверна компактизація OpenAI Responses

• Примусово встановлює store: true (якщо compat моделі не встановлює supportsStore: false)
• Вставляє context_management: [{ type: "compaction", compact_threshold: ... }]

​

Явне ввімкнення серверної компактизації

{
  agents: {
    defaults: {
      models: {
        "azure-openai-responses/gpt-5.4": {
          params: {
            responsesServerCompaction: true,
          },
        },
      },
    },
  },
}

​

Увімкнення з власним порогом

{
  agents: {
    defaults: {
      models: {
        "openai/gpt-5.4": {
          params: {
            responsesServerCompaction: true,
            responsesCompactThreshold: 120000,
          },
        },
      },
    },
  },
}

​

Вимкнення серверної компактизації

{
  agents: {
    defaults: {
      models: {
        "openai/gpt-5.4": {
          params: {
            responsesServerCompaction: false,
          },
        },
      },
    },
  },
}

​

Примітки

• Посилання на моделі завжди використовують provider/model (див. /concepts/models).
• Докладні відомості про автентифікацію та правила повторного використання наведено в /concepts/oauth.