Plugin SDK: add narrow setup subpaths

extensions/ollama/index.ts

@@ -13,7 +13,7 @@ const PROVIDER_ID = "ollama";
 const DEFAULT_API_KEY = "ollama-local";
 
 async function loadProviderSetup() {
-  return await import("openclaw/plugin-sdk/provider-setup");
+  return await import("openclaw/plugin-sdk/ollama-setup");
 }
 
 const ollamaPlugin = {

extensions/sglang/index.ts

@@ -13,7 +13,7 @@ import {
 const PROVIDER_ID = "sglang";
 
 async function loadProviderSetup() {
-  return await import("openclaw/plugin-sdk/provider-setup");
+  return await import("openclaw/plugin-sdk/self-hosted-provider-setup");
 }
 
 const sglangPlugin = {

extensions/vllm/index.ts

@@ -13,7 +13,7 @@ import {
 const PROVIDER_ID = "vllm";
 
 async function loadProviderSetup() {
-  return await import("openclaw/plugin-sdk/provider-setup");
+  return await import("openclaw/plugin-sdk/self-hosted-provider-setup");
 }
 
 const vllmPlugin = {

package.json

@@ -50,6 +50,10 @@
       "types": "./dist/plugin-sdk/compat.d.ts",
       "default": "./dist/plugin-sdk/compat.js"
     },
+    "./plugin-sdk/ollama-setup": {
+      "types": "./dist/plugin-sdk/ollama-setup.d.ts",
+      "default": "./dist/plugin-sdk/ollama-setup.js"
+    },
     "./plugin-sdk/provider-setup": {
       "types": "./dist/plugin-sdk/provider-setup.d.ts",
       "default": "./dist/plugin-sdk/provider-setup.js"
@@ -58,6 +62,10 @@
       "types": "./dist/plugin-sdk/sandbox.d.ts",
       "default": "./dist/plugin-sdk/sandbox.js"
     },
+    "./plugin-sdk/self-hosted-provider-setup": {
+      "types": "./dist/plugin-sdk/self-hosted-provider-setup.d.ts",
+      "default": "./dist/plugin-sdk/self-hosted-provider-setup.js"
+    },
     "./plugin-sdk/routing": {
       "types": "./dist/plugin-sdk/routing.d.ts",
       "default": "./dist/plugin-sdk/routing.js"

src/plugin-sdk/ollama-setup.ts

@@ -0,0 +1,17 @@
+export type {
+  OpenClawPluginApi,
+  ProviderAuthContext,
+  ProviderAuthMethodNonInteractiveContext,
+  ProviderAuthResult,
+  ProviderDiscoveryContext,
+} from "../plugins/types.js";
+
+export {
+  OLLAMA_DEFAULT_BASE_URL,
+  OLLAMA_DEFAULT_MODEL,
+  configureOllamaNonInteractive,
+  ensureOllamaModelPulled,
+  promptAndConfigureOllama,
+} from "../commands/ollama-setup.js";
+
+export { buildOllamaProvider } from "../agents/models-config.providers.discovery.js";

src/plugin-sdk/self-hosted-provider-setup.ts

@@ -0,0 +1,23 @@
+export type {
+  OpenClawPluginApi,
+  ProviderAuthContext,
+  ProviderAuthMethodNonInteractiveContext,
+  ProviderAuthResult,
+  ProviderDiscoveryContext,
+} from "../plugins/types.js";
+
+export {
+  applyProviderDefaultModel,
+  configureOpenAICompatibleSelfHostedProviderNonInteractive,
+  discoverOpenAICompatibleSelfHostedProvider,
+  promptAndConfigureOpenAICompatibleSelfHostedProvider,
+  promptAndConfigureOpenAICompatibleSelfHostedProviderAuth,
+  SELF_HOSTED_DEFAULT_CONTEXT_WINDOW,
+  SELF_HOSTED_DEFAULT_COST,
+  SELF_HOSTED_DEFAULT_MAX_TOKENS,
+} from "../commands/self-hosted-provider-setup.js";
+
+export {
+  buildSglangProvider,
+  buildVllmProvider,
+} from "../agents/models-config.providers.discovery.js";

src/plugin-sdk/subpaths.test.ts

@@ -11,8 +11,10 @@ import * as imessageSdk from "openclaw/plugin-sdk/imessage";
 import * as lineSdk from "openclaw/plugin-sdk/line";
 import * as msteamsSdk from "openclaw/plugin-sdk/msteams";
 import * as nostrSdk from "openclaw/plugin-sdk/nostr";
+import * as ollamaSetupSdk from "openclaw/plugin-sdk/ollama-setup";
 import * as providerSetupSdk from "openclaw/plugin-sdk/provider-setup";
 import * as sandboxSdk from "openclaw/plugin-sdk/sandbox";
+import * as selfHostedProviderSetupSdk from "openclaw/plugin-sdk/self-hosted-provider-setup";
 import * as signalSdk from "openclaw/plugin-sdk/signal";
 import * as slackSdk from "openclaw/plugin-sdk/slack";
 import * as telegramSdk from "openclaw/plugin-sdk/telegram";
@@ -62,6 +64,23 @@ describe("plugin-sdk subpath exports", () => {
     );
   });
 
+  it("exports narrow self-hosted provider setup helpers", () => {
+    expect(typeof selfHostedProviderSetupSdk.buildVllmProvider).toBe("function");
+    expect(typeof selfHostedProviderSetupSdk.buildSglangProvider).toBe("function");
+    expect(typeof selfHostedProviderSetupSdk.discoverOpenAICompatibleSelfHostedProvider).toBe(
+      "function",
+    );
+    expect(
+      typeof selfHostedProviderSetupSdk.configureOpenAICompatibleSelfHostedProviderNonInteractive,
+    ).toBe("function");
+  });
+
+  it("exports narrow Ollama setup helpers", () => {
+    expect(typeof ollamaSetupSdk.buildOllamaProvider).toBe("function");
+    expect(typeof ollamaSetupSdk.configureOllamaNonInteractive).toBe("function");
+    expect(typeof ollamaSetupSdk.ensureOllamaModelPulled).toBe("function");
+  });
+
   it("exports sandbox helpers from the dedicated subpath", () => {
     expect(typeof sandboxSdk.registerSandboxBackend).toBe("function");
     expect(typeof sandboxSdk.runPluginCommandWithTimeout).toBe("function");

src/plugins/contracts/discovery.contract.test.ts

@@ -32,6 +32,23 @@ vi.mock("openclaw/plugin-sdk/provider-setup", async () => {
   };
 });
 
+vi.mock("openclaw/plugin-sdk/self-hosted-provider-setup", async () => {
+  const actual = await vi.importActual<object>("openclaw/plugin-sdk/self-hosted-provider-setup");
+  return {
+    ...actual,
+    buildVllmProvider: (...args: unknown[]) => buildVllmProviderMock(...args),
+    buildSglangProvider: (...args: unknown[]) => buildSglangProviderMock(...args),
+  };
+});
+
+vi.mock("openclaw/plugin-sdk/ollama-setup", async () => {
+  const actual = await vi.importActual<object>("openclaw/plugin-sdk/ollama-setup");
+  return {
+    ...actual,
+    buildOllamaProvider: (...args: unknown[]) => buildOllamaProviderMock(...args),
+  };
+});
+
 const qwenPortalPlugin = (await import("../../../extensions/qwen-portal-auth/index.js")).default;
 const githubCopilotPlugin = (await import("../../../extensions/github-copilot/index.js")).default;
 const ollamaPlugin = (await import("../../../extensions/ollama/index.js")).default;