Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.wednesdayai.dev/llms.txt

Use this file to discover all available pages before exploring further.

OpenAI

WednesdayAI supports the full OpenAI model family: GPT-4o, o3, o1, and the Codex coding models. Authentication is either an API key or, for Codex subscribers, an OAuth flow.

API key authentication

Obtain an API key from platform.openai.comAPI keys.
openclaw login
# choose: OpenAI
# enter your API key when prompted
Or set the environment variable:
export OPENAI_API_KEY=sk-proj-...
Lookup order:
SourceKey / path
Environment variableOPENAI_API_KEY
Stored credential~/.openclaw/credentials/openai

Codex subscription (OAuth)

If you have an active ChatGPT Plus or Team subscription, you can authenticate with your account directly — no API key needed.
openclaw models auth login --provider openai-codex
This opens a browser window for the OAuth flow. After approving, your token is stored in ~/.openclaw/credentials/openai-codex.
Codex models are only available to authenticated subscribers. Attempting to use a Codex model ID with a standard API key returns a 404.

Selecting a model

{
  agents: {
    defaults: {
      model: "gpt-4o",
    }
  }
}
Common model IDs:
ModelID
GPT-4ogpt-4o
GPT-4o minigpt-4o-mini
o3o3
o1o1
Codexcodex
Run openclaw status --providers to list every model available on your key or subscription.

Key rotation

Pass multiple keys as a comma-separated list to distribute load:
export OPENAI_API_KEY=sk-proj-new,sk-proj-old
The gateway load-balances across all keys and retries on 429 responses.

Troubleshooting

API key is invalid. Generate a new one at platform.openai.com and re-run openclaw login.
You have hit your tier rate limits. Add a second API key (see Key rotation) or upgrade your OpenAI plan.
Re-run openclaw models auth login --provider openai-codex to refresh the token.
Some models (o3, o1) require specific API access tiers. Check your access at platform.openai.com/limits.