How to use codex/gpt-5.5 in openclaw 2026.4.22? | Friends of the Crustacean 🦞🤝 | Page 1

bronze briar Apr 23, 2026, 9:45 PM

#

What config do I need to use codex/gpt-5.5? I already have codex oauth.

random edgeBOT Apr 23, 2026, 9:45 PM

#

novel leafBOT Apr 23, 2026, 9:45 PM

#

To help others find answers, you can mark your question as solved via Right click solution message -> Apps -> ✅ Mark Solution

random edgeBOT Apr 23, 2026, 9:45 PM

#

graceful sunBOT Apr 23, 2026, 9:47 PM

#

Let me verify the exact provider/model shape from the docs so I don't hand you a made-up config.

#

If you already have Codex OAuth, the important bit is this distinction:

openai-codex/... = Codex OAuth / ChatGPT sign-in
codex/... = bundled Codex app-server harness

So if you just want to use your existing Codex OAuth in OpenClaw, set:

openclaw config set agents.defaults.model.primary openai-codex/gpt-5.5

If you also use a model allowlist, add it there too:

openclaw config set agents.defaults.models '{"openai-codex/gpt-5.5":{}}' --strict-json --merge

#

Then verify the model is actually exposed to your account:

openclaw models list --provider openai-codex

If you specifically want the native Codex harness route, then use codex/gpt-5.5 instead, plus:

{
  agents: {
    defaults: {
      model: { primary: "codex/gpt-5.5" },
      embeddedHarness: { runtime: "codex", fallback: "none" },
    },
  },

#

So, short version: with existing Codex OAuth, you probably want openai-codex/gpt-5.5, not openai/gpt-5.5.

Docs:

If you want, paste your openclaw --version and current model section and I can sanity-check it.

bronze briar Apr 23, 2026, 9:50 PM

#

when I run openclaw models list --provider openai-codex, I get
Model Input Ctx Local Auth Tags
openai-codex/gpt-5.3-codex text+image 266k no yes default,configured,alias:codex-53
openai-codex/codex-latest - - - - configured,missing
openai-codex/gpt-5.5 - - - - configured,missing
openai-codex/gpt-5.4 text+image 1025k no yes configured,alias:codex-54
openai-codex/gpt-5.4-mini text+image 266k no yes configured,alias:codex-54-mini

graceful sunBOT Apr 23, 2026, 9:52 PM

#

That configured,missing bit is the clue. I'm checking what OpenClaw means by that tag so I can tell you whether this is config, entitlement, or version-related.

#

Yep, configured,missing is the key here.

It means OpenClaw sees openai-codex/gpt-5.5 in your config, but the openai-codex provider path cannot actually resolve it on your current build/runtime.

From the current docs/source, openai-codex is wired for the GPT-5.4 family, so on 2026.4.22 openai-codex/gpt-5.5 looks unsupported even if your Codex OAuth is valid.

So for the OAuth route, use:

openclaw config set agents.defaults.model.primary openai-codex/gpt-5.4

If you specifically want gpt-5.5, the better route is the native Codex harness (codex/*), not openai-codex/*:

#

  plugins: {
    entries: {
      codex: { enabled: true }
    }
  },
  agents: {
    defaults: {
      model: { primary: "codex/gpt-5.5" },
      embeddedHarness: { runtime: "codex", fallback: "none" }
    }
  }
}

That path can use models returned by the Codex app server, including newer ones.

#How to use codex/gpt-5.5 in openclaw 2026.4.22?