OpenClaw

Recommended: use cc-switch for setup: https://github.com/farion1231/cc-switch/releases

If you do not use cc-switch, OpenClaw's official path is openclaw onboard with Custom Provider.

Prerequisites

Per the official OpenClaw install docs, the CLI requirements are:

• Node.js 22+
• macOS, Linux, or Windows
• pnpm only if you build from source

If you use the official installer script, it can detect and install a missing Node.js runtime for you.

If you prefer the manual npm or pnpm path, install Node.js first from: https://nodejs.org/en/download

• macOS / Windows: install the LTS release from that page, using a version supported by OpenClaw
• Linux: use the distro-specific method listed there

On macOS, if you already use Homebrew, you can also run:

brew install node

This installs both Node.js and npm.

Then verify:

node -v
npm -v

For Windows CLI usage, the official docs recommend WSL2.

Install

Official install page: https://docs.openclaw.ai/install/index

Recommended installer script:

curl -fsSL https://openclaw.ai/install.sh | bash

On Windows PowerShell, the official docs provide:

iwr -useb https://openclaw.ai/install.ps1 | iex

The official docs also include npm and pnpm install paths if you already manage Node yourself.

Start the wizard

openclaw onboard

Use these values:

• Provider type: Custom Provider
• Compatibility: OpenAI-compatible
• Base URL: https://enjoy.aigemini.org/v1
• API key: your codex_... key
• Model ID: gpt-5-codex-mini
• Endpoint ID: codex_proxy

You can enter the API key directly here. OPENAI_API_KEY is not required.

Set the default model to:

codex_proxy/gpt-5-codex-mini

Manual config

{
  "models": {
    "providers": {
      "codex_proxy": {
        "baseUrl": "https://enjoy.aigemini.org/v1",
        "apiKey": "codex_your_api_key",
        "api": "openai-completions",
        "models": [
          { "id": "gpt-5-codex-mini", "name": "gpt-5-codex-mini" }
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": { "primary": "codex_proxy/gpt-5-codex-mini" }
    }
  }
}

This config can store the API key directly. Use an environment-variable SecretRef only if you prefer that storage mode.

Verify

openclaw models list
openclaw models status