This page preserves the 2026-09-17 historical source snapshot below. Its
always/never/auto vocabulary and unsupported-policy statuses do not describe
the current API. For current authoring controls, read
Agent plugin policy,
bundled Driver mappings, or the
selected Driver's GET /installation capabilities. For current hosted discovery,
see Create Agent plugins.
The local docs preview adds filters and expandable evidence to this historical table. GitHub shows the generated table with pinned source/test links. Both use the same snapshot data. No live runtime was exercised for that review. The testing guide distinguishes older runtime results from the current verification gap.
Reviewed 2026-09-17 at c4ecf32727aef09a6b4caeec16870bf391f7a505.
| Capability | Scope | occ-plugin (embedded OpenClaw) | codex-plugin (dedicated Codex) |
|---|---|---|---|
| LIST/QUERY plugins | Discover available plugins through the controller catalog and HTTP inventory. Whether OCC and API clients can list available plugins. Agent reads show saved selections; they do not query the available catalog. | ✓ Partial. Internal listCatalog returns the bundled Diffs catalog. No HTTP plugin inventory or catalog-query endpoint is exposed. Source: apps/controller/src/drivers/plugin/index.ts:144-147, docs/reference/drivers/plugin.md:44-48 Test coverage: tests/conformance/plugin-driver.test.mjs:151-162 |
✓ Partial. Internal listCatalog requires paired codexExecutable/codexHome and a ChatGPT-backed profile. No HTTP plugin inventory or catalog-query endpoint is exposed. Source: apps/controller/src/drivers/plugin/index.ts:150-178, docs/reference/drivers/plugin.md:44-48 Test coverage: tests/conformance/plugin-driver.test.mjs:212-268 |
| approval mode: always | Run without a plugin approval prompt. Request plugin calls without asking for approval. Other platform permissions and workload restrictions still apply. | ✓ Supported. Enable the selected plugin without a plugin approval step; other native restrictions still apply. Source: apps/controller/src/drivers/plugin/runtime-translator.ts:415-437 Test coverage: tests/conformance/plugin-driver.test.mjs:165-181 |
✓ Partial. Native app mode approve plus bridge allow_destructive_actions=true; explicit auto_review is rejected. Source: apps/controller/src/drivers/plugin/runtime-translator.ts:271-290, apps/controller/src/drivers/plugin/runtime-translator.ts:306-315, apps/controller/src/drivers/plugin/runtime-translator.ts:365-384 Test coverage: tests/conformance/plugin-driver.test.mjs:351-365 |
| approval mode: auto | Use native automatic approval semantics. Let the native runtime decide when approval is needed. This does not mean approve every call automatically. | — Unsupported. No equivalent generic native OpenClaw plugin approval control; startup rejects auto. Source: apps/controller/src/drivers/plugin/runtime-translator.ts:416-421 Test coverage: tests/conformance/plugin-driver.test.mjs:184-193 |
✓ Supported. Supported app-only selections use native auto approval and bridge allow_destructive_actions=auto. Source: apps/controller/src/drivers/plugin/runtime-translator.ts:306-315, apps/controller/src/drivers/plugin/runtime-translator.ts:365-384 Test coverage: tests/conformance/plugin-driver.test.mjs:283-325 |
| approval mode: never | Block selected-plugin execution. Prevent the Agent from executing the selected plugin, even if the package remains installed. | ✓ Supported. Disable the selected plugin; its package remains installed. Source: apps/controller/src/drivers/plugin/runtime-translator.ts:407-445 Test coverage: tests/conformance/plugin-driver.test.mjs:179-181 |
✓ Supported. No selected native app entry and bridge disabled; install identity remains and installation still runs. Source: apps/controller/src/drivers/plugin/runtime-translator.ts:344-404, apps/controller/src/drivers/plugin/runtime-translator.ts:306-315, apps/controller/src/drivers/plugin/runtime-translator.ts:365-384 Test coverage: tests/conformance/plugin-driver.test.mjs:379-389 |
| approval mode: prompt_human | Review every plugin call using a human user. Display label for approvalMode: prompt with approvalsReviewer: user. The request asks for review before every call; this label is not an API enum value. | — Unsupported. Every-call prompting and explicit reviewer selection are unsupported; startup rejects this policy. Source: apps/controller/src/drivers/plugin/runtime-translator.ts:415-425 Test coverage: tests/conformance/plugin-driver.test.mjs:184-193 |
— Unsupported. Startup rejects prompt, including with user. Reviewer selection is available with supported auto policy, but does not force review of every call. Source: apps/controller/src/drivers/plugin/runtime-translator.ts:271-280, apps/controller/src/drivers/plugin/runtime-translator.ts:365-384 Test coverage: tests/conformance/plugin-driver.test.mjs:392-404 |
| approval mode: prompt_auto_review | Review every plugin call using the native automatic reviewer. Display label for approvalMode: prompt with approvalsReviewer: auto_review. The request asks for review before every call; this label is not an API enum value. | — Unsupported. Every-call prompting and explicit reviewer selection are unsupported; startup rejects this policy. Source: apps/controller/src/drivers/plugin/runtime-translator.ts:415-425 Test coverage: tests/conformance/plugin-driver.test.mjs:184-193 |
— Unsupported. Startup rejects prompt, including with auto_review. Reviewer selection is available with supported auto policy, but does not force review of every call. Source: apps/controller/src/drivers/plugin/runtime-translator.ts:271-280, apps/controller/src/drivers/plugin/runtime-translator.ts:365-384 Test coverage: tests/conformance/plugin-driver.test.mjs:392-404 |
| Destructive-action and write overrides | Override write/destructive-action policy. Set different approval rules for write operations or destructive actions across a plugin. Enforcement needs reliable action classifications. | — Unsupported. Both destructiveActions and writes are rejected at startup. Source: apps/controller/src/drivers/plugin/runtime-translator.ts:423-425 Test coverage: tests/conformance/plugin-driver.test.mjs:184-193 |
— Unsupported. Category overrides are rejected; reliable tool metadata is unavailable. Source: apps/controller/src/drivers/plugin/runtime-translator.ts:130-136 Test coverage: tests/conformance/plugin-driver.test.mjs:392-404 |
| Per-tool enablement and approval overrides | Override individual tool policy. Enable, disable, or set approval rules for individual tools inside a plugin, instead of using only the plugin-wide policy. | — Unsupported. Any tools map is rejected at startup; catalog tools is null. Source: apps/controller/src/drivers/plugin/runtime-translator.ts:423-457 Test coverage: tests/conformance/plugin-driver.test.mjs:184-193 |
— Unsupported. Any tools map is rejected; curated catalog projection reports tools:null. Source: apps/controller/src/drivers/plugin/runtime-translator.ts:130-136 Test coverage: tests/conformance/plugin-driver.test.mjs:392-404 |
Edit docs/assets/plugin-driver-matrix.json after reading the current reference,
implementation, and focused tests. Set baseline to the reviewed full commit,
update reviewedAt, and verify each source range at that commit. Keep native
enforcement separate from API acceptance and preserve proof limitations.
From the repository root, regenerate and validate:
node scripts/generate-plugin-matrix.ts
node scripts/generate-plugin-matrix.ts --check
pnpm docs:check
pnpm docs:buildFollow local preview to open
/reference/drivers/plugin-matrix/. Contributor test and runtime prerequisites
remain in the plugin testing guide.