Vincent Koc
3b61516187
Structural-only pass over the open `ia` audit rows for docs/plugins/ and docs/channels/. No prose was rewritten; the only content additions are headings, one Related section, and one section index. - channels/whatsapp: group 24 flat H2 sections under four parent H2s (Setup, Access control, Messaging and delivery, Reactions and typing) by demoting contiguous siblings to H3. No sections reordered. - channels/clickclack: add a Configuration H2 so the JSON5/config-keys/ hostname references stop nesting under Quick setup, give the stray plugin-allowlist paragraph its own H3, and add a Related section. - channels/groups: drop the two redirect-only H2 stubs and carry their links into Related; both old ids kept as authored anchor stubs. - plugins/bundles: promote "MCP for embedded OpenClaw" to H2 and its children to H3, removing the H5 depth under "Supported now". - plugins/dependency-resolution: add eight H3s inside "Install roots". - plugins/manifest/setup-and-auth: put the `setup` object table before its child `setup.providers` table. - plugins/google-meet: rename the "Notes" H2 to "Audio bridge architecture" (old `#notes` id kept as an anchor stub) and move "Realtime session health" under it, out of Quick start. - plugins/sdk-overview: move the session-discussion paragraph below the registration table it was interrupting. - plugins/sdk-setup: fold "ClawHub publishing" into "Publishing and installing" as an H3 and add a section index after the intro. - plugins/codex-harness-reference: link the five unlinked config-surface table rows to the child pages that document them. - plugins/architecture: sidebar title "Internals" -> "Architecture". - docs.json: order channels/groups before channels/group-messages, and move plugins/install-overrides into the maintainer reference group. Anchor proof: parseDocsDocument id sets before/after over all 11 changed pages -- 0 ids lost, 0 collisions, 16 ids added.
7.6 KiB
summary, title, read_when
| summary | title | read_when | |||
|---|---|---|---|---|---|
| Configuration, auth, discovery, and app-server reference for the Codex harness | 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.