UNPKG

openclaw

Version:

Multi-channel AI gateway with extensible messaging integrations

github.com/openclaw/openclaw

openclaw/openclaw

123 lines (85 loc) • 7.74 kB
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
--- summary: "Configuration, auth, discovery, and app-server reference for the Codex harness" title: "Codex harness reference" read_when: - 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](/plugins/codex-harness). ## Plugin config surface All Codex harness settings live under `plugins.entries.codex.config`. ```json5 { 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](/plugins/codex-harness-reference/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](/plugins/codex-harness-reference/app-server-transport). | | `codexDynamicToolsLoading` | `"searchable"` | Use `"direct"` to put OpenClaw dynamic tools directly in the initial Codex tool context. See [Codex dynamic tools](/plugins/codex-harness-reference/dynamic-tools). | | `codexDynamicToolsExclude` | `[]` | Additional OpenClaw dynamic tool names to omit from Codex app-server turns. See [Codex dynamic tools](/plugins/codex-harness-reference/dynamic-tools). | | `codexPlugins` | disabled | Native Codex plugin/app support, including opt-in access to connected account apps. See [Native Codex plugins](/plugins/codex-native-plugins). | | `computerUse` | disabled | Codex Computer Use setup. See [Codex Computer Use](/plugins/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](/plugins/codex-harness-reference/supervision). | | `supervision` | disabled | Agent-facing native-session transcript and write-control policy. See [Codex supervision](/plugins/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](/plugins/codex-harness-reference/supervision) — Native Codex session discovery and agent-facing supervision settings. - <a id="supervision"></a>[Supervision](/plugins/codex-harness-reference/supervision#supervision) ### Codex app-server transport [Codex app-server transport](/plugins/codex-harness-reference/app-server-transport) — App-server transport selection, the appServer field table, and local testing env overrides. - <a id="app-server-transport"></a>[App-server transport](/plugins/codex-harness-reference/app-server-transport#app-server-transport) - <a id="environment-overrides"></a>[Environment overrides](/plugins/codex-harness-reference/app-server-transport#environment-overrides) ### Codex approval and sandbox modes [Codex approval and sandbox modes](/plugins/codex-harness-reference/approval-and-sandbox) — YOLO and guardian approval presets, and sandboxed native execution paths. - <a id="approval-and-sandbox-modes"></a>[Approval and sandbox modes](/plugins/codex-harness-reference/approval-and-sandbox#approval-and-sandbox-modes) - <a id="sandboxed-native-execution"></a>[Sandboxed native execution](/plugins/codex-harness-reference/approval-and-sandbox#sandboxed-native-execution) ### Codex auth and environment isolation [Codex auth and environment isolation](/plugins/codex-harness-reference/auth) — Codex auth selection order, credential handling, and environment isolation. - <a id="auth-and-environment-isolation"></a>[Auth and environment isolation](/plugins/codex-harness-reference/auth#auth-and-environment-isolation) ### Codex dynamic tools [Codex dynamic tools](/plugins/codex-harness-reference/dynamic-tools) — How OpenClaw dynamic tools are exposed to Codex app-server turns. - <a id="dynamic-tools"></a>[Dynamic tools](/plugins/codex-harness-reference/dynamic-tools#dynamic-tools) ### Codex timeouts and turn settlement [Codex timeouts and turn settlement](/plugins/codex-harness-reference/timeouts) — Dynamic tool timeout order, turn execution budgets, and local settlement. - <a id="timeouts"></a>[Timeouts](/plugins/codex-harness-reference/timeouts#timeouts) - <a id="turn-execution-and-settlement"></a>[Turn execution and settlement](/plugins/codex-harness-reference/timeouts#turn-execution-and-settlement) ### Codex model discovery [Codex model discovery](/plugins/codex-harness-reference/model-discovery) — Codex app-server model discovery, offline hints, and catalog rules. - <a id="model-discovery"></a>[Model discovery](/plugins/codex-harness-reference/model-discovery#model-discovery) ### Codex restricted turns [Codex restricted turns](/plugins/codex-harness-reference/restricted-turns) — When a tool policy restricts the Codex native surface, and what ring zero adds. - <a id="restricted-turns"></a>[Restricted turns](/plugins/codex-harness-reference/restricted-turns#restricted-turns) ### Codex workspace bootstrap files [Codex workspace bootstrap files](/plugins/codex-harness-reference/workspace-bootstrap-files) — Which workspace bootstrap files reach a Codex turn, and how they are carried. - <a id="workspace-bootstrap-files"></a>[Workspace bootstrap files](/plugins/codex-harness-reference/workspace-bootstrap-files#workspace-bootstrap-files) ## Related - [Codex harness](/plugins/codex-harness) - [Codex harness runtime](/plugins/codex-harness-runtime) - [Codex supervision](/plugins/codex-supervision) - [Native Codex plugins](/plugins/codex-native-plugins) - [Codex Computer Use](/plugins/codex-computer-use) - [OpenAI provider](/providers/openai) - [Configuration reference](/gateway/configuration-reference)