mirror of
https://github.com/openclaw/openclaw.git
synced 2026-05-09 09:50:42 +00:00
docs: document codex harness model availability (#79582)
This commit is contained in:
@@ -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.
|
||||
|
||||
@@ -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
|
||||
|
||||
Reference in New Issue
Block a user