Codex runtime reference
Codex harness reference
This reference covers detailed configuration for the official codex plugin.
For setup and routing decisions, start with
Codex harness.
Plugin config surface
All Codex harness settings live under plugins.entries.codex.config.
{ plugins: { entries: { codex: { enabled: true, config: { discovery: { enabled: true, timeoutMs: 2500, }, appServer: { mode: "guardian", }, }, }, }, },}Top-level fields:
| Field | Default | Meaning |
|---|---|---|
discovery |
enabled | Model discovery settings for Codex app-server model/list. See Codex model discovery. |
appServer |
managed stdio app-server | Transport, command, auth, approval, sandbox, and timeout settings. The ordinary harness defaults to agent-scoped state. See Codex app-server transport. |
codexDynamicToolsLoading |
"searchable" |
Use "direct" to put OpenClaw dynamic tools directly in the initial Codex tool context. See Codex dynamic tools. |
codexDynamicToolsExclude |
[] |
Additional OpenClaw dynamic tool names to omit from Codex app-server turns. See Codex dynamic tools. |
codexPlugins |
disabled | Native Codex plugin/app support, including opt-in access to connected account apps. See Native Codex plugins. |
computerUse |
disabled | Codex Computer Use setup. See Codex Computer Use. |
sessionCatalog |
enabled | Native Codex session discovery for the sidebar. Set enabled: false to disable it, or set homes to include additional local Codex stores. See Codex session catalog and supervision. |
supervision |
disabled | Agent-facing native-session transcript and write-control policy. See Codex supervision. |
Where each section moved
Every section of the single-page version now lives on this page or on one of the nine child pages below. The anchors from the single-page version still resolve here.
Codex session catalog and supervision
Codex session catalog and supervision — Native Codex session discovery and agent-facing supervision settings.
Codex app-server transport
Codex app-server transport — App-server transport selection, the appServer field table, and local testing env overrides.
Codex approval and sandbox modes
Codex approval and sandbox modes — YOLO and guardian approval presets, and sandboxed native execution paths.
Codex auth and environment isolation
Codex auth and environment isolation — Codex auth selection order, credential handling, and environment isolation.
Codex dynamic tools
Codex dynamic tools — How OpenClaw dynamic tools are exposed to Codex app-server turns.
Codex timeouts and turn settlement
Codex timeouts and turn settlement — Dynamic tool timeout order, turn execution budgets, and local settlement.
Codex model discovery
Codex model discovery — Codex app-server model discovery, offline hints, and catalog rules.
Codex restricted turns
Codex restricted turns — When a tool policy restricts the Codex native surface, and what ring zero adds.
Codex workspace bootstrap files
Codex workspace bootstrap files — Which workspace bootstrap files reach a Codex turn, and how they are carried.
