Skip to main content

OpenAI

WednesdayAI supports OpenAI’s GPT and Codex model families. Authenticate with an API key, or with OAuth for Codex subscribers.

API key

Create a key at platform.openai.com and onboard:
Or set the key on the gateway host:
Rotation variables (OPENAI_API_KEYS, OPENAI_API_KEY_1, OPENAI_API_KEY_2, and the single-override OPENCLAW_LIVE_OPENAI_KEY) are also honoured — see Authentication.

Codex subscription (OAuth)

OpenAI Codex OAuth is explicitly supported for external tools like WednesdayAI:
This opens a browser for the OAuth flow and stores the token in the auth profile store.

Selecting a model

The Codex subscription provider uses the openai-codex/ prefix, e.g. openai-codex/gpt-5.3-codex. Run openclaw models list --all to see the full catalog, or openclaw models status for what your auth can reach.

Transport

The default transport is auto (WebSocket-first, with SSE fallback). Override per model:
The OpenAI Responses WebSocket warm-up defaults to on via params.openaiWsWarmup. Override it explicitly per model:

Responses API compaction

WednesdayAI auto-enables OpenAI Responses API server-side compaction to manage long-running context windows. When context usage reaches the threshold, the server compacts prior turns before sending the next request.
Set responsesServerCompaction: false to disable, or adjust responsesCompactThreshold (0–1) to control when compaction triggers.

Troubleshooting

The API key is invalid or revoked. Generate a new one and re-run onboarding, or update ~/.openclaw/.env.
You hit your tier limits. Add rotation keys via OPENAI_API_KEYS or upgrade your plan.
Re-run openclaw models auth login --provider openai-codex.
Some models require specific access tiers. Check your access at platform.openai.com/limits.