@@ -33,6 +33,10 @@ Use this page after the base [Codex harness](/plugins/codex-harness) is working.
|
33 | 33 | conversation bindings, or other harnesses because those paths do not create |
34 | 34 | Codex app-server threads with native `apps` config. |
35 | 35 | |
| 36 | +OpenAI-side Codex access, app availability, and workspace app/plugin controls |
| 37 | +come from the signed-in Codex account. For the OpenAI account and admin model, |
| 38 | +see [Using Codex with your ChatGPT plan](https://help.openai.com/en/articles/11369540-using-codex-with-your-chatgpt-plan). |
| 39 | + |
36 | 40 | ## Quickstart |
37 | 41 | |
38 | 42 | Preview migration from the source Codex home: |
@@ -89,6 +93,49 @@ After changing `codexPlugins`, new Codex conversations pick up the updated app
|
89 | 93 | set automatically. Use `/new` or `/reset` to refresh the current conversation. |
90 | 94 | A gateway restart is not required for plugin enable or disable changes. |
91 | 95 | |
| 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 | + |
92 | 139 | ## Manage plugins from chat |
93 | 140 | |
94 | 141 | Use `/codex plugins` when you want to inspect or change configured native Codex |
|