// dokumentacja openclaw

OpenAI w OpenClaw — konfiguracja GPT-5.4 i integracja

Metody uwierzytelniania

OpenClaw obsluguje dwie metody uwierzytelniania z OpenAI, w zaleznosci od posiadanej subskrypcji i potrzeb:

Opcja A: Klucz API (bezposredni dostep)

Najczestszy sposob — uzywasz kluczy API z panelu OpenAI Platform. Trasy modeli to openai/*.

  • Wymaga zmiennej srodowiskowej OPENAI_API_KEY
  • Rozliczenie na podstawie zuzycia (pay-as-you-go)
  • Konfiguracja: openclaw onboard --openai-api-key "$OPENAI_API_KEY"

Opcja B: Subskrypcja ChatGPT/Codex (OAuth)

Jesli posiadasz subskrypcje ChatGPT Plus/Pro lub Codex, mozesz uzyc logowania OAuth. Trasy modeli to openai-codex/*.

  • Konfiguracja: openclaw onboard --auth-choice openai-codex
  • Zarzadzanie poswiadczeniami przez wbudowany magazyn Codex CLI
  • Wymagane dla Codex Cloud

Obslugiwane modele

OpenClaw natywnie obsluguje nastepujace modele OpenAI:

Przez API (openai/*)

  • gpt-5.4 — najnowszy model flagowy
  • gpt-5.4-pro — wersja z rozszerzonym rozumowaniem

Przez Codex OAuth (openai-codex/*)

  • gpt-5.4 — z natywnym oknem kontekstowym 1 050 000 tokenow
  • gpt-5.3-codex-spark — dostepny w zaleznosci od uprawnien subskrypcji

Domyslna konfiguracja

Przyklad kompletnej konfiguracji z modelem OpenAI jako domyslnym:

{
  plugins: {
    entries: {
      openai: {
        config: { personality: "friendly" }
      }
    }
  },
  agents: {
    defaults: {
      model: { primary: "openai/gpt-5.4" }
    }
  }
}

Parametr personality wlacza nakladke "przyjaznej" osobowosci (domyslne zachowanie). Ustaw personality: "off", aby uzyc bazowych promptow bez modyfikacji.

Konfiguracja okna kontekstowego

Dla modeli Codex mozesz nadpisac domyslny limit 272 000 tokenow:

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

Wazne rozroznienie: contextWindow to natywna pojemnosc modelu (metadane), natomiast contextTokens to budzet uzycia w trakcie sesji.

Opcje transportu (streaming)

OpenClaw obsluguje rozne metody przesylania strumieniowego odpowiedzi:

  • "auto" — najpierw WebSocket, potem SSE jako fallback (domyslne)
  • "websocket" — wymuszenie WebSocket
  • "sse" — wymuszenie Server-Sent Events

Przetwarzanie priorytetowe

Ustaw parametr serviceTier, aby kontrolowac priorytet przetwarzania zapytan:

  • "priority" — najwyzszy priorytet (wyzsza cena)
  • "default" — standardowy priorytet
  • "flex" — elastyczny (nizsza cena, potencjalnie dlusze oczekiwanie)
  • "auto" — automatyczny dobor priorytetu

Szybki tryb mozesz rowniez aktywowac komenda /fast on w czacie.

Rozgrzewka WebSocket

Domyslnie dla tras openai/* wlaczona jest rozgrzewka WebSocket, ktora zmniejsza opoznienie pierwszej tury konwersacji. Mozesz ja wylaczyc ustawiajac openaiWsWarmup: false.

Generowanie obrazow i wideo

OpenAI w OpenClaw obsluguje rowniez multimedia:

  • Obrazy — domyslny model openai/gpt-image-1. Obsluguje do 4 obrazow na zapytanie z trybem edycji.
  • Wideo — domyslny model openai/sora-2. Obsluguje tryb text-to-video i image-to-video.

Kompaktowanie po stronie serwera (Responses API)

Modele korzystajace z Responses API automatycznie wlaczaja kompaktowanie:

  • Domyslnie wymusza store: true
  • Prog kompaktowania: 70% okna kontekstowego
  • Mozliwosc dostosowania przez parametry responsesServerCompaction i responsesCompactThreshold