vrr/openclaw
2
0
Fork 0
mirror of https://github.com/openclaw/openclaw.git synced 2026-10-03 17:53:39 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions 31
openclaw/docs/plugins/codex-harness-reference.md

7.6 KiB
Raw Blame History

summary title read_when
Configuration, auth, discovery, and app-server reference for the Codex harness Codex harness reference
You need every Codex harness config field
You are changing app-server transport, auth, discovery, or timeout behavior
You are debugging Codex harness startup, model discovery, or environment isolation

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: 10000,
          },
          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.

Related