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.

​

Відстеження використання та вартості

• OAuth ChatGPT/Codex показує план передплати, вікна квот і баланс кредитів.
• OPENAI_ADMIN_KEY показує в розділі Використання Control UI дані за 30 днів про повідомлену провайдером вартість організації та використання завершень, зокрема щоденні витрати, загальну кількість запитів і токенів, найпопулярніші моделі та категорії витрат.
• OPENAI_PROJECT_ID за потреби обмежує історію Admin API одним проєктом.
• OpenClaw ніколи не надсилає OPENAI_API_KEY або профіль виведення openai до API організації; ці облікові дані можуть належати спеціальним кінцевим точкам, Azure або локальним кінцевим точкам агента.

​

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

​

Відповідність назв

​

Неявне середовище виконання агента

​

Обмежений попередній доступ до GPT-5.6

openclaw models list --provider openai

openclaw models set openai/gpt-5.5

​

Підтримка функцій OpenClaw

​

Векторні представлення пам’яті

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

​

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

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 status
openclaw models auth list --provider openai
openclaw config get agents.defaults.model --json
openclaw config get models.providers.openai.agentRuntime --json

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

openclaw doctor --fix
openclaw config validate

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

openclaw models auth login --provider openai --profile-id openai:ritsuko
openclaw models auth login --provider openai --profile-id openai:lain

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

​

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

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.

​

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

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

openclaw infer image generate \
  --model openai/gpt-image-1.5 \
  --output-format png \
  --background transparent \
  --prompt "Проста наліпка у вигляді червоного кола на прозорому тлі" \
  --json

/tool image_generate model=openai/gpt-image-2 prompt="Професійний плакат запуску OpenClaw на macOS" size=3840x2160 count=1

/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

​

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

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

​

Внесок у промпт 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", speakerVoice: "coral" },
      },
    },
  },
}

{
  tools: {
    media: {
      audio: {
        models: [
          {
            type: "provider",
            provider: "openai",
            model: "gpt-4o-transcribe",
          },
        ],
      },
    },
  },
}

​

Кінцеві точки Azure OpenAI

• У вас уже є передплата Azure OpenAI, квота або корпоративна угода
• Вам потрібні регіональне розміщення даних або засоби контролю відповідності, які надає Azure
• Ви хочете зберігати трафік у межах наявного клієнтського середовища Azure

​

Конфігурація

{
  models: {
    providers: {
      openai: {
        baseUrl: "https://<your-resource>.openai.azure.com",
        apiKey: "<azure-openai-api-key>",
      },
    },
  },
}

• *.openai.azure.com
• *.services.ai.azure.com
• *.cognitiveservices.azure.com

• Надсилає заголовок api-key замість Authorization: Bearer
• Використовує шляхи, прив’язані до розгортання (/openai/deployments/{deployment}/...)
• Додає ?api-version=... до кожного запиту
• Використовує стандартний час очікування запиту 600 с для викликів генерування зображень Azure. Значення timeoutMs для окремих викликів і надалі перевизначають це стандартне значення.

​

Версія API

export AZURE_OPENAI_API_VERSION="2024-12-01-preview"

​

Назви моделей — це назви розгортань

/tool image_generate model=openai/gpt-image-2-prod prompt="Чистий плакат" size=1024x1024 count=1

​

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

​

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

​

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

{
  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" },
    },
  },
}

​

Пов’язане