openclaw - 💡(How to fix) Fix doctor --fix strips renamed config keys and disables the plugin instead of migrating

Official PRs (…)
ON THIS PAGE

Recommended Tools

×6

Utilities matched from this issue’s tags and category — try them while you read without losing context.

GitHub issue graph ai analysis

Paste a GitHub issue URL. We fetch that issue, discover linked issues from bodies/comments/timeline, collect linked pull requests, and produce a structured English report.

The report is written in English Markdown for sharing and archival.

Helpful · Quick feedback

Loading…

Error Message

Summary: After upgrading, a config had plugins.entries.codex.config.codexDynamicToolsProfile (valid in the prior version). 2026.5.18 renamed this key to codexDynamicToolsLoading (enum searchable|direct). openclaw doctor --fix resolved the "additional properties" validation error by deleting the key and setting the plugin enabled: false — rather than migrating the renamed key. This silently disabled the codex plugin, which in turn unregistered the codex agent harness that scheduled jobs depend on (MissingAgentHarnessError: Requested agent harness "codex" is not registered).

Fix Action

Fix / Workaround

Reproduction:

  1. On a pre-2026.5.18 config with codex.config.codexDynamicToolsProfile set, upgrade to 2026.5.18.
  2. Run openclaw doctor --fix.
  3. Observe codex.config stripped and codex.enabled set to false.

Workaround: re-enable the plugin and set codexDynamicToolsLoading: searchable.

RAW_BUFFERClick to expand / collapse

Severity: medium — silent loss of operator configuration during an upgrade repair.

Version: 2026.5.18.

Summary: After upgrading, a config had plugins.entries.codex.config.codexDynamicToolsProfile (valid in the prior version). 2026.5.18 renamed this key to codexDynamicToolsLoading (enum searchable|direct). openclaw doctor --fix resolved the "additional properties" validation error by deleting the key and setting the plugin enabled: false — rather than migrating the renamed key. This silently disabled the codex plugin, which in turn unregistered the codex agent harness that scheduled jobs depend on (MissingAgentHarnessError: Requested agent harness "codex" is not registered).

Reproduction:

  1. On a pre-2026.5.18 config with codex.config.codexDynamicToolsProfile set, upgrade to 2026.5.18.
  2. Run openclaw doctor --fix.
  3. Observe codex.config stripped and codex.enabled set to false.

Expected: doctor --fix should migrate renamed keys where the mapping is known (codexDynamicToolsProfilecodexDynamicToolsLoading), or at minimum report the removal and preserve enabled rather than silently disabling a plugin other components depend on.

Workaround: re-enable the plugin and set codexDynamicToolsLoading: searchable.

Vote matrix · Quick signals

Works
Did the solution work? Tap to confirm.
Easy Fix
Was it a quick fix?
Time Saver
Did it save you time?
Blocking
Was it severely blocking?
Common Issue
Are others likely hitting this too?
Flaky / Intermittent
Is it intermittent?
Verified / Reproducible
Can you reproduce it reliably?
Loading…

Still need to ship something?

×6

Another batch ranked right after the header list — different links, same matching logic.

Back to top recommendations

TRENDING

openclaw - 💡(How to fix) Fix doctor --fix strips renamed config keys and disables the plugin instead of migrating