@openclaw/deepseek-provider 2026.10.10-beta.5 → 2026.11.5-beta.1

package/README.md

@@ -1,6 +1,11 @@
 # OpenClaw DeepSeek Provider
 
-Official OpenClaw provider plugin for DeepSeek.
+Official OpenClaw provider plugin for DeepSeek models and web search.
+
+Select `tools.web.search.provider: "deepseek"` to search with any model. Search
+uses `DEEPSEEK_API_KEY`, a plugin search key, or the configured model-provider key
+while that provider and its models use DeepSeek's API; see the setup documentation
+for credential precedence and query limits.
 
 Install from OpenClaw:
 

package/dist/.setup/{models-D843Tvyg.mjs → openclaw.plugin-CmWHGGeY.mjs}

@@ -1,5 +1,4 @@
-import { buildManifestModelProviderConfig } from "openclaw/plugin-sdk/provider-catalog-shared";
-//#region extensions/deepseek/openclaw.plugin.json
+// extensions/deepseek/openclaw.plugin.json
 var openclaw_plugin_default = {
 	id: "deepseek",
 	categories: ["models"],
@@ -7,7 +6,10 @@ var openclaw_plugin_default = {
 	enabledByDefault: true,
 	providerCatalogEntry: "./provider-discovery.ts",
 	providers: ["deepseek"],
-	contracts: { "usageProviders": ["deepseek"] },
+	contracts: {
+		"usageProviders": ["deepseek"],
+		"webSearchProviders": ["deepseek"]
+	},
 	providerEndpoints: [{
 		"endpointClass": "deepseek-native",
 		"hosts": ["api.deepseek.com"]
@@ -19,6 +21,7 @@ var openclaw_plugin_default = {
 			"baseUrl": "https://api.deepseek.com",
 			"api": "openai-completions",
 			"defaultModel": "deepseek-v4-pro",
+			"family": "deepseek",
 			"models": [
 				{
 					"id": "deepseek-v4-flash",
@@ -125,23 +128,22 @@ var openclaw_plugin_default = {
 	configSchema: {
 		"type": "object",
 		"additionalProperties": false,
-		"properties": {}
-	}
+		"properties": { "webSearch": {
+			"type": "object",
+			"additionalProperties": false,
+			"properties": { "apiKey": { "type": ["string", "object"] } }
+		} }
+	},
+	uiHints: { "webSearch.apiKey": {
+		"label": "DeepSeek Search API Key",
+		"help": "DeepSeek API key. Falls back to DEEPSEEK_API_KEY, then to models.providers.deepseek.apiKey while that provider and its models use https://api.deepseek.com.",
+		"sensitive": true
+	} },
+	configGroups: [{
+		"id": "web-search",
+		"title": "Web search",
+		"order": 10,
+		"properties": ["webSearch"]
+	}]
 };
-//#endregion
-//#region extensions/deepseek/models.ts
-const DEEPSEEK_MANIFEST_CATALOG = openclaw_plugin_default.modelCatalog.providers.deepseek;
-const DEEPSEEK_BASE_URL = DEEPSEEK_MANIFEST_CATALOG.baseUrl;
-const DEEPSEEK_MODEL_CATALOG = buildManifestModelProviderConfig({
-	providerId: "deepseek",
-	catalog: DEEPSEEK_MANIFEST_CATALOG
-}).models.map((model) => Object.assign(model, { api: "openai-completions" }));
-const DEEPSEEK_V4_MODEL_IDS = new Set(DEEPSEEK_MODEL_CATALOG.map((model) => model.id).filter((id) => id === "deepseek-flash" || id.startsWith("deepseek-v4-")));
-function isDeepSeekV4ModelId(modelId) {
-	return DEEPSEEK_V4_MODEL_IDS.has(modelId.toLowerCase());
-}
-function isDeepSeekV4ModelRef(model) {
-	return model.provider === "deepseek" && typeof model.id === "string" && isDeepSeekV4ModelId(model.id);
-}
-//#endregion
-export { openclaw_plugin_default as a, isDeepSeekV4ModelRef as i, DEEPSEEK_MODEL_CATALOG as n, isDeepSeekV4ModelId as r, DEEPSEEK_BASE_URL as t };
+export { openclaw_plugin_default as t };

package/dist/.source-module-urls/4b346188900dd8d01f5d5f8baca1f9af648850415a0a1346f45749910375d843.json

@@ -0,0 +1 @@
+{"version":3,"entries":[{"output":"api.js","source":"extensions/deepseek/api.ts"},{"output":"index.js","source":"extensions/deepseek/index.ts"},{"output":"model-credential.js","source":"extensions/deepseek/model-credential.ts"},{"output":"models.js","source":"extensions/deepseek/models.ts"},{"output":"onboard.js","source":"extensions/deepseek/onboard.ts"},{"output":"provider-catalog.js","source":"extensions/deepseek/provider-catalog.ts"},{"output":"provider-discovery.js","source":"extensions/deepseek/provider-discovery.ts"},{"output":"provider-policy-api.js","source":"extensions/deepseek/provider-policy-api.ts"},{"output":"stream.js","source":"extensions/deepseek/stream.ts"},{"output":"thinking.js","source":"extensions/deepseek/thinking.ts"},{"output":"web-search-contract-api.js","source":"extensions/deepseek/web-search-contract-api.ts"},{"output":"web-search-provider.js","source":"extensions/deepseek/web-search-provider.ts"},{"output":"web-search-provider.runtime.js","source":"extensions/deepseek/web-search-provider.runtime.ts"}],"chunks":[{"output":".setup/openclaw.plugin-CmWHGGeY.mjs","sha256":"5d49086775c117889c0da60f93e8059571cec5502f77c5bc87b2e694ee1d6bab","facadeSource":null,"sources":["extensions/deepseek/openclaw.plugin.json"]},{"output":"api.js","sha256":"e2750717df20042eb482577777c8d2cfbf8122334b1bed3185ffa95fe09aba4d","facadeSource":"extensions/deepseek/api.ts","sources":[]},{"output":"index.js","sha256":"a51eb7227b1e7c35276afe38368edc5c588840d35029f08bfcf49b3972f8fae1","facadeSource":"extensions/deepseek/index.ts","sources":["extensions/deepseek/index.ts"]},{"output":"model-credential.js","sha256":"9200c0f610a1d388a5db5ee7fe0edf71e124b14bd3b04fa5d16fa06bda2a7cf7","facadeSource":"extensions/deepseek/model-credential.ts","sources":["extensions/deepseek/model-credential.ts"]},{"output":"models.js","sha256":"2e0735f3b071ae101a17978927ca93b48a46815d9742baac05f17a8463245ec0","facadeSource":"extensions/deepseek/models.ts","sources":["extensions/deepseek/models.ts"]},{"output":"onboard.js","sha256":"c83ac3ea1688857053f642029ef7c640a9279ea1c96fad257c4b8df35dc879fd","facadeSource":"extensions/deepseek/onboard.ts","sources":["extensions/deepseek/onboard.ts"]},{"output":"provider-catalog.js","sha256":"1f3ffb0852fe10e5a9e8a2ff3870dd5ce21f7089107274bb94c4fb50c8107a7e","facadeSource":"extensions/deepseek/provider-catalog.ts","sources":["extensions/deepseek/provider-catalog.ts"]},{"output":"provider-discovery.js","sha256":"37031a296833f55692f3513e0ca17a0f47529e1cb0f08e9a1033112447456209","facadeSource":"extensions/deepseek/provider-discovery.ts","sources":["extensions/deepseek/provider-discovery.ts"]},{"output":"provider-policy-api.js","sha256":"ea3b8633424ee63de51d1997cae90b80d5d2a6ed5ae7e33b46d8e9eb2843f7ba","facadeSource":"extensions/deepseek/provider-policy-api.ts","sources":["extensions/deepseek/provider-policy-api.ts"]},{"output":"stream.js","sha256":"3f59495c0d02b0efd82396f4d37ec114055086d33144bececbef52c5dd21cc39","facadeSource":"extensions/deepseek/stream.ts","sources":["extensions/deepseek/stream.ts"]},{"output":"thinking.js","sha256":"c2c4a0237dc245e08b6b39913b8c60487c12b2cc42c89b33e7c9981618b4d3bc","facadeSource":"extensions/deepseek/thinking.ts","sources":["extensions/deepseek/thinking.ts"]},{"output":"web-search-contract-api.js","sha256":"f774674c8df1ea6c885c38d64ed270d6c666d877b31d75c50957535f5af80455","facadeSource":"extensions/deepseek/web-search-contract-api.ts","sources":[]},{"output":"web-search-provider.js","sha256":"1006927ad948b6c3ddea34697e82e878a909ffcccd625e123d308231411128b4","facadeSource":"extensions/deepseek/web-search-provider.ts","sources":["extensions/deepseek/web-search-provider.ts"]},{"output":"web-search-provider.runtime.js","sha256":"ca516c5e0e7b1028c8f0f8b0ffba88c0fa0aed814e5c126a51f019e9c5469bf3","facadeSource":"extensions/deepseek/web-search-provider.runtime.ts","sources":["extensions/deepseek/web-search-provider.runtime.ts"]}],"unrenderedSources":["extensions/deepseek/api.ts","extensions/deepseek/web-search-contract-api.ts"]}

package/dist/api.js

@@ -1,4 +1,4 @@
-import { n as DEEPSEEK_MODEL_CATALOG, t as DEEPSEEK_BASE_URL } from "./.setup/models-D843Tvyg.mjs";
+import { DEEPSEEK_BASE_URL, DEEPSEEK_MODEL_CATALOG } from "./models.js";
 import { buildDeepSeekProvider } from "./provider-catalog.js";
 import { createDeepSeekV4ThinkingWrapper } from "./stream.js";
 export { DEEPSEEK_BASE_URL, DEEPSEEK_MODEL_CATALOG, buildDeepSeekProvider, createDeepSeekV4ThinkingWrapper };

package/dist/index.js

@@ -1,20 +1,25 @@
-import { a as openclaw_plugin_default } from "./.setup/models-D843Tvyg.mjs";
+import { t as openclaw_plugin_default } from "./.setup/openclaw.plugin-CmWHGGeY.mjs";
 import { applyDeepSeekConfig } from "./onboard.js";
 import { buildDeepSeekProvider } from "./provider-catalog.js";
 import { createDeepSeekV4ThinkingWrapper } from "./stream.js";
 import { resolveDeepSeekV4ThinkingProfile } from "./thinking.js";
+import { createDeepSeekWebSearchProvider } from "./web-search-provider.js";
 import { readConfiguredProviderCatalogEntries } from "openclaw/plugin-sdk/provider-catalog-shared";
 import { defineSingleProviderPluginEntry } from "openclaw/plugin-sdk/provider-entry";
 import { buildProviderReplayFamilyHooks } from "openclaw/plugin-sdk/provider-model-shared";
 import { buildProviderToolCompatFamilyHooks } from "openclaw/plugin-sdk/provider-tools";
-import { fetchDeepSeekUsage } from "openclaw/plugin-sdk/provider-usage";
-//#region extensions/deepseek/index.ts
+import { fetchDeepSeekUsage, resolveProviderUsageApiKeyAuth } from "openclaw/plugin-sdk/provider-usage";
+// extensions/deepseek/index.ts
 const PROVIDER_ID = "deepseek";
 var deepseek_default = defineSingleProviderPluginEntry({
 	id: PROVIDER_ID,
 	name: "DeepSeek Provider",
 	description: "Bundled DeepSeek provider plugin",
 	manifest: openclaw_plugin_default,
+	register(api) {
+		api.registerReload({ hotPrefixes: ["plugins.entries.deepseek.config.webSearch.apiKey"] });
+		api.registerWebSearchProvider(createDeepSeekWebSearchProvider());
+	},
 	provider: {
 		label: "DeepSeek",
 		docsPath: "/providers/deepseek",
@@ -38,12 +43,8 @@ var deepseek_default = defineSingleProviderPluginEntry({
 		wrapStreamFn: (ctx) => createDeepSeekV4ThinkingWrapper(ctx.streamFn, ctx.thinkingLevel),
 		resolveThinkingProfile: ({ modelId }) => resolveDeepSeekV4ThinkingProfile(modelId),
 		isModernModelRef: ({ modelId }) => Boolean(resolveDeepSeekV4ThinkingProfile(modelId)),
-		resolveUsageAuth: async (ctx) => {
-			const apiKey = (await ctx.resolveApiKeyCandidatesFromConfigAndStore?.({ envDirect: [ctx.env.DEEPSEEK_API_KEY] }))?.[0];
-			return apiKey ? { token: apiKey } : null;
-		},
+		resolveUsageAuth: (ctx) => resolveProviderUsageApiKeyAuth(ctx, [ctx.env.DEEPSEEK_API_KEY]),
 		fetchUsageSnapshot: async (ctx) => await fetchDeepSeekUsage(ctx.token, ctx.timeoutMs, ctx.fetchFn)
 	}
 });
-//#endregion
 export { deepseek_default as default };

package/dist/model-credential.js

@@ -0,0 +1,22 @@
+import { t as openclaw_plugin_default } from "./.setup/openclaw.plugin-CmWHGGeY.mjs";
+import { normalizeProviderId } from "openclaw/plugin-sdk/provider-model-shared";
+// extensions/deepseek/model-credential.ts
+const DEEPSEEK_API_ORIGIN = new URL(openclaw_plugin_default.modelCatalog.providers.deepseek.baseUrl).origin;
+function isDeepSeekApiUrl(value) {
+	const baseUrl = value?.trim();
+	if (!baseUrl) return true;
+	const url = URL.parse(baseUrl);
+	if (!url || url.protocol !== "https:" || url.username || url.password) return false;
+	url.hostname = url.hostname.replace(/\.$/, "");
+	return url.origin === DEEPSEEK_API_ORIGIN;
+}
+/** Raw model-provider key (SecretRefs intact) when DeepSeek search may reuse it. */
+function resolveDeepSeekModelKeyFallback(config) {
+	const value = config?.models?.providers?.deepseek?.apiKey;
+	if (value === void 0) return;
+	return Object.entries(config?.models?.providers ?? {}).filter(([id]) => normalizeProviderId(id) === "deepseek").every(([, entry]) => isDeepSeekApiUrl(entry.baseUrl) && (entry.models ?? []).every((model) => isDeepSeekApiUrl(model.baseUrl))) ? {
+		path: "models.providers.deepseek.apiKey",
+		value
+	} : void 0;
+}
+export { resolveDeepSeekModelKeyFallback };

package/dist/models.js

@@ -1 +1,17 @@
-export { t as DEEPSEEK_BASE_URL, n as DEEPSEEK_MODEL_CATALOG, r as isDeepSeekV4ModelId, i as isDeepSeekV4ModelRef } from "./.setup/models-D843Tvyg.mjs";
+import { t as openclaw_plugin_default } from "./.setup/openclaw.plugin-CmWHGGeY.mjs";
+import { buildManifestModelProviderConfig } from "openclaw/plugin-sdk/provider-catalog-shared";
+// extensions/deepseek/models.ts
+const DEEPSEEK_MANIFEST_CATALOG = openclaw_plugin_default.modelCatalog.providers.deepseek;
+const DEEPSEEK_BASE_URL = DEEPSEEK_MANIFEST_CATALOG.baseUrl;
+const DEEPSEEK_MODEL_CATALOG = buildManifestModelProviderConfig({
+	providerId: "deepseek",
+	catalog: DEEPSEEK_MANIFEST_CATALOG
+}).models.map((model) => Object.assign(model, { api: "openai-completions" }));
+const DEEPSEEK_V4_MODEL_IDS = new Set(DEEPSEEK_MODEL_CATALOG.map((model) => model.id).filter((id) => id === "deepseek-flash" || id.startsWith("deepseek-v4-")));
+function isDeepSeekV4ModelId(modelId) {
+	return DEEPSEEK_V4_MODEL_IDS.has(modelId.toLowerCase());
+}
+function isDeepSeekV4ModelRef(model) {
+	return model.provider === "deepseek" && isDeepSeekV4ModelId(model.id);
+}
+export { DEEPSEEK_BASE_URL, DEEPSEEK_MODEL_CATALOG, isDeepSeekV4ModelId, isDeepSeekV4ModelRef };

package/dist/onboard.js

@@ -1,7 +1,8 @@
-import { a as openclaw_plugin_default, n as DEEPSEEK_MODEL_CATALOG, t as DEEPSEEK_BASE_URL } from "./.setup/models-D843Tvyg.mjs";
+import { t as openclaw_plugin_default } from "./.setup/openclaw.plugin-CmWHGGeY.mjs";
+import { DEEPSEEK_BASE_URL, DEEPSEEK_MODEL_CATALOG } from "./models.js";
 import { readManifestProviderDefaultModelRef } from "openclaw/plugin-sdk/provider-catalog-shared";
 import { createProviderConnectionPresetAppliers } from "openclaw/plugin-sdk/provider-onboard";
-//#region extensions/deepseek/onboard.ts
+// extensions/deepseek/onboard.ts
 const DEEPSEEK_DEFAULT_MODEL_REF = readManifestProviderDefaultModelRef(openclaw_plugin_default, "deepseek");
 const { applyConfig: applyDeepSeekConfig } = createProviderConnectionPresetAppliers({
 	primaryModelRef: DEEPSEEK_DEFAULT_MODEL_REF,
@@ -16,5 +17,4 @@ const { applyConfig: applyDeepSeekConfig } = createProviderConnectionPresetAppli
 		}]
 	})
 });
-//#endregion
 export { applyDeepSeekConfig };

package/dist/provider-catalog.js

@@ -1,11 +1,10 @@
-import { n as DEEPSEEK_MODEL_CATALOG, t as DEEPSEEK_BASE_URL } from "./.setup/models-D843Tvyg.mjs";
-//#region extensions/deepseek/provider-catalog.ts
+import { DEEPSEEK_BASE_URL, DEEPSEEK_MODEL_CATALOG } from "./models.js";
+// extensions/deepseek/provider-catalog.ts
 function buildDeepSeekProvider() {
 	return {
 		baseUrl: DEEPSEEK_BASE_URL,
 		api: "openai-completions",
-		models: structuredClone(DEEPSEEK_MODEL_CATALOG)
+		models: DEEPSEEK_MODEL_CATALOG
 	};
 }
-//#endregion
 export { buildDeepSeekProvider };

package/dist/provider-discovery.js

@@ -1,5 +1,5 @@
 import { buildDeepSeekProvider } from "./provider-catalog.js";
-//#region extensions/deepseek/provider-discovery.ts
+// extensions/deepseek/provider-discovery.ts
 const deepSeekProviderDiscovery = {
 	id: "deepseek",
 	label: "DeepSeek",
@@ -10,5 +10,4 @@ const deepSeekProviderDiscovery = {
 		run: async () => ({ provider: buildDeepSeekProvider() })
 	}
 };
-//#endregion
 export { deepSeekProviderDiscovery as default };

package/dist/provider-policy-api.js

@@ -1,6 +1,6 @@
-import { n as DEEPSEEK_MODEL_CATALOG } from "./.setup/models-D843Tvyg.mjs";
+import { DEEPSEEK_MODEL_CATALOG } from "./models.js";
 import { resolveDeepSeekV4ThinkingProfile } from "./thinking.js";
-//#region extensions/deepseek/provider-policy-api.ts
+// extensions/deepseek/provider-policy-api.ts
 const PREVIOUS_BUNDLED_METADATA = {
 	"deepseek-v4-flash": {
 		contextWindow: 1e6,
@@ -21,34 +21,8 @@ const PREVIOUS_BUNDLED_METADATA = {
 			cacheRead: .145,
 			cacheWrite: 0
 		}
-	},
-	"deepseek-chat": {
-		contextWindow: 131072,
-		maxTokens: 8192,
-		cost: {
-			input: .28,
-			output: .42,
-			cacheRead: .028,
-			cacheWrite: 0
-		}
-	},
-	"deepseek-reasoner": {
-		contextWindow: 131072,
-		maxTokens: 65536,
-		cost: {
-			input: .28,
-			output: .42,
-			cacheRead: .028,
-			cacheWrite: 0
-		}
 	}
 };
-const ZERO_COST = {
-	input: 0,
-	output: 0,
-	cacheRead: 0,
-	cacheWrite: 0
-};
 function isPositiveNumber(value) {
 	return typeof value === "number" && Number.isFinite(value) && value > 0;
 }
@@ -63,12 +37,9 @@ function hasSameCost(left, right) {
 	if (Object.hasOwn(cost, "tieredPricing")) return false;
 	return cost.input === right.input && cost.output === right.output && cost.cacheRead === right.cacheRead && cost.cacheWrite === right.cacheWrite;
 }
-function isShippedZeroCostAliasSnapshot(raw, previous) {
-	return (raw.id === "deepseek-chat" || raw.id === "deepseek-reasoner") && raw.contextWindow === previous?.contextWindow && raw.maxTokens === previous?.maxTokens && hasSameCost(raw.cost, ZERO_COST);
-}
 function isPreviousBundledMetadataSnapshot(raw, previous) {
 	if (!previous) return false;
-	return raw.contextWindow === previous.contextWindow && raw.maxTokens === previous.maxTokens && (hasSameCost(raw.cost, previous.cost) || isShippedZeroCostAliasSnapshot(raw, previous));
+	return raw.contextWindow === previous.contextWindow && raw.maxTokens === previous.maxTokens && hasSameCost(raw.cost, previous.cost);
 }
 /**
 * Provider policy surface for DeepSeek.
@@ -104,5 +75,4 @@ function normalizeConfig(params) {
 function resolveThinkingProfile(params) {
 	return params.provider.trim().toLowerCase() === "deepseek" ? resolveDeepSeekV4ThinkingProfile(params.modelId) : null;
 }
-//#endregion
 export { normalizeConfig, resolveThinkingProfile };

package/dist/stream.js

@@ -1,6 +1,6 @@
-import { i as isDeepSeekV4ModelRef } from "./.setup/models-D843Tvyg.mjs";
+import { isDeepSeekV4ModelRef } from "./models.js";
 import { createDeepSeekV4OpenAICompatibleThinkingWrapper } from "openclaw/plugin-sdk/provider-stream-shared";
-//#region extensions/deepseek/stream.ts
+// extensions/deepseek/stream.ts
 function createDeepSeekV4ThinkingWrapper(baseStreamFn, thinkingLevel) {
 	return createDeepSeekV4OpenAICompatibleThinkingWrapper({
 		baseStreamFn,
@@ -8,5 +8,4 @@ function createDeepSeekV4ThinkingWrapper(baseStreamFn, thinkingLevel) {
 		shouldPatchModel: isDeepSeekV4ModelRef
 	});
 }
-//#endregion
 export { createDeepSeekV4ThinkingWrapper };

package/dist/thinking.js

@@ -1,5 +1,5 @@
-import { r as isDeepSeekV4ModelId } from "./.setup/models-D843Tvyg.mjs";
-//#region extensions/deepseek/thinking.ts
+import { isDeepSeekV4ModelId } from "./models.js";
+// extensions/deepseek/thinking.ts
 const DEEPSEEK_V4_THINKING_PROFILE = {
 	levels: [
 		"off",
@@ -15,5 +15,4 @@ const DEEPSEEK_V4_THINKING_PROFILE = {
 function resolveDeepSeekV4ThinkingProfile(modelId) {
 	return isDeepSeekV4ModelId(modelId) ? DEEPSEEK_V4_THINKING_PROFILE : void 0;
 }
-//#endregion
 export { resolveDeepSeekV4ThinkingProfile };

package/dist/web-search-contract-api.js

@@ -0,0 +1 @@
+export { createDeepSeekWebSearchProvider } from "./web-search-provider.js";

package/dist/web-search-provider.js

@@ -0,0 +1,58 @@
+import { resolveDeepSeekModelKeyFallback } from "./model-credential.js";
+import { createLazyRuntimeModule } from "openclaw/plugin-sdk/lazy-runtime";
+import { createWebSearchProviderContractFields } from "openclaw/plugin-sdk/provider-web-search-contract";
+// extensions/deepseek/web-search-provider.ts
+const CREDENTIAL_PATH = "plugins.entries.deepseek.config.webSearch.apiKey";
+const loadRuntime = createLazyRuntimeModule(() => import("./web-search-provider.runtime.js"));
+function createDeepSeekWebSearchProvider() {
+	return {
+		id: "deepseek",
+		label: "DeepSeek",
+		hint: "Structured search results from DeepSeek's search engine",
+		onboardingScopes: ["text-inference"],
+		credentialLabel: "DeepSeek API key",
+		envVars: ["DEEPSEEK_API_KEY"],
+		placeholder: "sk-...",
+		signupUrl: "https://platform.deepseek.com/api_keys",
+		docsUrl: "https://docs.openclaw.ai/providers/deepseek#web-search",
+		autoDetectOrder: 80,
+		credentialPath: CREDENTIAL_PATH,
+		...createWebSearchProviderContractFields({
+			credentialPath: CREDENTIAL_PATH,
+			searchCredential: {
+				type: "scoped",
+				scopeId: "deepseek"
+			},
+			configuredCredential: { pluginId: "deepseek" },
+			selectionPluginId: "deepseek"
+		}),
+		getConfiguredCredentialFallback: resolveDeepSeekModelKeyFallback,
+		createTool: (ctx) => ({
+			description: "Search the web using DeepSeek. Returns titles, URLs, and model-oriented summaries. Queries support site:, -site:, lang:, after:, before:, and quoted phrases; maximum 128 Unicode characters.",
+			parameters: {
+				type: "object",
+				required: ["query"],
+				properties: {
+					query: {
+						type: "string",
+						minLength: 1,
+						maxLength: 128,
+						description: "Search query, including any search operators."
+					},
+					count: {
+						type: "integer",
+						minimum: 1,
+						maximum: 10,
+						description: "Number of results (1-10; default 5)."
+					}
+				}
+			},
+			execute: async (args, context) => {
+				context?.signal?.throwIfAborted();
+				const { executeDeepSeekSearch } = await loadRuntime();
+				return executeDeepSeekSearch(ctx, args, context?.signal);
+			}
+		})
+	};
+}
+export { createDeepSeekWebSearchProvider };

package/dist/web-search-provider.runtime.js

@@ -0,0 +1,98 @@
+import { resolveDeepSeekModelKeyFallback } from "./model-credential.js";
+import { createHash } from "node:crypto";
+import { readProviderJsonObjectResponse } from "openclaw/plugin-sdk/provider-http";
+import { DEFAULT_SEARCH_COUNT, MAX_SEARCH_COUNT, buildSearchCacheKey, mergeScopedSearchConfig, postTrustedWebToolsJson, readCachedSearchPayload, readConfiguredSecretString, readPositiveIntegerParam, readProviderEnvValue, readStringParam, resolveProviderWebSearchPluginConfig, resolveSearchCacheTtlMs, resolveSearchCount, resolveSearchTimeoutSeconds, writeCachedSearchPayload } from "openclaw/plugin-sdk/provider-web-search";
+import { asNonArrayRecord, normalizeOptionalString } from "openclaw/plugin-sdk/string-coerce-runtime";
+// extensions/deepseek/web-search-provider.runtime.ts
+const SEARCH_URL = "https://api.deepseek.com/v1/tools/search";
+async function executeDeepSeekSearch(ctx, args, signal) {
+	signal?.throwIfAborted();
+	const query = readStringParam(args, "query", { required: true });
+	if (Array.from(query).length > 128) return {
+		error: "invalid_query",
+		message: "DeepSeek search queries must contain 1 to 128 Unicode characters. Shorten the query; it has not been sent."
+	};
+	const unsupported = [
+		"country",
+		"language",
+		"freshness",
+		"date_after",
+		"date_before",
+		"search_lang",
+		"ui_lang",
+		"domain_filter",
+		"max_tokens",
+		"max_tokens_per_page"
+	].find((key) => args[key] !== void 0);
+	if (unsupported) return {
+		error: "unsupported_filter",
+		message: `DeepSeek does not support the ${unsupported} parameter. Put site:, -site:, lang:, after:, or before: operators directly in query instead.`
+	};
+	const searchConfig = mergeScopedSearchConfig(ctx.searchConfig, "deepseek", resolveProviderWebSearchPluginConfig(ctx.config, "deepseek"));
+	const deepseek = asNonArrayRecord(searchConfig?.deepseek);
+	const modelKey = resolveDeepSeekModelKeyFallback(ctx.config);
+	const apiKey = readConfiguredSecretString(deepseek.apiKey, "plugins.entries.deepseek.config.webSearch.apiKey") ?? readProviderEnvValue(["DEEPSEEK_API_KEY"]) ?? (modelKey ? readConfiguredSecretString(modelKey.value, modelKey.path) : void 0);
+	if (!apiKey) return {
+		error: "missing_deepseek_api_key",
+		message: "web_search (deepseek) needs a DeepSeek API key. Configure plugins.entries.deepseek.config.webSearch.apiKey or set DEEPSEEK_API_KEY; for chat, DEEPSEEK_API_KEY outranks models.providers.deepseek.apiKey unless models.providers.deepseek.auth is \"api-key\". models.providers.deepseek.apiKey is reused only while that provider and its models use https://api.deepseek.com. Use web_fetch for a specific URL if you do not want to configure search.",
+		docs: "https://docs.openclaw.ai/providers/deepseek#web-search"
+	};
+	const count = resolveSearchCount(readPositiveIntegerParam(args, "count", {
+		max: MAX_SEARCH_COUNT,
+		message: "count must be an integer from 1 to 10."
+	}) ?? searchConfig?.maxResults, DEFAULT_SEARCH_COUNT);
+	const credentialScope = createHash("sha256").update(apiKey).digest("hex");
+	const cacheKey = buildSearchCacheKey(["deepseek", JSON.stringify([
+		query,
+		count,
+		credentialScope
+	])]);
+	const ttlMs = resolveSearchCacheTtlMs(searchConfig);
+	const cached = readCachedSearchPayload(cacheKey, ttlMs);
+	if (cached) return cached;
+	const start = Date.now();
+	let omittedResults = false;
+	const results = await postTrustedWebToolsJson({
+		url: SEARCH_URL,
+		apiKey,
+		timeoutSeconds: resolveSearchTimeoutSeconds(searchConfig),
+		signal,
+		body: {
+			query,
+			count,
+			need_content: false
+		},
+		errorLabel: "DeepSeek"
+	}, async (response) => {
+		const data = await readProviderJsonObjectResponse(response, "DeepSeek API error");
+		if (!Array.isArray(data.results)) throw new Error("DeepSeek API error: malformed JSON response");
+		return data.results.slice(0, count).flatMap((entry) => {
+			const result = asNonArrayRecord(entry);
+			const url = normalizeOptionalString(result.url);
+			const parsed = url && url.length <= 2048 ? URL.parse(url) : null;
+			if (!parsed || !["http:", "https:"].includes(parsed.protocol) || parsed.href.length > 2048) {
+				omittedResults = true;
+				return [];
+			}
+			return [{
+				title: normalizeOptionalString(result.title) ?? "",
+				url: parsed.href,
+				snippet: normalizeOptionalString(result.summary) ?? normalizeOptionalString(result.snippet),
+				published: normalizeOptionalString(result.date),
+				siteName: normalizeOptionalString(result.site_name)
+			}];
+		});
+	});
+	signal?.throwIfAborted();
+	const payload = {
+		query,
+		provider: "deepseek",
+		count: results.length,
+		results,
+		tookMs: Date.now() - start,
+		...omittedResults ? { truncated: true } : {}
+	};
+	writeCachedSearchPayload(cacheKey, payload, ttlMs);
+	return payload;
+}
+export { executeDeepSeekSearch };

package/openclaw.plugin.json

@@ -14,6 +14,9 @@
   "contracts": {
     "usageProviders": [
       "deepseek"
+    ],
+    "webSearchProviders": [
+      "deepseek"
     ]
   },
   "providerEndpoints": [
@@ -40,6 +43,7 @@
         "baseUrl": "https://api.deepseek.com",
         "api": "openai-completions",
         "defaultModel": "deepseek-v4-pro",
+        "family": "deepseek",
         "models": [
           {
             "id": "deepseek-v4-flash",
@@ -167,6 +171,36 @@
   "configSchema": {
     "type": "object",
     "additionalProperties": false,
-    "properties": {}
-  }
+    "properties": {
+      "webSearch": {
+        "type": "object",
+        "additionalProperties": false,
+        "properties": {
+          "apiKey": {
+            "type": [
+              "string",
+              "object"
+            ]
+          }
+        }
+      }
+    }
+  },
+  "uiHints": {
+    "webSearch.apiKey": {
+      "label": "DeepSeek Search API Key",
+      "help": "DeepSeek API key. Falls back to DEEPSEEK_API_KEY, then to models.providers.deepseek.apiKey while that provider and its models use https://api.deepseek.com.",
+      "sensitive": true
+    }
+  },
+  "configGroups": [
+    {
+      "id": "web-search",
+      "title": "Web search",
+      "order": 10,
+      "properties": [
+        "webSearch"
+      ]
+    }
+  ]
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openclaw/deepseek-provider",
-  "version": "2026.10.10-beta.5",
+  "version": "2026.11.5-beta.1",
   "description": "OpenClaw DeepSeek provider plugin.",
   "repository": {
     "type": "git",
@@ -18,10 +18,10 @@
       "minHostVersion": ">=2026.6.8"
     },
     "compat": {
-      "pluginApi": ">=2026.10.10-beta.5"
+      "pluginApi": ">=2026.11.5-beta.1"
     },
     "build": {
-      "openclawVersion": "2026.10.10-beta.5",
+      "openclawVersion": "2026.11.5-beta.1",
       "bundledDist": false
     },
     "release": {
@@ -40,7 +40,7 @@
     "assets/activity.svg"
   ],
   "peerDependencies": {
-    "openclaw": ">=2026.10.10-beta.5"
+    "openclaw": ">=2026.11.5-beta.1"
   },
   "peerDependenciesMeta": {
     "openclaw": {

package/dist/.source-module-urls/711aaf42931af9b0593c1c7a68146b3f73c995a5d94b804ef8cfffbf23f39d1f.json

@@ -1 +0,0 @@
-{"version":3,"entries":[{"output":"api.js","source":"extensions/deepseek/api.ts"},{"output":"index.js","source":"extensions/deepseek/index.ts"},{"output":"models.js","source":"extensions/deepseek/models.ts"},{"output":"onboard.js","source":"extensions/deepseek/onboard.ts"},{"output":"provider-catalog.js","source":"extensions/deepseek/provider-catalog.ts"},{"output":"provider-discovery.js","source":"extensions/deepseek/provider-discovery.ts"},{"output":"provider-policy-api.js","source":"extensions/deepseek/provider-policy-api.ts"},{"output":"stream.js","source":"extensions/deepseek/stream.ts"},{"output":"thinking.js","source":"extensions/deepseek/thinking.ts"}],"chunks":[{"output":".setup/models-D843Tvyg.mjs","sha256":"d5b24405ea7091d1fa59357cdce41dfd848289e65f14bb94de2b9ffac5d68f83","facadeSource":null,"sources":["extensions/deepseek/models.ts","extensions/deepseek/openclaw.plugin.json"]},{"output":"api.js","sha256":"c366bae61e81cf65942f8dce7aff9fb544a8ecbea3472c344645b5357a498373","facadeSource":"extensions/deepseek/api.ts","sources":[]},{"output":"index.js","sha256":"ccbd617a48cd055dfe5ae365c45059ca76842dc292c09138d29257bc024dcfef","facadeSource":"extensions/deepseek/index.ts","sources":["extensions/deepseek/index.ts"]},{"output":"models.js","sha256":"cca4a1e221c85a76e59c94a0c8169f24c45269c45203ab9192c8d93a9633b06e","facadeSource":"extensions/deepseek/models.ts","sources":[]},{"output":"onboard.js","sha256":"c2ae5b3ad3b1238cbcdc532aadb80232e98b756694592229272dcd2fb7a1c22f","facadeSource":"extensions/deepseek/onboard.ts","sources":["extensions/deepseek/onboard.ts"]},{"output":"provider-catalog.js","sha256":"da71b33a1eac62d9ab3699ec3412dee16759597e997ddd589fe241441dbb8b26","facadeSource":"extensions/deepseek/provider-catalog.ts","sources":["extensions/deepseek/provider-catalog.ts"]},{"output":"provider-discovery.js","sha256":"b92bb7dbb5768d5bbb65aa5c699573615f8da532e51229175f6eb921c3e8c010","facadeSource":"extensions/deepseek/provider-discovery.ts","sources":["extensions/deepseek/provider-discovery.ts"]},{"output":"provider-policy-api.js","sha256":"2c285c22023e46d95efd367d06215189a130f67b9e89c9fd678f9cf8afd58b84","facadeSource":"extensions/deepseek/provider-policy-api.ts","sources":["extensions/deepseek/provider-policy-api.ts"]},{"output":"stream.js","sha256":"875ec93067872ae4c08dffe061628b70c0425d71f6af51db4a592dfc1924ef67","facadeSource":"extensions/deepseek/stream.ts","sources":["extensions/deepseek/stream.ts"]},{"output":"thinking.js","sha256":"f8cf8a8e19e51a51330b38eb773db7ac8deb7493fdbb3cd4da7016f6672f81f5","facadeSource":"extensions/deepseek/thinking.ts","sources":["extensions/deepseek/thinking.ts"]}],"unrenderedSources":["extensions/deepseek/api.ts"]}