Skip to content

Commit 57fa8a0

Browse files
kevinslinkevinslin
committed
docs(codex): document plugin management commands
1 parent 1893c59 commit 57fa8a0

3 files changed

Lines changed: 40 additions & 7 deletions

File tree

‎CHANGELOG.md‎

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -15,6 +15,7 @@ Docs: https://docs.openclaw.ai
1515
- Agents/skills: tighten bundled skill prompts and metadata, quote skill descriptions, refresh current CLI/API guidance, and update embedded sherpa-onnx runtime downloads.
1616
- Skills: update the Obsidian skill to target the official `obsidian` CLI and require its registered binary instead of the third-party `obsidian-cli`.
1717
- Skills: add a Python debugging skill for pdb, breakpoint(), post-mortem inspection, and debugpy remote attach.
18+
- Codex: add `/codex plugins list`, `enable`, and `disable` for managing configured native Codex plugins from chat without editing config by hand.
1819
- Plugins/messages: add presentation capability limits for channel renderers, adapt rich message controls before native rendering, and mark legacy `interactive`/Slack directive producer APIs as deprecated.
1920
- Proxy: support HTTPS managed forward-proxy endpoints and scoped `proxy.tls.caFile` CA trust for proxy endpoint TLS. (#79171) Thanks @jesse-merhi.
2021
- QA-Lab: add first-hour 20-turn and optional 100-turn runtime parity scenarios, with tier metadata for standard and soak QA gates. Fixes #80338; refs #80337. Thanks @100yenadmin.

‎docs/plugins/codex-harness.md‎

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -201,6 +201,8 @@ Common command routing:
201201
| Attach the current chat | `/codex bind [--cwd <path>]` |
202202
| Resume an existing Codex thread | `/codex resume <thread-id>` |
203203
| List or filter Codex threads | `/codex threads [filter]` |
204+
| List native Codex plugins | `/codex plugins list` |
205+
| Enable or disable a configured native Codex plugin | `/codex plugins enable <name>`, `/codex plugins disable <name>` |
204206
| Attach an existing Codex CLI session on a paired node | `/codex sessions --host <node> [filter]`, then `/codex resume <session-id> --host <node> --bind here` |
205207
| Send Codex feedback only | `/codex diagnostics [note]` |
206208
| Start an ACP/acpx task | ACP/acpx session commands, not `/codex` |

‎docs/plugins/codex-native-plugins.md‎

Lines changed: 37 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -81,8 +81,35 @@ config looks like this:
8181
}
8282
```
8383

84-
After changing `codexPlugins`, use `/new`, `/reset`, or restart the gateway so
85-
future Codex harness sessions start with the updated app set.
84+
After changing `codexPlugins`, new Codex conversations pick up the updated app
85+
set automatically. Use `/new` or `/reset` to refresh the current conversation.
86+
A gateway restart is not required for plugin enable or disable changes.
87+
88+
## Manage plugins from chat
89+
90+
Use `/codex plugins` when you want to inspect or change configured native Codex
91+
plugins from the same chat where you operate the Codex harness:
92+
93+
```text
94+
/codex plugins
95+
/codex plugins list
96+
/codex plugins disable google-calendar
97+
/codex plugins enable google-calendar
98+
```
99+
100+
`/codex plugins` is an alias for `/codex plugins list`. The list output shows
101+
the configured plugin keys, on/off state, Codex plugin name, and marketplace
102+
from `plugins.entries.codex.config.codexPlugins.plugins`.
103+
104+
`enable` and `disable` write only to OpenClaw config at
105+
`~/.openclaw/openclaw.json`; they do not edit `~/.codex/config.toml` or install
106+
new Codex plugins. Only the owner or a gateway client with the
107+
`operator.admin` scope can change plugin state.
108+
109+
Enabling a configured plugin also turns on the global
110+
`codexPlugins.enabled` switch. If the plugin was written disabled because
111+
migration returned `auth_required`, reauthorize the app in Codex before enabling
112+
it in OpenClaw.
86113

87114
## How native plugin setup works
88115

@@ -110,7 +137,10 @@ check after migration. Codex harness session setup then computes a restrictive
110137
thread app config for the enabled and accessible plugin apps.
111138

112139
Thread app config is computed when OpenClaw establishes a Codex harness session
113-
or replaces a stale Codex thread binding. It is not recomputed on every turn.
140+
or replaces a stale Codex thread binding. It is not recomputed on every turn, so
141+
`/codex plugins enable` and `/codex plugins disable` affect new Codex
142+
conversations. Use `/new` or `/reset` when the current conversation should pick
143+
up the updated app set.
114144

115145
## V1 support boundary
116146

@@ -228,10 +258,10 @@ apps until ownership and readiness are known.
228258
**`app_ownership_ambiguous`:** app inventory only matched by display name, so
229259
the app is not exposed to the Codex thread.
230260

231-
**Config changed but the agent cannot see the plugin:** use `/new`, `/reset`, or
232-
restart the gateway. Existing Codex thread bindings keep the app config they
233-
started with until OpenClaw establishes a new harness session or replaces a
234-
stale binding.
261+
**Config changed but the agent cannot see the plugin:** use `/codex plugins
262+
list` to confirm the configured state, then use `/new` or `/reset`. Existing
263+
Codex thread bindings keep the app config they started with until OpenClaw
264+
establishes a new harness session or replaces a stale binding.
235265

236266
**Destructive action is declined:** check the global and per-plugin
237267
`allow_destructive_actions` values. Even when policy is true, unsafe elicitation

0 commit comments

Comments
 (0)