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 flagowygpt-5.4-pro— wersja z rozszerzonym rozumowaniem
Przez Codex OAuth (openai-codex/*)
gpt-5.4— z natywnym oknem kontekstowym 1 050 000 tokenowgpt-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
responsesServerCompactioniresponsesCompactThreshold