openclaw/docs/providers/openai.md
Jon Shapiro 92697edb7c fix(venice): add compat settings to prevent HTTP 400 errors
Venice's API doesn't support certain OpenAI-compatible parameters that
Clawdbot sends by default:

- `store`: Venice returns HTTP 400 with no body when this is present
- `developer` role: Not supported by Venice's API

This adds VENICE_COMPAT settings (supportsStore: false,
supportsDeveloperRole: false) to all Venice model definitions, both
from the static catalog and dynamically discovered models.

Fixes issues reported in PR #1666 where users experienced silent
failures (HTTP 400, no body) when using Venice models.

Co-authored-by: jonisjongithub <jonisjongithub@users.noreply.github.com>
Co-authored-by: Clawdbot <bot@clawd.bot>
2026-01-26 17:56:01 -08:00

1.7 KiB

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, 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 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-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.

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-5.2" } } }
}

Notes