docs(codex): clarify computer use setup

sallyom · sallyom · commit 4bcc150a719c · 2026-05-27T12:42:14.000-04:00
Signed-off-by: sallyom &lt;somalley@redhat.com&gt;
diff --git a/docs/plugins/codex-computer-use.md b/docs/plugins/codex-computer-use.md
@@ -76,10 +76,9 @@ driver's safety model.
 
 ## Quick setup
 
-Set `plugins.entries.codex.config.computerUse.enabled` to `true` when
-Codex-mode turns must have Computer Use available before a thread starts. Pair
-it with `autoInstall` when OpenClaw should install or re-enable the Codex
-Computer Use plugin from discovered local marketplaces:
+Set `plugins.entries.codex.config.computerUse` when Codex-mode turns must have
+Computer Use available before a thread starts. `autoInstall: true` opts
+Computer Use in and lets OpenClaw install or re-enable it before the turn:
 
 ```json5
 {
@@ -89,7 +88,6 @@ Computer Use plugin from discovered local marketplaces:
         enabled: true,
         config: {
           computerUse: {
-            enabled: true,
             autoInstall: true,
           },
         },
@@ -132,7 +130,8 @@ not `openclaw codex ...` CLI subcommands:
 ```
 
 `status` is read-only. It does not add marketplace sources, install plugins, or
-enable Codex plugin support.
+enable Codex plugin support. If no config opts Computer Use in, `status` can
+report disabled even after a one-off install command.
 
 `install` enables Codex app-server plugin support, optionally adds a configured
 marketplace source, installs or re-enables the configured plugin through Codex
@@ -180,9 +179,10 @@ You can also register it explicitly from a shell with Codex:
 codex plugin marketplace add /Applications/Codex.app/Contents/Resources/plugins/openai-bundled
 ```
 
-If you use a nonstandard Codex app path, set `computerUse.marketplacePath` to a
-local marketplace file path or run `/codex computer-use install --source
-<marketplace-source>` once.
+If you use a nonstandard Codex app path, run `/codex computer-use install
+--source <marketplace-root>` once or set `computerUse.marketplacePath` to a
+local marketplace file path. Use `--marketplace-path` only when you have the
+marketplace JSON file path, not the bundled marketplace root.
 
 ## Remote catalog limit
 
