openclaw - 💡(How to fix) Fix [Bug]: doctor recommends `migrate codex --dry-run` which doesn't work [2 pull requests]

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…

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

Error Message

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

Root Cause

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

Fix Action

Fixed

Code Example

$ 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

---

...
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.                                                         
│                                                                                            │
├────────────────────────────────────────────────────────────────────────────────────────────╯
...

---
RAW_BUFFERClick to expand / collapse

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

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…

FAQ

Expected behavior

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

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 [Bug]: doctor recommends `migrate codex --dry-run` which doesn't work [2 pull requests]