From 81035e651bf7b8446751182475a820bc65af8d48 Mon Sep 17 00:00:00 2001
From: dougbtv <dosmith@redhat.com>
Date: Sat, 2 May 2026 09:50:13 -0400
Subject: [PATCH] fix(config): register bundledMode in zod schema and help text

Addresses review feedback: adds bundledMode to the strict plugins zod
object so the config option passes validation, and adds schema.help
documentation for the field.
---
 src/config/schema.help.ts | 2 ++
 src/config/zod-schema.ts  | 1 +
 2 files changed, 3 insertions(+)

diff --git a/src/config/schema.help.ts b/src/config/schema.help.ts
index d53ce928333..4b6c9642e0e 100644
--- a/src/config/schema.help.ts
+++ b/src/config/schema.help.ts
@@ -1212,6 +1212,8 @@ export const FIELD_HELP: Record<string, string> = {
     'Select the active memory plugin by id, or "none" to disable memory plugins.',
   "plugins.slots.contextEngine":
     "Selects the active context engine plugin by id so one plugin provides context orchestration behavior.",
+  "plugins.bundledMode":
+    'Controls whether bundled plugins bypass plugins.allow on runtime discovery paths. "compat" (default) preserves legacy behavior where bundled provider plugins are force-loaded on every chat turn. "respect-allow" gates bundled plugins by the allowlist the same way third-party plugins are gated.',
   "plugins.entries":
     "Per-plugin settings keyed by plugin ID including enablement and plugin-specific runtime configuration payloads. Use this for scoped plugin tuning without changing global loader policy.",
   "plugins.entries.*.enabled":
diff --git a/src/config/zod-schema.ts b/src/config/zod-schema.ts
index 33a4e8c0592..af5a330d75d 100644
--- a/src/config/zod-schema.ts
+++ b/src/config/zod-schema.ts
@@ -1073,6 +1073,7 @@ export const OpenClawSchema = z
           .strict()
           .optional(),
         entries: z.record(z.string(), PluginEntrySchema).optional(),
+        bundledMode: z.enum(["compat", "respect-allow"]).optional(),
       })
       .strict()
       .optional(),