Skip to content

Latest commit

 

History

History
56 lines (44 loc) · 14.6 KB

plugin-matrix.md

File metadata and controls

56 lines (44 loc) · 14.6 KB

PluginDriver feature matrix

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

Update this snapshot

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:build

Follow local preview to open /reference/drivers/plugin-matrix/. Contributor test and runtime prerequisites remain in the plugin testing guide.