Skip to main content
OpenClaw uses one provider id, openai, for both direct API-key auth and ChatGPT/Codex subscription auth. openai/* is the canonical model route. For embedded agent turns with runtime policy unset or auto, OpenAI’s route facts decide whether OpenClaw may select the bundled Codex app-server runtime implicitly. The openai/* prefix alone does not select a runtime.
  • Agent models - openai/* through the runtime selected by explicit agentRuntime config or OpenAI’s implicit route policy. Sign in with Codex auth for ChatGPT/Codex subscription use, or configure an API-key auth profile when you want key-based billing.
  • Non-agent OpenAI APIs - direct OpenAI Platform access, billed per use, through OPENAI_API_KEY or an openai API-key auth profile.
  • Legacy config - codex/* and openai-codex/* refs are repaired to openai/* plus model-scoped agentRuntime.id: "codex" by openclaw doctor --fix.
OpenAI explicitly supports subscription OAuth usage in external tools and workflows like OpenClaw. This page is an index. OpenAI is documented on eight pages, one per reader job. Open the page that matches your task.

​
Where each section moved

Every anchor the single-page version published still resolves here, so an existing link such as /providers/openai#implicit-agent-runtime keeps working. Each entry points at the page that now holds the content. OpenAI setup OpenAI models OpenAI runtimes and Codex auth OpenAI coverage and cost OpenAI image and video generation OpenAI voice and speech Azure OpenAI endpoints OpenAI advanced configuration

Model selection

Choosing providers, model refs, and failover behavior.

Image generation

Shared image tool parameters and provider selection.

Video generation

Shared video tool parameters and provider selection.

OAuth and auth

Auth details and credential reuse rules.