OpenAI

OpenAI udostępnia deweloperskie API dla modeli GPT, a Codex jest także dostępny jako agent kodujący w planie ChatGPT przez klientów Codex firmy OpenAI. OpenClaw używa jednego identyfikatora dostawcy, openai, dla obu kształtów uwierzytelniania.

OpenClaw używa openai/* jako kanonicznej trasy modeli OpenAI. Osadzone tury agentów na modelach OpenAI domyślnie działają przez natywne środowisko uruchomieniowe serwera aplikacji Codex; bezpośrednie uwierzytelnianie kluczem API OpenAI pozostaje dostępne dla nieagentowych powierzchni OpenAI, takich jak obrazy, osadzania, mowa i realtime.

• Modele agentów - modele openai/* przez środowisko uruchomieniowe Codex; zaloguj się przy użyciu uwierzytelniania Codex do korzystania z subskrypcji ChatGPT/Codex albo skonfiguruj zgodny z Codex zapasowy profil klucza API OpenAI, gdy celowo chcesz używać uwierzytelniania kluczem API.
• Nieagentowe API OpenAI - bezpośredni dostęp do OpenAI Platform z rozliczaniem na podstawie użycia przez OPENAI_API_KEY albo wdrożenie klucza API OpenAI.
• Konfiguracja legacy - starsze odwołania do modeli Codex są naprawiane przez openclaw doctor --fix do openai/* oraz środowiska uruchomieniowego Codex.

OpenAI jawnie obsługuje użycie subskrypcyjnego OAuth w zewnętrznych narzędziach i przepływach pracy, takich jak OpenClaw.

Dostawca, model, środowisko uruchomieniowe i kanał to osobne warstwy. Jeśli te etykiety są mieszane, przeczytaj Środowiska uruchomieniowe agentów przed zmianą konfiguracji.

Szybki wybór

Mapa nazw

Nazwy są podobne, ale nie są zamienne:

Oznacza to, że konfiguracja może celowo zawierać odwołania do modeli openai/*, podczas gdy profile uwierzytelniania wskazują na dane uwierzytelniające klucza API albo OAuth ChatGPT/Codex. Użyj auth.order.openai do konfiguracji; openclaw doctor --fix przepisuje starsze starsze odwołania do modeli Codex, starsze identyfikatory profili uwierzytelniania Codex i starszą kolejność uwierzytelniania Codex na kanoniczną trasę OpenAI.

Ograniczona wersja zapoznawcza GPT-5.6

OpenClaw rozpoznaje trzy publiczne identyfikatory modeli GPT-5.6:

• openai/gpt-5.6-sol
• openai/gpt-5.6-terra
• openai/gpt-5.6-luna

Wszystkie trzy udostępniają rozumowanie max w bieżącym katalogu serwera aplikacji Codex. Komunikat OpenAI o premierze opisuje Sol jako poziom flagowy, Terra jako poziom zrównoważony, a Luna jako szybki poziom o niższym koszcie. Zobacz komunikat o premierze GPT-5.6 i przewodnik dostępu do wersji zapoznawczej.

Dostęp jest przyznawany z listy dozwolonych podczas wersji zapoznawczej i może być nadany osobno dla API oraz Codex. Sam płatny plan ChatGPT nie daje dostępu. OpenClaw zachowuje openai/gpt-5.5 jako domyślne; wybranie odwołania GPT-5.6 bez dostępu zwraca błąd dostępu z upstreamu zamiast cicho przełączać się na alternatywę.

Zakres funkcji OpenClaw

Osadzania pamięci

OpenClaw może używać OpenAI albo zgodnego z OpenAI punktu końcowego osadzania do indeksowania memory_search i osadzań zapytań:

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

Dla zgodnych z OpenAI punktów końcowych, które wymagają asymetrycznych etykiet osadzania, ustaw queryInputType i documentInputType pod memorySearch. OpenClaw przekazuje je jako specyficzne dla dostawcy pola żądania input_type: osadzania zapytań używają queryInputType; zaindeksowane fragmenty pamięci i indeksowanie wsadowe używają documentInputType. Zobacz odwołanie konfiguracji pamięci, aby poznać pełny przykład.

Pierwsze kroki

Wybierz preferowaną metodę uwierzytelniania i wykonaj kroki konfiguracji.

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.5" } } },}

{  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.5

openclaw models list --provider openai

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

{  plugins: { entries: { codex: { enabled: true } } },  agents: {    defaults: {      model: { primary: "openai/gpt-5.5" },    },  },  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 }],      },    },  },}

Natywne uwierzytelnianie app-server Codex

Natywny mechanizm app-server Codex używa odwołań do modeli openai/* oraz pominiętej konfiguracji środowiska wykonawczego lub provider/model agentRuntime.id: "codex", ale jego uwierzytelnianie nadal opiera się na koncie. OpenClaw wybiera uwierzytelnianie w tej kolejności:

1. Uporządkowane profile uwierzytelniania OpenAI dla agenta, najlepiej pod auth.order.openai. Uruchom openclaw doctor --fix, aby zmigrować starsze identyfikatory profili uwierzytelniania starszego typu Codex i starszą kolejność uwierzytelniania Codex.
2. Istniejące konto app-server, takie jak lokalne logowanie ChatGPT w Codex CLI.
3. Tylko dla lokalnych uruchomień app-server stdio: CODEX_API_KEY, a następnie OPENAI_API_KEY, gdy app-server nie zgłasza konta i nadal wymaga uwierzytelniania OpenAI.

Oznacza to, że lokalne logowanie subskrypcji ChatGPT/Codex nie jest zastępowane tylko dlatego, że proces Gateway ma również OPENAI_API_KEY dla bezpośrednich modeli OpenAI lub osadzeń. Awaryjny klucz API ze zmiennej środowiskowej to tylko lokalna ścieżka stdio bez konta; nie jest wysyłany do połączeń WebSocket app-server. Gdy wybrany jest profil Codex w stylu subskrypcji, OpenClaw także nie przekazuje CODEX_API_KEY ani OPENAI_API_KEY do uruchomionego procesu podrzędnego stdio app-server i wysyła wybrane poświadczenia przez RPC logowania app-server. Gdy ten profil subskrypcji jest blokowany przez limit użycia Codex, OpenClaw może przełączyć się na następny uporządkowany profil klucza API openai:* bez zmiany wybranego modelu ani opuszczania mechanizmu Codex. Po upływie czasu resetu subskrypcji profil subskrypcji znów się kwalifikuje.

Generowanie obrazów

Dołączony Plugin openai rejestruje generowanie obrazów przez narzędzie image_generate. Obsługuje zarówno generowanie obrazów za pomocą klucza API OpenAI, jak i generowanie obrazów przez OAuth Codex za pomocą tego samego odwołania do modelu openai/gpt-image-2.

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

gpt-image-2 jest domyślny zarówno dla generowania obrazów z tekstu OpenAI, jak i edycji obrazów. gpt-image-1.5, gpt-image-1 i gpt-image-1-mini pozostają dostępne jako jawne nadpisania modelu. Użyj openai/gpt-image-1.5 dla wyjścia PNG/WebP z przezroczystym tłem; bieżące API gpt-image-2 odrzuca background: "transparent".

W przypadku żądania z przezroczystym tłem agenci powinni wywołać image_generate z model: "openai/gpt-image-1.5", outputFormat: "png" lub "webp" oraz background: "transparent"; starsza opcja dostawcy openai.background jest nadal akceptowana. OpenClaw chroni też publiczne ścieżki OpenAI i OpenAI Codex OAuth, przepisując domyślne przezroczyste żądania openai/gpt-image-2 na gpt-image-1.5; Azure i niestandardowe punkty końcowe zgodne z OpenAI zachowują skonfigurowane nazwy wdrożeń/modeli.

To samo ustawienie jest dostępne dla bezgłowych uruchomień 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

Użyj tych samych flag --output-format i --background z openclaw infer image edit, gdy zaczynasz od pliku wejściowego. --openai-background pozostaje dostępne jako alias specyficzny dla OpenAI. Użyj --quality low|medium|high|auto, gdy musisz kontrolować jakość i koszt OpenAI Images. Użyj --openai-moderation low|auto, aby przekazać specyficzną dla dostawcy wskazówkę moderacji OpenAI z image generate albo image edit.

W przypadku instalacji ChatGPT/Codex OAuth zachowaj to samo odwołanie openai/gpt-image-2. Gdy skonfigurowany jest profil OAuth openai, OpenClaw rozwiązuje zapisany token dostępu OAuth i wysyła żądania obrazów przez backend Codex Responses. Nie próbuje najpierw OPENAI_API_KEY ani po cichu nie wraca do klucza API dla tego żądania. Skonfiguruj models.providers.openai jawnie z kluczem API, niestandardowym bazowym URL-em albo punktem końcowym Azure, gdy chcesz zamiast tego użyć bezpośredniej ścieżki OpenAI Images API. Jeśli ten niestandardowy punkt końcowy obrazów znajduje się w zaufanej sieci LAN/adresacji prywatnej, ustaw też browser.ssrfPolicy.dangerouslyAllowPrivateNetwork: true; OpenClaw utrzymuje prywatne/wewnętrzne punkty końcowe obrazów zgodne z OpenAI zablokowane, chyba że ta zgoda jest obecna.

Generowanie:

/tool image_generate model=openai/gpt-image-2 prompt="A polished launch poster for OpenClaw on macOS" size=3840x2160 count=1

Wygeneruj przezroczysty PNG:

/tool image_generate model=openai/gpt-image-1.5 prompt="A simple red circle sticker on a transparent background" outputFormat=png background=transparent

Edycja:

/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

Generowanie wideo

Dołączony Plugin openai rejestruje generowanie wideo przez narzędzie video_generate.

Żądania OpenAI obraz-na-wideo używają POST /v1/videos z obrazem input_reference. Edycje pojedynczego wideo używają POST /v1/videos/edits z przesłanym wideo w polu video.

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

Wkład do promptu GPT-5

OpenClaw dodaje wspólny wkład do promptu GPT-5 dla uruchomień z rodziny GPT-5 na powierzchniach promptów składanych przez OpenClaw. Ma zastosowanie według identyfikatora modelu, więc ścieżki OpenClaw/dostawcy, takie jak starsze odwołania sprzed naprawy (starsze odwołanie Codex GPT-5.5), openrouter/openai/gpt-5.5, opencode/gpt-5.5 i inne zgodne odwołania GPT-5 otrzymują tę samą nakładkę. Starsze modele GPT-4.x jej nie otrzymują.

Dołączony natywny harness Codex nie otrzymuje tej nakładki OpenClaw GPT-5 przez instrukcje deweloperskie serwera aplikacji Codex. Natywny Codex zachowuje bazę, model i zachowanie dokumentów projektu należące do Codex, a OpenClaw wyłącza wbudowaną osobowość Codex dla natywnych wątków, aby pliki osobowości obszaru roboczego agenta pozostały nadrzędne. OpenClaw wnosi tylko kontekst środowiska uruchomieniowego, taki jak dostarczanie kanałem, dynamiczne narzędzia OpenClaw, delegowanie ACP, kontekst obszaru roboczego i OpenClaw Skills.

Wkład GPT-5 dodaje otagowany kontrakt zachowania dotyczący trwałości persony, bezpieczeństwa wykonywania, dyscypliny narzędzi, kształtu wyjścia, kontroli ukończenia i weryfikacji na pasujących promptach składanych przez OpenClaw. Zachowanie odpowiedzi specyficzne dla kanału i wiadomości cichych pozostaje we wspólnym prompcie systemowym OpenClaw i zasadach dostarczania wychodzącego. Warstwa przyjaznego stylu interakcji jest osobna i konfigurowalna.

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

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

Głos i mowa

{  messages: {    tts: {      providers: {        openai: { model: "gpt-4o-mini-tts", speakerVoice: "coral" },      },    },  },}

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

Punkty końcowe Azure OpenAI

Dołączony provider openai może kierować generowanie obrazów do zasobu Azure OpenAI przez nadpisanie bazowego adresu URL. Na ścieżce generowania obrazów OpenClaw wykrywa nazwy hostów Azure w models.providers.openai.baseUrl i automatycznie przełącza się na kształt żądania Azure.

Użyj Azure OpenAI, gdy:

• Masz już subskrypcję Azure OpenAI, limit lub umowę enterprise
• Potrzebujesz regionalnej rezydencji danych albo kontroli zgodności zapewnianych przez Azure
• Chcesz utrzymać ruch w istniejącej dzierżawie Azure

Konfiguracja

Aby generować obrazy w Azure przez dołączonego providera openai, wskaż models.providers.openai.baseUrl na swój zasób Azure i ustaw apiKey na klucz Azure OpenAI (nie klucz OpenAI Platform):

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

OpenClaw rozpoznaje te sufiksy hostów Azure dla trasy generowania obrazów Azure:

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

Dla żądań generowania obrazów na rozpoznanym hoście Azure OpenClaw:

• Wysyła nagłówek api-key zamiast Authorization: Bearer
• Używa ścieżek o zakresie wdrożenia (/openai/deployments/{deployment}/...)
• Dołącza ?api-version=... do każdego żądania
• Używa domyślnego limitu czasu żądania 600 s dla wywołań generowania obrazów Azure. Wartości timeoutMs dla pojedynczego wywołania nadal nadpisują tę wartość domyślną.

Inne bazowe adresy URL (publiczne OpenAI, proxy zgodne z OpenAI) zachowują standardowy kształt żądania obrazu OpenAI.

Wersja API

Ustaw AZURE_OPENAI_API_VERSION, aby przypiąć konkretną wersję zapoznawczą Azure lub GA dla ścieżki generowania obrazów Azure:

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

Wartość domyślna to 2024-12-01-preview, gdy zmienna nie jest ustawiona.

Nazwy modeli są nazwami wdrożeń

Azure OpenAI wiąże modele z wdrożeniami. Dla żądań generowania obrazów Azure kierowanych przez dołączonego providera openai pole model w OpenClaw musi być nazwą wdrożenia Azure skonfigurowaną w portalu Azure, a nie publicznym identyfikatorem modelu OpenAI.

Jeśli utworzysz wdrożenie o nazwie gpt-image-2-prod, które obsługuje gpt-image-2:

/tool image_generate model=openai/gpt-image-2-prod prompt="A clean poster" size=1024x1024 count=1

Ta sama reguła nazwy wdrożenia dotyczy wywołań generowania obrazów kierowanych przez dołączonego providera openai.

Dostępność regionalna

Generowanie obrazów Azure jest obecnie dostępne tylko w części regionów (na przykład eastus2, swedencentral, polandcentral, westus3, uaenorth). Przed utworzeniem wdrożenia sprawdź aktualną listę regionów Microsoftu i potwierdź, że konkretny model jest oferowany w Twoim regionie.

Różnice parametrów

Azure OpenAI i publiczne OpenAI nie zawsze akceptują te same parametry obrazów. Azure może odrzucać opcje, na które publiczne OpenAI pozwala (na przykład określone wartości background w gpt-image-2), albo udostępniać je tylko w określonych wersjach modelu. Te różnice pochodzą z Azure i bazowego modelu, a nie z OpenClaw. Jeśli żądanie Azure kończy się błędem walidacji, sprawdź zestaw parametrów obsługiwany przez konkretne wdrożenie i wersję API w portalu Azure.

Konfiguracja zaawansowana

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

Powiązane