Skip to content

Fix doctor repair for disabled Codex runtime plugin#82502

Merged
joshavant merged 4 commits into
mainfrom
fix/doctor-codex-plugin-runtime-82368
May 16, 2026
Merged

Fix doctor repair for disabled Codex runtime plugin#82502
joshavant merged 4 commits into
mainfrom
fix/doctor-codex-plugin-runtime-82368

Conversation

@joshavant

Copy link
Copy Markdown
Contributor

Summary

Fixes #82368 by teaching openclaw doctor --fix to repair configs where OpenAI/Codex-runtime agent routes require the Codex plugin but plugins.entries.codex or plugins.allow makes that harness unavailable.

The repair enables plugins.entries.codex and adds codex to an existing non-empty allowlist only when configured routes actually resolve to Codex runtime. It preserves PI-routed OpenAI configs and non-Codex alias/provider cases.

Verification

  • git diff --check
  • ./node_modules/.bin/tsgo -p tsconfig.core.json --pretty false --noEmit
  • node scripts/run-vitest.mjs src/commands/doctor/shared/codex-route-warnings.test.ts (90 tests)
  • codex review --uncommitted
  • Crabbox AWS E2E: run_36941cbccbb1

Real Behavior Proof

Behavior addressed: upgraded configs with plugins.entries.codex.enabled: false and default OpenAI/Codex-runtime models failed at runtime with Requested agent harness "codex" is not registered.

Real environment tested: Crabbox AWS Linux, lease cbx_554d34f93f0f, run run_36941cbccbb1.

Exact steps or command run after this patch: created a temp config with local gateway auth, plugins.entries.codex.enabled: false, and agents.defaults.model.primary: gpt-5.5; ran node scripts/run-node.mjs doctor --fix --non-interactive; started node scripts/run-node.mjs gateway; piped hello into node scripts/run-node.mjs agent --gateway-url http://127.0.0.1:19868 --gateway-token issue-82368-token.

Evidence after fix: doctor --fix wrote plugins.entries.codex.enabled: true; the gateway/agent logs did not contain Requested agent harness "codex" is not registered.

Observed result after fix: agent command reached the expected no-provider-credentials/runtime boundary with missingHarness: false instead of the reported missing-harness failure.

What was not tested: a successful live OpenAI model completion; no OpenAI API key was needed to prove this missing-harness failure was fixed.

@openclaw-barnacle openclaw-barnacle Bot added commands Command implementations size: XL maintainer Maintainer-authored PR labels May 16, 2026
@joshavant
joshavant force-pushed the fix/doctor-codex-plugin-runtime-82368 branch from d268ed3 to 03c5f07 Compare May 16, 2026 07:58
@clawsweeper

clawsweeper Bot commented May 16, 2026

Copy link
Copy Markdown
Contributor

ClawSweeper status: review started.

I am starting a fresh review of this pull request: Fix doctor repair for disabled Codex runtime plugin This is item 1/1 in the current shard. Shard 0/1.

This placeholder means the worker is alive and reading the current context. I will edit this same comment with the actual review when the claws are done clicking.

Crustacean status: shell secured, claws on keyboard, evidence pebbles being sorted.

@joshavant
joshavant merged commit c5b3352 into main May 16, 2026
183 of 190 checks passed
@joshavant
joshavant deleted the fix/doctor-codex-plugin-runtime-82368 branch May 16, 2026 08:16
galiniliev pushed a commit to galiniliev/openclaw that referenced this pull request May 20, 2026
* fix doctor codex plugin runtime repair

* add changelog for codex doctor repair

* avoid implicit codex repair without agent routes

* expect codex repair in doctor config flow
github-actions Bot pushed a commit to Desicool/openclaw that referenced this pull request May 24, 2026
* fix doctor codex plugin runtime repair

* add changelog for codex doctor repair

* avoid implicit codex repair without agent routes

* expect codex repair in doctor config flow
galiniliev pushed a commit to galiniliev/openclaw that referenced this pull request May 25, 2026
* fix doctor codex plugin runtime repair

* add changelog for codex doctor repair

* avoid implicit codex repair without agent routes

* expect codex repair in doctor config flow
qiaokuan1992 pushed a commit to qiaokuan1992/openclaw that referenced this pull request Jun 2, 2026
* fix doctor codex plugin runtime repair

* add changelog for codex doctor repair

* avoid implicit codex repair without agent routes

* expect codex repair in doctor config flow
jameslcowan pushed a commit to jameslcowan/openclaw that referenced this pull request Jun 2, 2026
* fix doctor codex plugin runtime repair

* add changelog for codex doctor repair

* avoid implicit codex repair without agent routes

* expect codex repair in doctor config flow
SYU8384 pushed a commit to SYU8384/openclaw that referenced this pull request Jun 3, 2026
* fix doctor codex plugin runtime repair

* add changelog for codex doctor repair

* avoid implicit codex repair without agent routes

* expect codex repair in doctor config flow
sablehead pushed a commit to sablehead/openclaw that referenced this pull request Jun 10, 2026
* fix doctor codex plugin runtime repair

* add changelog for codex doctor repair

* avoid implicit codex repair without agent routes

* expect codex repair in doctor config flow
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

commands Command implementations maintainer Maintainer-authored PR size: XL

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2026.5.12 update disables Codex plugin / drops runtime migration, causing "Requested agent harness codex is not registered"

1 participant