From a7bfa44c3559c63b34a985f1bcec369bc4d43916 Mon Sep 17 00:00:00 2001 From: Kevin Lin Date: Fri, 8 May 2026 18:10:15 -0700 Subject: [PATCH] docs: document codex harness model availability (#79582) --- AGENTS.md | 1 + docs/plugins/codex-harness.md | 25 +++++++++++++++++++++++-- 2 files changed, 24 insertions(+), 2 deletions(-) diff --git a/AGENTS.md b/AGENTS.md index 999aff02a5e..a9372f400a0 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -157,6 +157,7 @@ Telegraph style. Root rules only. Read scoped `AGENTS.md` before subtree work. ## Docs / Changelog - Docs change with behavior/API. Use docs list/read_when hints; docs links per `docs/AGENTS.md`. +- When upgrading the bundled Codex harness (`@openai/codex` in `extensions/codex/package.json`), refresh the model availability snapshot in `docs/plugins/codex-harness.md` from the new harness's `model/list` result. - Docs final answers: when doc files changed, end with the relevant full `https://docs.openclaw.ai/...` URL(s). - Changelog user-facing only; fixing an issue or landing/merging a PR needs one unless pure test/internal. - Changelog placement: active version `### Changes`/`### Fixes`; contributor-facing added entries should include at least one `Thanks @author` attribution, using credited human GitHub username(s). Never add `Thanks @codex`, `Thanks @openclaw`, `Thanks @clawsweeper`, or `Thanks @steipete`; if the real credited human is unknown, leave attribution blank instead of guessing or adding a random person. diff --git a/docs/plugins/codex-harness.md b/docs/plugins/codex-harness.md index f96c6c458ee..808fb2c8980 100644 --- a/docs/plugins/codex-harness.md +++ b/docs/plugins/codex-harness.md @@ -396,13 +396,34 @@ and lets the next turn resolve the harness from current config again. ## Model discovery -By default, the Codex plugin asks the app-server for available models. If -discovery fails or times out, it uses a bundled fallback catalog for: +By default, the Codex plugin asks the app-server for available models. Model +availability is owned by the Codex app-server harness, so the list can change +when OpenClaw upgrades the bundled `@openai/codex` version or when a deployment +points `appServer.command` at a different Codex binary. Availability can also be +account-scoped. Use `/codex models` on a running gateway to see the live catalog +for that harness and account. + +If discovery fails or times out, OpenClaw uses a bundled fallback catalog for: - GPT-5.5 - GPT-5.4 mini - GPT-5.2 +The current bundled harness is `@openai/codex` `0.129.0`. A `model/list` probe +against that bundled app-server returned: + +| Model id | Default | Hidden | Input modalities | Reasoning efforts | +| ------------------- | ------- | ------ | ---------------- | ------------------------ | +| `gpt-5.5` | Yes | No | text, image | low, medium, high, xhigh | +| `gpt-5.4` | No | No | text, image | low, medium, high, xhigh | +| `gpt-5.4-mini` | No | No | text, image | low, medium, high, xhigh | +| `gpt-5.3-codex` | No | No | text, image | low, medium, high, xhigh | +| `gpt-5.2` | No | No | text, image | low, medium, high, xhigh | +| `codex-auto-review` | No | Yes | text, image | low, medium, high, xhigh | + +Hidden models are returned by the app-server catalog for internal or specialized +flows, but they are not normal model-picker choices. + You can tune discovery under `plugins.entries.codex.config.discovery`: ```json5