#Requested agent harness "codex" is not registered

1 messages · Page 1 of 1 (latest)

little plover
#

After successfully using OpenClaw with model "openai-codex/gpt-5.4" until now, I'm trying to switch to the Codex harness. I've updated my openclaw.json config file:

"agents": {
  "defaults": {
    "model": "openai/gpt-5.4",
    "agentRuntime": {
      "id": "codex",
    },
    "workspace": "/Users/openclaw/.openclaw/workspace",
    "userTimezone": "Australia/Melbourne",
    "compaction": {
      "mode": "safeguard"
    },
    "maxConcurrent": 4,
    "subagents": {
      "maxConcurrent": 8
    },
    "models": {
      "openai/gpt-5.4": {},
      "openai/gpt-5.5": {}
    }
  }
},

"plugins": {
  "entries": {
    "telegram": {
      "enabled": true
    },
    "openai": {
      "enabled": true
    },
    "codex": {
      "enabled": true
    }
  }
},

The gateway launches, but the web dashboard displays errors:

Requested agent harness "codex" is not registered.

⚠️ Agent failed before reply: Requested agent harness "codex" is not registered. Logs: openclaw logs --follow

Log output:

00:49:42+00:00 warn Config warnings:

  • plugins.entries.codex: plugin not found: codex (stale config entry ignored; remove it from plugins config)
uncut fiberBOT
#

To help others find answers, you can mark your question as solved via Right click solution message -> Apps -> ✅ Mark Solution

brazen forge
#

Upgrade to 2026.5.3. And then open your codex to help you fix the config. There are many issues during switching to codex harness.

cold dawn
#

Did you set this agents.default.runtime.id: codex and add the openai/gpt5.* models you want to use with codex. You can have both openai-codex/ and openai/ models in your config at the same time.

I finally got codex to work today after pouring through this page a bunch of times https://docs.openclaw.ai/plugins/codex-harness

summer light
#

i was on 2026.5.3 and i had a lot of problem with this

  1. according to doc, 'codex' is bundled, but it's actually not (for me at least)
  2. when i tried to install from clawhub, gateway blocked it saying it's dangerous, no way around that
high roost
high roost
#

did you make it work?