OpenAI

OpenClaw używa jednego identyfikatora dostawcy, openai, zarówno do bezpośredniego uwierzytelniania kluczem API, jak i uwierzytelniania w ramach subskrypcji ChatGPT/Codex. openai/* jest kanoniczną trasą modelu. W przypadku tur osadzonego agenta, gdy zasady środowiska uruchomieniowego nie są ustawione lub mają wartość auto, fakty dotyczące trasy OpenAI decydują, czy OpenClaw może niejawnie wybrać dołączone środowisko uruchomieniowe serwera aplikacji Codex. Sam prefiks openai/* nie wybiera środowiska uruchomieniowego.

• Modele agenta — openai/* za pośrednictwem środowiska uruchomieniowego wybranego przez jawną konfigurację agentRuntime lub niejawne zasady tras OpenAI. Do korzystania z subskrypcji ChatGPT/Codex należy zalogować się za pomocą uwierzytelniania Codex albo skonfigurować profil uwierzytelniania kluczem API, gdy rozliczenia mają odbywać się na podstawie klucza.
• Interfejsy API OpenAI niezwiązane z agentem — bezpośredni dostęp do OpenAI Platform, rozliczany za użycie, za pośrednictwem OPENAI_API_KEY lub profilu uwierzytelniania kluczem API openai.
• Starsza konfiguracja — odwołania codex/* i openai-codex/* są naprawiane do postaci openai/* oraz agentRuntime.id: "codex" o zakresie ograniczonym do modelu przez openclaw doctor --fix.

OpenAI jawnie obsługuje korzystanie z OAuth w ramach subskrypcji w zewnętrznych narzędziach i przepływach pracy, takich jak OpenClaw.

Śledzenie użycia i kosztów

OpenClaw rozdziela limit subskrypcji od rozliczeń interfejsu API Platform:

• OAuth ChatGPT/Codex pokazuje plan subskrypcji, okresy limitów i saldo środków.
• OPENAI_ADMIN_KEY pokazuje w sekcji Użycie interfejsu Control UI 30 dni zgłoszonych przez dostawcę kosztów organizacji i użycia uzupełnień, w tym dzienne wydatki, łączne liczby żądań/tokenów, najczęściej używane modele i kategorie kosztów.
• OPENAI_PROJECT_ID opcjonalnie ogranicza historię interfejsu Admin API do jednego projektu.
• OpenClaw nigdy nie wysyła OPENAI_API_KEY ani profilu wnioskowania openai do interfejsów API organizacji; te dane uwierzytelniające mogą należeć do niestandardowych punktów końcowych, Azure lub punktów końcowych lokalnych dla agenta.

Jawny klucz administratora ma pierwszeństwo przed OAuth. Historia zgłaszana przez dostawcę nie jest łączona z szacowanym kosztem OpenClaw wyliczanym na podstawie sesji; może obejmować aktywność interfejsu API innych klientów i korekty rozliczeniowe po stronie dostawcy.

Dokumentacja OpenAI dotycząca panelu użycia interfejsu API opisuje wymagania dotyczące właściciela organizacji oraz jawnego uprawnienia do panelu użycia w celu uzyskania danych o użyciu.

Dostawca, model, środowisko uruchomieniowe i kanał są oddzielnymi warstwami. Jeśli te etykiety są ze sobą mylone, przed zmianą konfiguracji należy przeczytać dokument Środowiska uruchomieniowe agentów.

Szybki wybór

Mapa nazw

Niejawne środowisko uruchomieniowe agenta

Gdy zasady agentRuntime dostawcy/modelu nie są ustawione lub mają wartość auto, należące do dostawcy OpenAI zasady tras wybierają niejawne środowisko uruchomieniowe na podstawie efektywnego punktu końcowego i adaptera:

Jawna, niedomyślna wartość agentRuntime.id dostawcy/modelu pozostaje rozstrzygająca. Na przykład agentRuntime.id: "openclaw" pozostawia w OpenClaw trasę, która w przeciwnym razie kwalifikowałaby się do Codex, natomiast agentRuntime.id: "codex" wymaga Codex i kończy działanie błędem, gdy efektywna trasa nie jest zadeklarowana jako zgodna z Codex. Wybór środowiska uruchomieniowego nie zmienia typu danych uwierzytelniających ani sposobu rozliczania: uwierzytelnianie kluczem API Platform i uwierzytelnianie w ramach subskrypcji ChatGPT/Codex pozostają odrębne.

openclaw doctor --fix migruje starsze odwołania modeli codex/* i openai-codex/*, starsze identyfikatory profili uwierzytelniania Codex oraz starsze wpisy kolejności uwierzytelniania Codex do kanonicznej trasy openai. Zmigrowane odwołania modeli otrzymują agentRuntime.id: "codex" o zakresie ograniczonym do modelu; w nowej konfiguracji kolejności uwierzytelniania należy używać auth.order.openai.

Ograniczona wersja zapoznawcza GPT-5.6

OpenClaw rozpoznaje dokładne identyfikatory modeli openai/gpt-5.6-sol, openai/gpt-5.6-terra i openai/gpt-5.6-luna. Wszystkie trzy udostępniają poziomy rozumowania xhigh i max w bieżącym katalogu. OpenAI opisuje Sol jako flagową warstwę, Terra jako warstwę zrównoważoną, a Luna jako warstwę szybką i tańszą. Zobacz ogłoszenie wydania GPT-5.6 oraz przewodnik po dostępie.

Przy bezpośrednim uwierzytelnianiu OpenAI kluczem API sam identyfikator openai/gpt-5.6 jest aliasem Sol i domyślnym ustawieniem nowej konfiguracji. Natywny katalog Codex nie stosuje tego aliasu bezpośredniego API po stronie klienta; zależnie od dostępu obszaru roboczego może pokazywać dokładne identyfikatory Sol, Terra i Luna. Dlatego nowa konfiguracja OAuth ChatGPT/Codex używa openai/gpt-5.6-sol. Bieżące konto można sprawdzić za pomocą:

openclaw models list --provider openai

Dostęp organizacji API i obszaru roboczego Codex może się różnić. Jeśli GPT-5.6 nie jest dostępny, należy jawnie wybrać GPT-5.5:

openclaw models set openai/gpt-5.5

OpenClaw wyświetla błąd dostępu ze źródła nadrzędnego i nie zastępuje niejawnie wyboru GPT-5.6 modelem GPT-5.5.

Zakres obsługiwanych funkcji OpenClaw

Osadzenia pamięci

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

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

W przypadku punktów końcowych zgodnych z OpenAI, które wymagają asymetrycznych etykiet osadzeń, należy ustawić queryInputType i documentInputType w memorySearch. OpenClaw przekazuje je jako pola żądań input_type specyficzne dla dostawcy: osadzenia zapytań używają queryInputType; indeksowane fragmenty pamięci i indeksowanie wsadowe używają documentInputType. Pełny przykład zawiera dokumentacja konfiguracji pamięci.

Pierwsze kroki

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 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 }],      },    },  },}

Uwierzytelnianie natywnego serwera aplikacji Codex

Natywne środowisko serwera aplikacji Codex używa odwołań modeli openai/*, gdy kwalifikująca się dokładna oficjalna trasa HTTPS wybiera je niejawnie lub gdy agentRuntime.id: "codex" dostawcy/modelu wybiera je jawnie. Uwierzytelnianie nadal opiera się na koncie. OpenClaw wybiera uwierzytelnianie w następującej kolejności:

1. Uporządkowane profile uwierzytelniania OpenAI dla agenta, najlepiej w auth.order.openai. Należy uruchomić openclaw doctor --fix, aby zmigrować starsze identyfikatory profili uwierzytelniania Codex i kolejność uwierzytelniania.
2. Istniejące konto serwera aplikacji, takie jak lokalne logowanie ChatGPT w CLI Codex. W przypadku domyślnego izolowanego katalogu domowego agenta OpenClaw przekazuje to natywne konto CLI do serwera aplikacji za pośrednictwem jego RPC logowania; nie współdzieli konfiguracji, pluginów ani magazynu wątków CLI.
3. Tylko dla lokalnych uruchomień serwera aplikacji przez stdio i tylko wtedy, gdy serwer aplikacji nie zgłasza konta: CODEX_API_KEY, a następnie OPENAI_API_KEY.

Lokalne logowanie do subskrypcji ChatGPT/Codex nie jest zastępowane tylko dlatego, że proces Gateway ma również OPENAI_API_KEY dla bezpośrednich modeli OpenAI lub osadzania. Awaryjne użycie klucza API ze środowiska dotyczy wyłącznie lokalnej ścieżki stdio bez konta; nigdy nie jest wysyłane przez połączenia WebSocket z serwerem aplikacji. Gdy zostanie wybrany profil Codex typu subskrypcyjnego, OpenClaw nie przekazuje również CODEX_API_KEY ani OPENAI_API_KEY do uruchomionego procesu potomnego serwera aplikacji stdio i zamiast tego wysyła wybrane poświadczenia za pośrednictwem RPC logowania serwera aplikacji.

Gdy ten profil subskrypcji zostanie zablokowany przez limit użycia Codex, OpenClaw oznacza profil jako zablokowany do czasu resetowania podanego przez Codex i pozwala, aby kolejność uwierzytelniania przeszła do następnego profilu openai:*, bez zmiany wybranego modelu ani opuszczania środowiska Codex. Po upływie czasu resetowania profil subskrypcji ponownie staje się dostępny.

Generowanie obrazów

Dołączony plugin openai rejestruje generowanie obrazów za pośrednictwem narzędzia image_generate. Obsługuje generowanie obrazów zarówno z kluczem API OpenAI, jak i OAuth Codex za pomocą tego samego odwołania modelu openai/gpt-image-2.

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

gpt-image-2 jest wartością domyślną dla generowania obrazów z tekstu i edycji obrazów w OpenAI. gpt-image-1.5, gpt-image-1 i gpt-image-1-mini nadal mogą być używane jako jawne zastąpienia modelu. Należy użyć openai/gpt-image-1.5 do uzyskania wyjścia PNG/WebP z przezroczystym tłem; bieżące API gpt-image-2 odrzuca background: "transparent".

W przypadku żądania przezroczystego tła należy 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 również publiczne trasy OpenAI i OAuth OpenAI Codex, 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 bezobsługowych uruchomień CLI:

openclaw infer image generate \  --model openai/gpt-image-1.5 \  --output-format png \  --background transparent \  --prompt "Prosta naklejka z czerwonym kołem na przezroczystym tle" \  --json

Tych samych flag --output-format i --background należy użyć z openclaw infer image edit podczas rozpoczynania od pliku wejściowego. --openai-background pozostaje dostępne jako alias specyficzny dla OpenAI. Należy użyć --quality low|medium|high|auto, aby kontrolować jakość i koszt obrazów OpenAI. Należy użyć --openai-moderation low|auto, aby przekazać wskazówkę moderacji OpenAI z image generate lub image edit.

W instalacjach z OAuth ChatGPT/Codex należy zachować to samo odwołanie openai/gpt-image-2. Gdy skonfigurowany jest profil OAuth openai, OpenClaw odczytuje zapisany token dostępu OAuth i wysyła żądania obrazów przez zaplecze Codex Responses; nie próbuje najpierw użyć OPENAI_API_KEY ani po cichu przełączyć się awaryjnie na klucz API. Należy jawnie skonfigurować models.providers.openai z kluczem API, niestandardowym bazowym adresem URL lub punktem końcowym Azure, jeśli zamiast tego ma być używana bezpośrednia trasa API obrazów OpenAI. Jeśli ten niestandardowy punkt końcowy obrazów znajduje się pod zaufanym adresem sieci LAN/prywatnym, należy również ustawić browser.ssrfPolicy.dangerouslyAllowPrivateNetwork: true; OpenClaw blokuje prywatne/wewnętrzne punkty końcowe obrazów zgodne z OpenAI, jeśli ta zgoda nie jest obecna.

Generowanie:

/tool image_generate model=openai/gpt-image-2 prompt="Dopracowany plakat premierowy OpenClaw na macOS" size=3840x2160 count=1

Generowanie przezroczystego pliku PNG:

/tool image_generate model=openai/gpt-image-1.5 prompt="Prosta naklejka z czerwonym kołem na przezroczystym tle" outputFormat=png background=transparent

Edycja:

/tool image_generate model=openai/gpt-image-2 prompt="Zachowaj kształt obiektu, zmień materiał na półprzezroczyste szkło" image=/path/to/reference.png size=1024x1536

Generowanie filmów

Dołączony plugin openai rejestruje generowanie filmów za pośrednictwem narzędzia video_generate.

Żądania OpenAI dotyczące konwersji obrazu 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" },    },  },}

Uzupełnienie promptu GPT-5

OpenClaw dodaje wspólne uzupełnienie promptu GPT-5 dla modeli z rodziny GPT-5 u dostawcy openai (w tym starszych, niepoprawionych odwołań Codex, które są normalizowane do openai/*). Inni dostawcy, którzy również udostępniają identyfikatory modeli z rodziny GPT-5, tacy jak OpenRouter lub trasy opencode, nie otrzymują tej nakładki; jest ona uzależniona od identyfikatora dostawcy openai, a nie wyłącznie od identyfikatora modelu. Starsze modele GPT-4.x nigdy jej nie otrzymują.

Natywny mechanizm serwera aplikacji Codex nie otrzymuje kontraktu zachowania dotyczącego persony i dyscypliny korzystania z narzędzi ani przyjaznej nakładki stylu interakcji za pośrednictwem instrukcji deweloperskich; natywny Codex zachowuje należące do Codex zachowanie bazowe, modelu i dokumentacji projektu, a OpenClaw wyłącza wbudowaną osobowość Codex dla natywnych wątków, dzięki czemu pliki osobowości w obszarze roboczym agenta pozostają nadrzędne. OpenClaw przekazuje natywnym wątkom Codex wyłącznie kontekst środowiska uruchomieniowego: dostarczanie przez kanał, dynamiczne narzędzia OpenClaw, delegowanie ACP, kontekst obszaru roboczego i Skills OpenClaw. Tekst wskazówek dotyczących Heartbeat z tego samego uzupełnienia jest jedynym wyjątkiem: natywne tury Heartbeat Codex go otrzymują, wstrzykniętego jako dedykowane instrukcje współpracy, a nie za pośrednictwem wspólnego mechanizmu uzupełniania promptu.

Uzupełnienie GPT-5 dodaje oznaczony kontrakt zachowania dotyczący trwałości persony, bezpieczeństwa wykonywania, dyscypliny korzystania z narzędzi, formatu wyników, kontroli ukończenia i weryfikacji w pasujących promptach tworzonych przez OpenClaw. Zachowanie odpowiedzi specyficzne dla kanału i zachowanie cichych wiadomości pozostają we wspólnym prompcie systemowym OpenClaw oraz zasadach dostarczania wychodzącego. Warstwa przyjaznego stylu interakcji jest oddzielna 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 dostawca openai może korzystać z zasobu Azure OpenAI do generowania obrazów przez zastąpienie 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 format żądań Azure.

Azure OpenAI warto użyć, gdy:

• Istnieje już subskrypcja Azure OpenAI, limit lub umowa korporacyjna
• Wymagane są regionalne przechowywanie danych lub mechanizmy zgodności oferowane przez Azure
• Ruch ma pozostać w ramach istniejącej dzierżawy Azure

Konfiguracja

Aby generować obrazy w Azure za pośrednictwem dołączonego dostawcy openai, należy skierować models.providers.openai.baseUrl do zasobu Azure i ustawić apiKey na klucz Azure OpenAI (nie klucz platformy OpenAI):

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

OpenClaw rozpoznaje następujące sufiksy hostów Azure dla trasy generowania obrazów w Azure:

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

W przypadku żądań generowania obrazów kierowanych do rozpoznanego hosta Azure OpenClaw:

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

Inne bazowe adresy URL (publiczny OpenAI, serwery proxy zgodne z OpenAI) zachowują standardowy format żądań obrazów OpenAI.

Wersja API

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

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

Gdy zmienna nie jest ustawiona, wartością domyślną jest 2024-12-01-preview.

Nazwy modeli są nazwami wdrożeń

Azure OpenAI wiąże modele z wdrożeniami. W przypadku żądań generowania obrazów w Azure trasowanych przez dołączonego dostawcę openai pole model w OpenClaw musi zawierać nazwę wdrożenia Azure skonfigurowaną w portalu Azure, a nie identyfikator publicznego modelu OpenAI.

Jeśli zostanie utworzone wdrożenie o nazwie gpt-image-2-prod, które udostępnia gpt-image-2:

/tool image_generate model=openai/gpt-image-2-prod prompt="Czysty plakat" size=1024x1024 count=1

Ta sama zasada dotycząca nazwy wdrożenia ma zastosowanie do każdego wywołania generowania obrazów trasowanego przez dołączonego dostawcę openai.

Dostępność regionalna

Generowanie obrazów w Azure jest obecnie dostępne tylko w części regionów (na przykład eastus2, swedencentral, polandcentral, westus3, uaenorth). Przed utworzeniem wdrożenia należy sprawdzić aktualną listę regionów Microsoft i potwierdzić, że dany model jest oferowany w odpowiednim regionie.

Różnice w parametrach

Azure OpenAI i publiczny OpenAI nie zawsze akceptują te same parametry obrazów. Azure może odrzucać opcje dozwolone przez publiczny OpenAI (na przykład niektóre wartości background w gpt-image-2) lub udostępniać je tylko w określonych wersjach modelu. Różnice te wynikają z Azure i modelu bazowego, a nie z OpenClaw. Jeśli żądanie Azure zakończy się błędem walidacji, należy sprawdzić zestaw parametrów obsługiwany przez dane wdrożenie i wersję API w portalu Azure.

Konfiguracja zaawansowana

Poniższe przykłady params dla poszczególnych modeli kształtują osadzone żądanie dostawcy OpenClaw. Ich skonfigurowanie stanowi jawnie określone zachowanie żądania, dlatego kwalifikująca się trasa auto pozostaje w OpenClaw zamiast niejawnie wybierać Codex. Natywny mechanizm serwera aplikacji Codex zarządza własnym transportem i ustawieniami żądań; jawne agentRuntime.id: "codex" kończy działanie błędem, gdy wynikowa trasa nie jest zadeklarowana jako zgodna z Codex.

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

Powiązane materiały