@@ -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```
605861-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:
66626763```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.
959196-## 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
1409314194Use `/codex plugins` when you want to inspect or change configured native Codex
@@ -197,10 +150,8 @@ up the updated app set.
197150198151V1 is intentionally narrow:
199152200-- 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.
219168220169## 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.
304253305254**`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.
310257311258**`app_inventory_missing` or `app_inventory_stale`:** app readiness came from an
312259empty or stale cache. OpenClaw schedules an async refresh and excludes plugin
此内容由惯性聚合(RSS阅读器)自动聚合整理，仅供阅读参考。 原文来自 — 版权归原作者所有。