#@openclaw/codex plugin loads, but agent harness is not registered

1 messages · Page 1 of 1 (latest)

gilded dock
#

I’m trying to enable the native Codex harness for one agent only, but the harness never seems to register.

Environment:

OpenClaw: 2026.5.4
Plugin: @openclaw/codex installed with --dangerously-force-unsafe-install

The plugin appears installed and loaded:

enabled: true
status: loaded
providerIds: ["codex"]
mediaUnderstandingProviderIds: ["codex"]
agentHarnessIds: []

Plugin doctor is clean:

No plugin issues detected.

Then I tested one agent with:

{
  "model": {
    "primary": "openai/gpt-5.5",
    "fallbacks": []
  },
  "agentRuntime": {
    "id": "codex"
  }
}

A fresh smoke test fails with:

Requested agent harness "codex" is not registered.

I rolled the agent back to openai-codex/gpt-5.5 with no agentRuntime, and it works normally through PI.

Is there another config/activation step required for the @openclaw/codex plugin to register the native codex agent harness, or is this likely a plugin/core compatibility issue?