Files
clawdbot/docs/providers/openai.md
2026-01-26 19:05:00 +00:00

1.5 KiB

summary, read_when
summary read_when
Use OpenAI via API keys or Codex subscription in Clawdbot
You want to use OpenAI models in Clawdbot
You want Codex subscription auth instead of API keys

OpenAI

OpenAI provides developer APIs for GPT models. Codex supports ChatGPT sign-in for subscription access or API key sign-in for usage-based access. Codex cloud requires ChatGPT sign-in.

Option A: OpenAI API key (OpenAI Platform)

Best for: direct API access and usage-based billing. Get your API key from the OpenAI dashboard.

CLI setup

clawdbot onboard --auth-choice openai-api-key
# or non-interactive
clawdbot onboard --openai-api-key "$OPENAI_API_KEY"

Config snippet

{
  env: { OPENAI_API_KEY: "sk-..." },
  agents: { defaults: { model: { primary: "openai/gpt-5.2" } } }
}

Option B: OpenAI Code (Codex) subscription

Best for: using ChatGPT/Codex subscription access instead of an API key. Codex cloud requires ChatGPT sign-in, while the Codex CLI supports ChatGPT or API key sign-in.

CLI setup

# Run Codex OAuth in the wizard
clawdbot onboard --auth-choice openai-codex

# Or run OAuth directly
clawdbot models auth login --provider openai-codex

Config snippet

{
  agents: { defaults: { model: { primary: "openai-codex/gpt-5.2" } } }
}

Notes