Skip to content

[Bug]: doctor recommends migrate codex --dry-run which doesn't work #84948

@markoa

Description

@markoa

Bug type

Regression (worked before, now fails)

Beta release blocker

No

Summary

openclaw migrate codex --dry-run fails with Error: Unknown migration provider "codex". Available providers: claude, hermes.

Steps to reproduce

1/ It started with an openclaw update:

$ openclaw update
Updating OpenClaw...

│
◇  ✓ Updating via package manager (80.16s)
│
◇  ✓ Running doctor checks (47.21s)

Update Result: ERROR
  Root: /home/marko/.nvm/versions/node/v24.14.1/lib/node_modules/openclaw
  Reason: global install verify
  Before: 2026.4.12
  After: 2026.5.19

Total time: 128.28s

2/ Then I ran doctor:

...
◇  Doctor warnings ────────────────────────────────────────────────────────────────────────╮
│                                                                                          │
│  - Legacy `openai-codex/*` model refs should be rewritten to `openai/*`.                 │
│  - agents.defaults.model.primary: openai-codex/gpt-5.4 should become openai/gpt-5.4.     │
│  - agents.defaults.models.openai-codex/gpt-5.4: openai-codex/gpt-5.4 should become       │
│    openai/gpt-5.4.                                                                       │
│  - Run `openclaw doctor --fix`: it rewrites configured model refs and stale sessions to  │
│    `openai/*`, moves Codex intent to provider/model runtime policy, and clears old       │
│    whole-agent runtime pins.                                                             │
│                                                                                          │
├──────────────────────────────────────────────────────────────────────────────────────────╯
│
◇  Doctor warnings ──────────────────────────────────────────────────────────────────────────╮
│                                                                                            │
│  - Personal Codex CLI assets were found, but native Codex-mode OpenClaw agents use         │
│    isolated per-agent Codex homes.                                                         │
│  - Sources: /home/marko/.codex and /home/marko/.agents/skills (1 skill, 0 plugins, 0       │
│    config files, 0 hook files).                                                            │
│  - These assets will not be loaded by the Codex app-server child unless you intentionally  │
│    promote them.                                                                           │
│  - Run `openclaw migrate codex --dry-run` to inventory them. Applying that migration       │
│    copies skills into the current OpenClaw agent workspace; Codex plugins, hooks, and      │
│    config stay manual-review only.                                                         │
│                                                                                            │
├────────────────────────────────────────────────────────────────────────────────────────────╯
...

Expected behavior

I expected the doctor in combination of suggested command(s) to fix my lobster.

Actual behavior

I can talk to my lobster but have no idea about the degree of my config problem.

OpenClaw version

2026.05.19

Operating system

Ubuntu 24.04

Install method

npm global

Model

openai-codex/gpt-5.4

Provider / routing chain

???

Additional provider/model setup details

No response

Logs, screenshots, and evidence

Impact and severity

No response

Additional information

No response

Metadata

Metadata

Assignees

No one assigned

    Labels

    P2Normal backlog priority with limited blast radius.bugSomething isn't workingclawsweeper:fix-shape-clearClawSweeper found a clear likely implementation shape for this issue.clawsweeper:queueable-fixClawSweeper marked this issue as an existing queue_fix_pr work candidate.clawsweeper:source-reproClawSweeper found a high-confidence source-level issue reproduction.impact:auth-providerAuth, provider routing, model choice, or SecretRef resolution may break.issue-rating: 🦞 diamond lobsterVery strong issue quality with high-confidence source-level or clear reproduction.

    Type

    No type
    No fields configured for issues without a type.

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions