refactor(config): split channel schema imports

samzong · samzong · commit cb11e0217758 · 2026-05-15T11:58:40.000+08:00
Signed-off-by: samzong &lt;samzong.lu@gmail.com&gt;
diff --git a/src/config/zod-schema.channels-config.ts b/src/config/zod-schema.channels-config.ts
@@ -3,10 +3,6 @@ import type { ChannelsConfig } from "./types.channels.js";
 import { ChannelHeartbeatVisibilitySchema } from "./zod-schema.channels.js";
 import { ContextVisibilityModeSchema, GroupPolicySchema } from "./zod-schema.core.js";
 
-export * from "./zod-schema.providers-core.js";
-export * from "./zod-schema.providers-whatsapp.js";
-export { ChannelHeartbeatVisibilitySchema } from "./zod-schema.channels.js";
-
 const ChannelModelByChannelSchema = z
   .record(z.string(), z.record(z.string(), z.string()))
   .optional();
diff --git a/src/config/zod-schema.providers.lazy-runtime.test.ts b/src/config/zod-schema.providers.lazy-runtime.test.ts
@@ -17,9 +17,9 @@ describe("ChannelsSchema bundled runtime loading", () => {
   });
 
   it("skips bundled channel runtime discovery when only core channel keys are present", async () => {
-    const runtime = await importFreshModule<typeof import("./zod-schema.providers.js")>(
+    const runtime = await importFreshModule<typeof import("./zod-schema.channels-config.js")>(
       import.meta.url,
-      "./zod-schema.providers.js?scope=channels-core-only",
+      "./zod-schema.channels-config.js?scope=channels-core-only",
     );
 
     const parsed = runtime.ChannelsSchema.parse({
@@ -45,9 +45,9 @@ describe("ChannelsSchema bundled runtime loading", () => {
   });
 
   it("does not discover bundled channel runtime metadata during raw schema parsing", async () => {
-    const runtime = await importFreshModule<typeof import("./zod-schema.providers.js")>(
+    const runtime = await importFreshModule<typeof import("./zod-schema.channels-config.js")>(
       import.meta.url,
-      "./zod-schema.providers.js?scope=channels-plugin-owned",
+      "./zod-schema.channels-config.js?scope=channels-plugin-owned",
     );
 
     runtime.ChannelsSchema.parse({
diff --git a/src/config/zod-schema.startup-import.test.ts b/src/config/zod-schema.startup-import.test.ts
@@ -0,0 +1,45 @@
+import { importFreshModule } from "openclaw/plugin-sdk/test-fixtures";
+import { beforeEach, describe, expect, it, vi } from "vitest";
+
+const providersWhatsappImportMock = vi.hoisted(() => vi.fn());
+const providersCoreImportMock = vi.hoisted(() => vi.fn());
+
+describe("OpenClawSchema startup imports", () => {
+  beforeEach(() => {
+    providersWhatsappImportMock.mockClear();
+    providersCoreImportMock.mockClear();
+    vi.doMock("./zod-schema.providers-core.js", () => {
+      providersCoreImportMock();
+      return {};
+    });
+    vi.doMock("./zod-schema.providers-whatsapp.js", () => {
+      providersWhatsappImportMock();
+      return {};
+    });
+  });
+
+  it("does not load provider-specific channel schemas for generic channel validation", async () => {
+    const runtime = await importFreshModule<typeof import("./zod-schema.js")>(
+      import.meta.url,
+      "./zod-schema.js?scope=startup-generic-channels",
+    );
+
+    const parsed = runtime.OpenClawSchema.safeParse({
+      channels: {
+        defaults: {
+          groupPolicy: "open",
+          botLoopProtection: {
+            maxEventsPerWindow: 4,
+            windowSeconds: 90,
+            cooldownSeconds: 30,
+          },
+        },
+        discord: {},
+      },
+    });
+
+    expect(parsed.success).toBe(true);
+    expect(providersCoreImportMock).not.toHaveBeenCalled();
+    expect(providersWhatsappImportMock).not.toHaveBeenCalled();
+  });
+});
diff --git a/src/config/zod-schema.ts b/src/config/zod-schema.ts
@@ -16,14 +16,14 @@ import {
 import { ToolsSchema } from "./zod-schema.agent-runtime.js";
 import { AgentsSchema, AudioSchema, BindingsSchema, BroadcastSchema } from "./zod-schema.agents.js";
 import { ApprovalsSchema } from "./zod-schema.approvals.js";
+import { ChannelsSchema } from "./zod-schema.channels-config.js";
 import {
   HexColorSchema,
   ModelsConfigSchema,
   SecretInputSchema,
   SecretsConfigSchema,
 } from "./zod-schema.core.js";
 import { HookMappingSchema, HooksGmailSchema, InternalHooksSchema } from "./zod-schema.hooks.js";
-import { ChannelsSchema } from "./zod-schema.providers.js";
 import { ProxyConfigSchema } from "./zod-schema.proxy.js";
 import { sensitive } from "./zod-schema.sensitive.js";
 import {
