@@ -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 migrating source-installed openai-curated Codex plugins
6+ - You are configuring first-party Codex plugin marketplaces
77 - You are troubleshooting codexPlugins, app inventory, destructive actions, or plugin app diagnostics
88---
99@@ -22,7 +22,9 @@ 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 only `openai-curated` plugins that migration observed as
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
2628 source-installed in the source Codex home.
2729- The target Codex app-server must be able to see the expected marketplace,
2830 plugin, and app inventory.
@@ -52,9 +54,11 @@ Apply the migration when the plan looks right:
5254openclaw migrate apply codex --yes
5355```
545655-Migration writes explicit `codexPlugins` entries for eligible plugins and calls
56-Codex app-server `plugin/install` for selected plugins. A typical migrated
57-config looks like this:
57+Migration writes explicit `codexPlugins` entries for eligible curated plugins
58+and calls Codex app-server `plugin/install` for selected plugins. Explicit
59+config may also reference Codex's bundled and primary-runtime first-party
60+marketplaces when the target app-server inventory exposes those plugin apps. A
61+typical migrated config looks like this:
58625963```json5
6064{
@@ -146,8 +150,10 @@ up the updated app set.
146150147151V1 is intentionally narrow:
148152153+- Runtime config accepts `openai-curated`, `openai-bundled`, and
154+`openai-primary-runtime` plugin identities.
149155- Only `openai-curated` plugins that were already installed in the source Codex
150- app-server inventory are migration-eligible.
156+ app-server inventory are migration-eligible for automatic migration.
151157- App-backed source plugins must pass the migration-time subscription gate.
152158`--verify-plugin-apps` adds the source app-inventory gate. Subscription-gated
153159 accounts plus, in verification mode, inaccessible, disabled, missing source
@@ -160,7 +166,9 @@ V1 is intentionally narrow:
160166- There is no `plugins["*"]` wildcard and no config key that grants arbitrary
161167 install authority.
162168- Unsupported marketplaces, cached plugin bundles, hooks, and Codex config files
163- are preserved in the migration report for manual review.
169+ are preserved in the migration report for manual review. Bundled and
170+ primary-runtime first-party plugins can still be added manually through
171+ explicit `codexPlugins` config.
164172165173## App inventory and ownership
166174@@ -248,8 +256,10 @@ app-server auth or rerun with `--verify-plugin-apps` if you want source app
248256inventory to decide eligibility when account lookup fails.
249257250258**`marketplace_missing` or `plugin_missing`:** the target Codex app-server
251-cannot see the expected `openai-curated` marketplace or plugin. Rerun migration
252-against the target runtime or inspect Codex app-server plugin status.
259+cannot see the expected first-party marketplace or plugin. Rerun migration
260+against the target runtime, inspect Codex app-server plugin status, or confirm
261+the explicit `marketplaceName` is one of `openai-curated`, `openai-bundled`, or
262+`openai-primary-runtime`.
253263254264**`app_inventory_missing` or `app_inventory_stale`:** app readiness came from an
255265empty or stale cache. OpenClaw schedules an async refresh and excludes plugin
此内容由惯性聚合(RSS阅读器)自动聚合整理，仅供阅读参考。 原文来自 — 版权归原作者所有。