ClawdBotAI LogoClawdBotAI
HomeDocsProvidersOpenAI

OpenAI

Developer APIs for GPT models with API key or Codex subscription

Overview

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
  • Codex CLI supports either sign-in method

The Codex CLI caches login details in ~/.codex/auth.json (or your OS credential store), which Clawdbot can reuse.

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-4o"
      }
    }
  }
}

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. Clawdbot can reuse your Codex CLI login (~/.codex/auth.json) or run the OAuth flow.

CLI setup

# Reuse existing Codex CLI login
clawdbot onboard --auth-choice codex-cli

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

Config snippet

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

Notes

  • Model refs always use provider/model format (see Models).
  • Auth details + reuse rules are in OAuth.
AnthropicBedrock