Docs
Model Providers
OpenAI

OpenAI

Scope

Use this page when:

  • You want to use OpenAI models in Moltbot
  • You want Codex subscription auth instead of API keys

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, while the Codex CLI supports either sign-in method. The Codex CLI caches login details in ~/.codex/auth.json (or your OS credential store), which Moltbot 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 

moltbot onboard --auth-choice openai-api-key
# or non-interactive
moltbot 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.

Moltbot can reuse your Codex CLI login (~/.codex/auth.json) or run the OAuth flow.

CLI setup 

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

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

Config snippet 

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

Notes

OllamaOpenCode Zen