重构主控编排与运行时预热链路，统一工作区提示词/专家调度协议并补齐 wiki 记忆注入与写回闭环。

同时收敛启动与运维脚本默认行为（含 wiki worker）、更新 Admin 可观测性与相关测试，降低首轮时延并提高运行稳定性。

Made-with: Cursor

openclaw/extensions/vllm/README.md

@@ -0,0 +1,3 @@
+# vLLM Provider
+
+Bundled provider plugin for vLLM discovery and setup.

openclaw/extensions/vllm/api.ts

@@ -0,0 +1,7 @@
+export {
+  VLLM_DEFAULT_API_KEY_ENV_VAR,
+  VLLM_DEFAULT_BASE_URL,
+  VLLM_MODEL_PLACEHOLDER,
+  VLLM_PROVIDER_LABEL,
+} from "./defaults.js";
+export { buildVllmProvider } from "./models.js";

openclaw/extensions/vllm/defaults.ts

@@ -0,0 +1,4 @@
+export const VLLM_DEFAULT_BASE_URL = "http://127.0.0.1:8000/v1";
+export const VLLM_PROVIDER_LABEL = "vLLM";
+export const VLLM_DEFAULT_API_KEY_ENV_VAR = "VLLM_API_KEY";
+export const VLLM_MODEL_PLACEHOLDER = "meta-llama/Meta-Llama-3-8B-Instruct";

openclaw/extensions/vllm/index.ts

@@ -0,0 +1,94 @@
+import {
+  definePluginEntry,
+  type OpenClawPluginApi,
+  type ProviderAuthMethodNonInteractiveContext,
+} from "openclaw/plugin-sdk/plugin-entry";
+import {
+  buildVllmProvider,
+  VLLM_DEFAULT_API_KEY_ENV_VAR,
+  VLLM_DEFAULT_BASE_URL,
+  VLLM_MODEL_PLACEHOLDER,
+  VLLM_PROVIDER_LABEL,
+} from "./api.js";
+
+const PROVIDER_ID = "vllm";
+
+async function loadProviderSetup() {
+  return await import("openclaw/plugin-sdk/provider-setup");
+}
+
+export default definePluginEntry({
+  id: "vllm",
+  name: "vLLM Provider",
+  description: "Bundled vLLM provider plugin",
+  register(api: OpenClawPluginApi) {
+    api.registerProvider({
+      id: PROVIDER_ID,
+      label: "vLLM",
+      docsPath: "/providers/vllm",
+      envVars: ["VLLM_API_KEY"],
+      auth: [
+        {
+          id: "custom",
+          label: VLLM_PROVIDER_LABEL,
+          hint: "Local/self-hosted OpenAI-compatible server",
+          kind: "custom",
+          run: async (ctx) => {
+            const providerSetup = await loadProviderSetup();
+            return await providerSetup.promptAndConfigureOpenAICompatibleSelfHostedProviderAuth({
+              cfg: ctx.config,
+              prompter: ctx.prompter,
+              providerId: PROVIDER_ID,
+              providerLabel: VLLM_PROVIDER_LABEL,
+              defaultBaseUrl: VLLM_DEFAULT_BASE_URL,
+              defaultApiKeyEnvVar: VLLM_DEFAULT_API_KEY_ENV_VAR,
+              modelPlaceholder: VLLM_MODEL_PLACEHOLDER,
+            });
+          },
+          runNonInteractive: async (ctx: ProviderAuthMethodNonInteractiveContext) => {
+            const providerSetup = await loadProviderSetup();
+            return await providerSetup.configureOpenAICompatibleSelfHostedProviderNonInteractive({
+              ctx,
+              providerId: PROVIDER_ID,
+              providerLabel: VLLM_PROVIDER_LABEL,
+              defaultBaseUrl: VLLM_DEFAULT_BASE_URL,
+              defaultApiKeyEnvVar: VLLM_DEFAULT_API_KEY_ENV_VAR,
+              modelPlaceholder: VLLM_MODEL_PLACEHOLDER,
+            });
+          },
+        },
+      ],
+      discovery: {
+        order: "late",
+        run: async (ctx) => {
+          const providerSetup = await loadProviderSetup();
+          return await providerSetup.discoverOpenAICompatibleSelfHostedProvider({
+            ctx,
+            providerId: PROVIDER_ID,
+            buildProvider: buildVllmProvider,
+          });
+        },
+      },
+      wizard: {
+        setup: {
+          choiceId: "vllm",
+          choiceLabel: "vLLM",
+          choiceHint: "Local/self-hosted OpenAI-compatible server",
+          groupId: "vllm",
+          groupLabel: "vLLM",
+          groupHint: "Local/self-hosted OpenAI-compatible",
+          methodId: "custom",
+        },
+        modelPicker: {
+          label: "vLLM (custom)",
+          hint: "Enter vLLM URL + API key + model",
+          methodId: "custom",
+        },
+      },
+      buildUnknownModelHint: () =>
+        "vLLM requires authentication to be registered as a provider. " +
+        'Set VLLM_API_KEY (any value works) or run "openclaw configure". ' +
+        "See: https://docs.openclaw.ai/providers/vllm",
+    });
+  },
+});

openclaw/extensions/vllm/models.ts

@@ -0,0 +1,23 @@
+import type { OpenClawConfig } from "openclaw/plugin-sdk/config-runtime";
+import { discoverOpenAICompatibleLocalModels } from "openclaw/plugin-sdk/provider-setup";
+import { VLLM_DEFAULT_BASE_URL, VLLM_PROVIDER_LABEL } from "./defaults.js";
+
+type ModelsConfig = NonNullable<OpenClawConfig["models"]>;
+type ProviderConfig = NonNullable<ModelsConfig["providers"]>[string];
+
+export async function buildVllmProvider(params?: {
+  baseUrl?: string;
+  apiKey?: string;
+}): Promise<ProviderConfig> {
+  const baseUrl = (params?.baseUrl?.trim() || VLLM_DEFAULT_BASE_URL).replace(/\/+$/, "");
+  const models = await discoverOpenAICompatibleLocalModels({
+    baseUrl,
+    apiKey: params?.apiKey,
+    label: VLLM_PROVIDER_LABEL,
+  });
+  return {
+    baseUrl,
+    api: "openai-completions",
+    models,
+  };
+}

openclaw/extensions/vllm/openclaw.plugin.json

@@ -0,0 +1,25 @@
+{
+  "id": "vllm",
+  "enabledByDefault": true,
+  "providers": ["vllm"],
+  "providerAuthEnvVars": {
+    "vllm": ["VLLM_API_KEY"]
+  },
+  "providerAuthChoices": [
+    {
+      "provider": "vllm",
+      "method": "custom",
+      "choiceId": "vllm",
+      "choiceLabel": "vLLM",
+      "choiceHint": "Local/self-hosted OpenAI-compatible server",
+      "groupId": "vllm",
+      "groupLabel": "vLLM",
+      "groupHint": "Local/self-hosted OpenAI-compatible"
+    }
+  ],
+  "configSchema": {
+    "type": "object",
+    "additionalProperties": false,
+    "properties": {}
+  }
+}

openclaw/extensions/vllm/package.json

@@ -0,0 +1,15 @@
+{
+  "name": "@openclaw/vllm-provider",
+  "version": "2026.4.20",
+  "private": true,
+  "description": "OpenClaw vLLM provider plugin",
+  "type": "module",
+  "devDependencies": {
+    "@openclaw/plugin-sdk": "workspace:*"
+  },
+  "openclaw": {
+    "extensions": [
+      "./index.ts"
+    ]
+  }
+}

openclaw/extensions/vllm/register.runtime.ts

@@ -0,0 +1,7 @@
+export {
+  buildVllmProvider,
+  VLLM_DEFAULT_API_KEY_ENV_VAR,
+  VLLM_DEFAULT_BASE_URL,
+  VLLM_MODEL_PLACEHOLDER,
+  VLLM_PROVIDER_LABEL,
+} from "./api.js";

openclaw/extensions/vllm/tsconfig.json

@@ -0,0 +1,16 @@
+{
+  "extends": "../tsconfig.package-boundary.base.json",
+  "compilerOptions": {
+    "rootDir": "."
+  },
+  "include": ["./*.ts", "./src/**/*.ts"],
+  "exclude": [
+    "./**/*.test.ts",
+    "./dist/**",
+    "./node_modules/**",
+    "./src/test-support/**",
+    "./src/**/*test-helpers.ts",
+    "./src/**/*test-harness.ts",
+    "./src/**/*test-support.ts"
+  ]
+}