@@ -3,7 +3,7 @@ summary: "Configure migrated native Codex plugins for Codex-mode OpenClaw agents
33title : " Native Codex plugins"
44read_when :
55 - You want Codex-mode OpenClaw agents to use native Codex plugins
6- - You are configuring first-party Codex plugin marketplaces
6+ - You are migrating source-installed openai-curated Codex plugins
77 - You are troubleshooting codexPlugins, app inventory, destructive actions, or plugin app diagnostics
88---
99
@@ -22,9 +22,7 @@ Use this page after the base [Codex harness](/plugins/codex-harness) is working.
2222- The selected OpenClaw agent runtime must be the native Codex harness.
2323- ` plugins.entries.codex.enabled ` must be true.
2424- ` plugins.entries.codex.config.codexPlugins.enabled ` must be true.
25- - V1 supports first-party Codex plugin marketplaces: ` openai-curated ` ,
26- ` openai-bundled ` , and ` openai-primary-runtime ` .
27- - Migration only auto-discovers ` openai-curated ` plugins that it observed as
25+ - V1 supports only ` openai-curated ` plugins that migration observed as
2826 source-installed in the source Codex home.
2927- The target Codex app-server must be able to see the expected marketplace,
3028 plugin, and app inventory.
@@ -58,11 +56,9 @@ Apply the migration when the plan looks right:
5856openclaw migrate apply codex --yes
5957```
6058
61- Migration writes explicit ` codexPlugins ` entries for eligible curated plugins
62- and calls Codex app-server ` plugin/install ` for selected plugins. Explicit
63- config may also reference Codex's bundled and primary-runtime first-party
64- marketplaces when the target app-server inventory exposes those plugin apps. A
65- typical migrated config looks like this:
59+ Migration writes explicit ` codexPlugins ` entries for eligible plugins and calls
60+ Codex app-server ` plugin/install ` for selected plugins. A typical migrated
61+ config looks like this:
6662
6763``` json5
6864{
@@ -93,49 +89,6 @@ After changing `codexPlugins`, new Codex conversations pick up the updated app
9389set automatically. Use ` /new ` or ` /reset ` to refresh the current conversation.
9490A gateway restart is not required for plugin enable or disable changes.
9591
96- ## Manual first-party marketplace entries
97-
98- Migration writes ` openai-curated ` entries for eligible source-installed plugins.
99- For first-party plugins that live in Codex's bundled or primary-runtime
100- marketplaces, add explicit entries after confirming the target Codex app-server
101- inventory exposes that marketplace and plugin.
102-
103- Use the same config shape for every first-party marketplace:
104-
105- ``` json5
106- {
107- plugins: {
108- entries: {
109- codex: {
110- enabled: true ,
111- config: {
112- codexPlugins: {
113- enabled: true ,
114- plugins: {
115- chrome: {
116- enabled: true ,
117- marketplaceName: " openai-bundled" ,
118- pluginName: " chrome" ,
119- },
120- documents: {
121- enabled: true ,
122- marketplaceName: " openai-primary-runtime" ,
123- pluginName: " documents" ,
124- },
125- },
126- },
127- },
128- },
129- },
130- },
131- }
132- ```
133-
134- The key under ` plugins ` is OpenClaw's local config key. ` pluginName ` and
135- ` marketplaceName ` must match the Codex app-server inventory exactly. If the
136- plugin is not listed in ` /codex plugins list ` or Codex app diagnostics, OpenClaw
137- keeps the entry configured but cannot expose its apps to Codex turns.
138-
13992## Manage plugins from chat
14093
14194Use ` /codex plugins ` when you want to inspect or change configured native Codex
@@ -197,10 +150,8 @@ up the updated app set.
197150
198151V1 is intentionally narrow:
199152
200- - Runtime config accepts ` openai-curated ` , ` openai-bundled ` , and
201- ` openai-primary-runtime ` plugin identities.
202153- Only ` openai-curated ` plugins that were already installed in the source Codex
203- app-server inventory are migration-eligible for automatic migration .
154+ app-server inventory are migration-eligible.
204155- App-backed source plugins must pass the migration-time subscription gate.
205156 ` --verify-plugin-apps ` adds the source app-inventory gate. Subscription-gated
206157 accounts plus, in verification mode, inaccessible, disabled, missing source
@@ -213,9 +164,7 @@ V1 is intentionally narrow:
213164- There is no ` plugins["*"] ` wildcard and no config key that grants arbitrary
214165 install authority.
215166- Unsupported marketplaces, cached plugin bundles, hooks, and Codex config files
216- are preserved in the migration report for manual review. Bundled and
217- primary-runtime first-party plugins can still be added manually through
218- explicit ` codexPlugins ` config.
167+ are preserved in the migration report for manual review.
219168
220169## App inventory and ownership
221170
@@ -303,10 +252,8 @@ app-server auth or rerun with `--verify-plugin-apps` if you want source app
303252inventory to decide eligibility when account lookup fails.
304253
305254** ` marketplace_missing ` or ` plugin_missing ` :** the target Codex app-server
306- cannot see the expected first-party marketplace or plugin. Rerun migration
307- against the target runtime, inspect Codex app-server plugin status, or confirm
308- the explicit ` marketplaceName ` is one of ` openai-curated ` , ` openai-bundled ` , or
309- ` openai-primary-runtime ` .
255+ cannot see the expected ` openai-curated ` marketplace or plugin. Rerun migration
256+ against the target runtime or inspect Codex app-server plugin status.
310257
311258** ` app_inventory_missing ` or ` app_inventory_stale ` :** app readiness came from an
312259empty or stale cache. OpenClaw schedules an async refresh and excludes plugin
0 commit comments