Codex-harnas

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

​

Snelle configuratie

openclaw models auth login --provider openai-codex

{
  plugins: {
    entries: {
      codex: {
        enabled: true,
      },
    },
  },
  agents: {
    defaults: {
      model: "openai/gpt-5.5",
      agentRuntime: {
        id: "codex",
      },
    },
  },
}

{
  plugins: {
    allow: ["codex"],
    entries: {
      codex: {
        enabled: true,
      },
    },
  },
}

​

Wat deze Plugin verandert

• directe OpenAI API-key-oppervlakken vervangen, zoals afbeeldingen, embeddings, spraak of realtime
• openai-codex/*-modelreferenties converteren zonder openclaw doctor --fix
• ACP/acpx het standaard Codex-pad maken
• bestaande sessies hot-switchen die al een PI-runtime hebben vastgelegd
• OpenClaw-kanaallevering, sessiebestanden, opslag van auth-profielen of berichtroutering vervangen

• before_prompt_build
• before_compaction, after_compaction
• llm_input, llm_output
• before_tool_call, after_tool_call
• before_message_write voor gespiegeld transcriptrecords
• before_agent_finalize via Codex Stop-relay
• agent_end

​

Routemap

• openai-codex/* is een verouderde route die doctor herschrijft.
• agentRuntime.id: "codex" vereist de Codex-harness en faalt gesloten als die niet beschikbaar is.
• agentRuntime.id: "auto" laat geregistreerde harnesses overeenkomende provider- routes claimen; OpenAI-agentreferenties worden naar Codex opgelost in plaats van PI.
• /codex ... beantwoordt “aan welke native Codex-conversatie moet deze chat koppelen of welke moet deze besturen?”
• ACP beantwoordt “welk extern harnessproces moet acpx starten?”

​

Kies de juiste modelprefix

​

Wat doctor-waarschuwingen betekenen

• openai/<model>
• agentRuntime.id: "codex"

​

Vereisten

• OpenClaw met de gebundelde codex-plugin beschikbaar.
• Codex app-server 0.125.0 of nieuwer. De gebundelde plugin beheert standaard een compatibele Codex app-server-binary, dus lokale codex-commando’s op PATH hebben geen invloed op normaal opstarten van de harness.
• Codex-authenticatie beschikbaar voor het app-server-proces of voor OpenClaw’s Codex-authenticatiebridge. Lokale app-server-starts gebruiken een door OpenClaw beheerde Codex-home voor elke agent en een geïsoleerde child-HOME, zodat ze standaard niet je persoonlijke ~/.codex-account, skills, plugins, configuratie, threadstatus of native $HOME/.agents/skills lezen.

​

Workspace-bootstrapbestanden

​

Voeg Codex toe naast andere modellen

• Zet Codex op een toegewezen agent met agentRuntime.id: "codex".
• Houd de standaardagent op agentRuntime.id: "auto" en PI-fallback voor normaal gemengd providergebruik.
• Gebruik oude codex/*-refs alleen voor compatibiliteit. Nieuwe configuraties zouden de voorkeur moeten geven aan openai/* plus een expliciet Codex-runtimebeleid.

{
  plugins: {
    entries: {
      codex: {
        enabled: true,
      },
    },
  },
  agents: {
    defaults: {
      agentRuntime: {
        id: "auto",
      },
    },
    list: [
      {
        id: "main",
        default: true,
        model: "anthropic/claude-opus-4-6",
      },
      {
        id: "codex",
        name: "Codex",
        model: "openai/gpt-5.5",
        agentRuntime: {
          id: "codex",
        },
      },
    ],
  },
}

• De standaardagent main gebruikt het normale providerpad en PI-compatibiliteitsfallback.
• De codex-agent gebruikt de Codex app-server-harness.
• Als Codex ontbreekt of niet wordt ondersteund voor de codex-agent, faalt de beurt in plaats van stilletjes PI te gebruiken.

​

Routing van agentcommando’s

​

Alleen-Codex-deployments

{
  agents: {
    defaults: {
      model: "openai/gpt-5.5",
      agentRuntime: {
        id: "codex",
      },
    },
  },
}

OPENCLAW_AGENT_RUNTIME=codex openclaw gateway run

​

Codex per agent

{
  agents: {
    defaults: {
      agentRuntime: {
        id: "auto",
      },
    },
    list: [
      {
        id: "main",
        default: true,
        model: "anthropic/claude-opus-4-6",
      },
      {
        id: "codex",
        name: "Codex",
        model: "openai/gpt-5.5",
        agentRuntime: {
          id: "codex",
        },
      },
    ],
  },
}

​

Modeldetectie

• GPT-5.5
• GPT-5.4 mini
• GPT-5.2

{
  plugins: {
    entries: {
      codex: {
        enabled: true,
        config: {
          discovery: {
            enabled: true,
            timeoutMs: 2500,
          },
        },
      },
    },
  },
}

{
  plugins: {
    entries: {
      codex: {
        enabled: true,
        config: {
          discovery: {
            enabled: false,
          },
        },
      },
    },
  },
}

​

App-serververbinding en beleid

codex app-server --listen stdio://

{
  plugins: {
    entries: {
      codex: {
        enabled: true,
        config: {
          appServer: {
            mode: "guardian",
            serviceTier: "fast",
          },
        },
      },
    },
  },
}

{
  plugins: {
    entries: {
      codex: {
        enabled: true,
        config: {
          appServer: {
            transport: "websocket",
            url: "ws://127.0.0.1:39175",
            authToken: "${CODEX_APP_SERVER_TOKEN}",
            requestTimeoutMs: 60000,
          },
        },
      },
    },
  },
}

openclaw migrate codex --dry-run
openclaw migrate apply codex --yes

1. Een expliciet OpenClaw Codex-authenticatieprofiel voor de agent.
2. Het bestaande account van de app-server in de Codex-home van die agent.
3. Alleen voor lokale stdio app-server-starts, CODEX_API_KEY, daarna OPENAI_API_KEY, wanneer er geen app-server-account aanwezig is en OpenAI-authenticatie nog steeds vereist is.

{
  plugins: {
    entries: {
      codex: {
        enabled: true,
        config: {
          appServer: {
            clearEnv: ["CODEX_API_KEY", "OPENAI_API_KEY"],
          },
        },
      },
    },
  },
}

• OPENCLAW_CODEX_APP_SERVER_BIN
• OPENCLAW_CODEX_APP_SERVER_ARGS
• OPENCLAW_CODEX_APP_SERVER_MODE=yolo|guardian
• OPENCLAW_CODEX_APP_SERVER_APPROVAL_POLICY
• OPENCLAW_CODEX_APP_SERVER_SANDBOX

​

Computergebruik

{
  plugins: {
    entries: {
      codex: {
        enabled: true,
        config: {
          computerUse: {
            autoInstall: true,
          },
        },
      },
    },
  },
  agents: {
    defaults: {
      model: "openai/gpt-5.5",
      agentRuntime: {
        id: "codex",
      },
    },
  },
}

• /codex computer-use status
• /codex computer-use install
• /codex computer-use install --source <marketplace-source>
• /codex computer-use install --marketplace-path <path>

​

Veelgebruikte recepten

{
  plugins: {
    entries: {
      codex: {
        enabled: true,
      },
    },
  },
}

{
  agents: {
    defaults: {
      model: "openai/gpt-5.5",
      agentRuntime: {
        id: "codex",
      },
    },
  },
  plugins: {
    entries: {
      codex: {
        enabled: true,
      },
    },
  },
}

{
  plugins: {
    entries: {
      codex: {
        enabled: true,
        config: {
          appServer: {
            mode: "guardian",
            approvalPolicy: "on-request",
            approvalsReviewer: "auto_review",
            sandbox: "workspace-write",
          },
        },
      },
    },
  },
}

{
  plugins: {
    entries: {
      codex: {
        enabled: true,
        config: {
          appServer: {
            transport: "websocket",
            url: "ws://gateway-host:39175",
            headers: {
              "X-OpenClaw-Agent": "main",
            },
          },
        },
      },
    },
  },
}

​

Codex-opdracht

• /codex status toont live app-serverconnectiviteit, modellen, account, rate limits, MCP-servers en skills.
• /codex models toont Codex app-servermodellen live.
• /codex threads [filter] toont recente Codex-threads.
• /codex resume <thread-id> koppelt de huidige OpenClaw-sessie aan een bestaande Codex-thread.
• /codex compact vraagt de Codex app-server om de gekoppelde thread te compacten.
• /codex review start een native Codex-review voor de gekoppelde thread.
• /codex diagnostics [note] vraagt om bevestiging voordat Codex-diagnosefeedback voor de gekoppelde thread wordt verzonden.
• /codex computer-use status controleert de geconfigureerde Computer Use-Plugin en MCP-server.
• /codex computer-use install installeert de geconfigureerde Computer Use-Plugin en herlaadt MCP-servers.
• /codex account toont account- en rate-limitstatus.
• /codex mcp toont de MCP-serverstatus van de Codex app-server.
• /codex skills toont de skills van de Codex app-server.

​

Veelgebruikte debugging-workflow

1. Voer /diagnostics bad tool choice after image upload uit of een andere korte notitie die beschrijft wat je zag.
2. Keur het diagnoseverzoek eenmalig goed. De goedkeuring maakt de lokale Gateway- diagnose-zip en, omdat de sessie de Codex-harness gebruikt, verzendt ook de relevante Codex-feedbackbundel naar OpenAI-servers.
3. Kopieer het voltooide diagnoseantwoord naar het bugrapport of de supportthread. Het bevat het lokale bundelpad, de privacysamenvatting, OpenClaw-sessie-id’s, Codex-thread-id’s en een regel Inspect locally voor elke Codex-thread.
4. Als je de run zelf wilt debuggen, voer dan de afgedrukte opdracht Inspect locally uit in een terminal. Die ziet eruit als codex resume <thread-id> en opent de native Codex-thread zodat je het gesprek kunt inspecteren, lokaal kunt voortzetten of Codex kunt vragen waarom het een bepaalde tool of bepaald plan koos.

​

Een Codex-thread inspecteren vanuit de CLI

codex resume <thread-id>

​

Hook-grenzen

​

V1-ondersteuningscontract

​

Tools, media en Compaction

​

Probleemoplossing

​

Gerelateerd

• Agent-harness-plugins
• Agent-runtimes
• Modelproviders
• OpenAI-provider
• Status
• Plugin-hooks
• Configuratiereferentie
• Testen