OpenAI

OpenAI udostępnia API deweloperskie dla modeli GPT, a Codex jest także dostępny jako agent programistyczny w planie ChatGPT przez klientów Codex firmy OpenAI. OpenClaw utrzymuje te powierzchnie oddzielnie, aby konfiguracja pozostała przewidywalna.

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

• Modele agentów - modele openai/* przez środowisko wykonawcze Codex; zaloguj się za pomocą uwierzytelniania openai-codex, aby używać subskrypcji ChatGPT/Codex, albo skonfiguruj profil klucza API openai-codex, gdy celowo chcesz używać uwierzytelniania kluczem API.
• Nieagentowe API OpenAI - bezpośredni dostęp do OpenAI Platform z rozliczaniem według użycia przez OPENAI_API_KEY lub konfigurację klucza API OpenAI.
• Starsza konfiguracja - odwołania do modeli openai-codex/* są naprawiane przez openclaw doctor --fix do openai/* oraz środowiska wykonawczego Codex.

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

Dostawca, model, środowisko wykonawcze i kanał to osobne warstwy. Jeśli te etykiety zaczynają się mieszać, przeczytaj Środowiska wykonawcze agentów przed zmianą konfiguracji.

# Szybki wybór

# Mapa nazewnictwa

Nazwy są podobne, ale nie są wymienne:

Oznacza to, że konfiguracja może celowo zawierać zarówno odwołania do modeli openai/*, jak i profile uwierzytelniania openai-codex. openclaw doctor --fix przepisuje starsze odwołania do modeli openai-codex/* na kanoniczną trasę modeli OpenAI.

# Pokrycie funkcji OpenClaw

# Osadzenia pamięci

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

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

Dla punktów końcowych zgodnych z OpenAI, które wymagają asymetrycznych etykiet osadzeń, ustaw queryInputType i documentInputType w memorySearch. OpenClaw przekazuje je jako pola żądania input_type specyficzne dla dostawcy: osadzenia zapytań używają queryInputType; zaindeksowane fragmenty pamięci i indeksowanie wsadowe używają documentInputType. Pełny przykład znajdziesz w referencji konfiguracji pamięci.

# 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: "sk-..." },
  agents: { defaults: { model: { primary: "openai/gpt-5.5" } } },
}

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

openclaw onboard --auth-choice openai-codex

openclaw models auth login --provider openai-codex

openclaw models auth login --provider openai-codex --device-code

openclaw config set agents.defaults.model.primary openai/gpt-5.5

openclaw models list --provider openai-codex

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

openclaw models status
openclaw models auth list --provider openai-codex
openclaw config get agents.defaults.model --json
openclaw config get agents.defaults.agentRuntime --json

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

openclaw doctor --fix
openclaw config validate

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

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

# Uwierzytelnianie natywnego serwera aplikacji Codex

Natywny harness serwera aplikacji Codex używa odwołań do modeli openai/* oraz pominiętej konfiguracji środowiska uruchomieniowego albo agentRuntime.id: "codex", ale jego uwierzytelnianie nadal jest oparte na koncie. OpenClaw wybiera uwierzytelnianie w tej kolejności:

1. Jawny profil uwierzytelniania OpenClaw openai-codex powiązany z agentem.
2. Istniejące konto serwera aplikacji, takie jak lokalne logowanie Codex CLI ChatGPT.
3. Tylko dla lokalnych uruchomień serwera aplikacji stdio: CODEX_API_KEY, potem OPENAI_API_KEY, gdy serwer aplikacji zgłasza brak konta i nadal wymaga uwierzytelniania OpenAI.

Oznacza to, że lokalne logowanie subskrypcji ChatGPT/Codex nie zostaje zastąpione tylko dlatego, że proces Gateway ma również OPENAI_API_KEY dla bezpośrednich modeli OpenAI lub embeddings. Awaryjne użycie klucza API z env dotyczy tylko lokalnej ścieżki stdio bez konta; nie jest wysyłane do połączeń serwera aplikacji WebSocket. Gdy wybrany jest profil Codex w stylu subskrypcji, OpenClaw również nie przekazuje CODEX_API_KEY ani OPENAI_API_KEY do uruchamianego procesu potomnego serwera aplikacji stdio i wysyła wybrane poświadczenia przez RPC logowania serwera aplikacji.

# Generowanie obrazów

Dołączony plugin openai rejestruje generowanie obrazów przez narzędzie image_generate. Obsługuje zarówno generowanie obrazów z kluczem API OpenAI, jak i generowanie obrazów OAuth Codex przez to samo odwołanie do modelu openai/gpt-image-2.

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

gpt-image-2 jest domyślny zarówno dla generowania tekst-na-obraz OpenAI, jak i edycji obrazów. gpt-image-1.5, gpt-image-1 i gpt-image-1-mini pozostają użyteczne 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 przezroczystego tła 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 również publiczne trasy OpenAI i OpenAI Codex OAuth, przepisując domyślne żądania przezroczystości openai/gpt-image-2 na gpt-image-1.5; Azure i niestandardowe punkty końcowe kompatybilne z OpenAI zachowują swoje 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.

W przypadku instalacji OAuth Codex zachowaj to samo odwołanie openai/gpt-image-2. Gdy skonfigurowany jest profil OAuth openai-codex, 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 nie przełącza się po cichu na klucz API dla tego żądania. Skonfiguruj models.providers.openai jawnie z kluczem API, niestandardowym bazowym adresem URL albo punktem końcowym Azure, gdy chcesz użyć bezpośredniej trasy OpenAI Images API zamiast tego. Jeśli ten niestandardowy punkt końcowy obrazów znajduje się w zaufanej sieci LAN/prywatnym adresie, ustaw także browser.ssrfPolicy.dangerouslyAllowPrivateNetwork: true; OpenClaw blokuje prywatne/wewnętrzne punkty końcowe obrazów kompatybilne z OpenAI, 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

Generowanie przezroczystego 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.

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

# Wkład promptu GPT-5

OpenClaw dodaje wspólny wkład promptu GPT-5 dla uruchomień rodziny GPT-5 u różnych dostawców. Stosuje się on według identyfikatora modelu, więc openai/gpt-5.5, starsze odwołania sprzed naprawy, takie jak openai-codex/gpt-5.5, openrouter/openai/gpt-5.5, opencode/gpt-5.5 i inne kompatybilne odwołania GPT-5 otrzymują tę samą nakładkę. Starsze modele GPT-4.x nie.

Dołączony natywny harness Codex używa tego samego zachowania GPT-5 i nakładki Heartbeat przez instrukcje deweloperskie serwera aplikacji Codex, więc sesje openai/gpt-5.x wymuszone przez agentRuntime.id: "codex" zachowują te same wytyczne dotyczące doprowadzania zadań do końca i proaktywnego Heartbeat, mimo że Codex jest właścicielem pozostałej części promptu harness.

Wkład GPT-5 dodaje oznaczony kontrakt zachowania dla trwałości persony, bezpieczeństwa wykonania, dyscypliny narzędzi, kształtu danych wyjściowych, kontroli ukończenia i weryfikacji. Zachowanie odpowiedzi specyficzne dla kanału oraz zachowanie wiadomości cichych pozostaje we współdzielonym monicie systemowym OpenClaw i zasadach dostarczania wychodzącego. Wytyczne GPT-5 są zawsze włączone dla pasujących modeli. Przyjazna warstwa 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", voice: "coral" },
      },
    },
  },
}

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

# Punkty końcowe Azure OpenAI

Dołączony dostawca openai może kierować generowanie obrazów do zasobu Azure OpenAI przez nadpisanie bazowego 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żywaj Azure OpenAI, gdy:

• Masz już subskrypcję, limit lub umowę enterprise Azure OpenAI
• Potrzebujesz regionalnego miejsca przechowywania danych lub kontroli zgodności zapewnianych przez Azure
• Chcesz utrzymać ruch w istniejącym tenancie Azure

# Konfiguracja

Dla generowania obrazów Azure przez dołączonego dostawcę openai skieruj 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 ograniczonych do 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 danego wywołania nadal nadpisują tę wartość domyślną.

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

# Wersja API

Ustaw AZURE_OPENAI_API_VERSION, aby przypiąć konkretną wersję preview lub GA Azure 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 trasowanych przez dołączonego dostawcę 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 trasowanych przez dołączonego dostawcę openai.

# Dostępność regionalna

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

# Różnice parametrów

Azure OpenAI i publiczny OpenAI nie zawsze akceptują te same parametry obrazów. Azure może odrzucać opcje, które publiczny OpenAI dopuszcza (na przykład niektóre wartości background w gpt-image-2) albo udostępniać je tylko w konkretnych wersjach modelu. Te różnice pochodzą z Azure i modelu bazowego, nie z OpenClaw. Jeśli żądanie Azure nie powiedzie się z 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" },
        },
      },
    },
  },
}

// Disable warm-up
{
  agents: {
    defaults: {
      models: {
        "openai/gpt-5.5": {
          params: { openaiWsWarmup: false },
        },
      },
    },
  },
}

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

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

# Powiązane