Skip to main content
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.
Top-level fields:

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.