Skip to content

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.

Start the wizard

openclaw onboard

Use these values:

  • Provider type: Custom Provider
  • Compatibility: OpenAI-compatible
  • Base URL: https://codex.miaomiaocode.com/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:

text
codex_proxy/gpt-5-codex-mini

Manual config

{
  "models": {
    "providers": {
      "codex_proxy": {
        "baseUrl": "https://codex.miaomiaocode.com/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

bash
openclaw models list
openclaw models status

OpenAI-compatible gateway integration docs