@openclaw/firecrawl-plugin 2026.11.2 → 2026.11.3

package/dist/.setup/{firecrawl-client-CMLsufX8.mjs → firecrawl-client--j4MjwgU.mjs}

@@ -1,4 +1,5 @@
 import { resolveSiteName } from "openclaw/plugin-sdk/provider-web-search";
+import { hash } from "node:crypto";
 import { asNonNegativeFiniteNumber, asPositiveFiniteNumber, parseDateStringTimestampMs, parseFiniteNumber, resolveIntegerOption } from "openclaw/plugin-sdk/number-runtime";
 import { ProviderHttpError, readProviderJsonObjectResponse } from "openclaw/plugin-sdk/provider-http";
 import { DEFAULT_CACHE_TTL_MINUTES, markdownToText, normalizeCacheKey, readCache, readResponseText, resolveCacheTtlMs, resolvePositiveTimeoutSeconds, withSelfHostedWebToolsEndpoint, withStrictWebToolsEndpoint, writeCache } from "openclaw/plugin-sdk/provider-web-fetch";
@@ -39,29 +40,19 @@ function resolveConfiguredSecret(value, path, cfg) {
 		normalizeValue: normalizeSecretInput
 	});
 }
-function resolveFirecrawlApiKey(cfg) {
-	const pluginConfig = cfg?.plugins?.entries?.firecrawl?.config;
-	const search = resolveFirecrawlSearchConfig(cfg);
-	const configuredCandidates = [{
-		value: pluginConfig?.webFetch?.apiKey,
-		path: "plugins.entries.firecrawl.config.webFetch.apiKey"
-	}, {
-		value: search?.apiKey,
-		path: "plugins.entries.firecrawl.config.webSearch.apiKey"
-	}];
-	let blockedConfiguredSecret = false;
-	for (const candidate of configuredCandidates) {
-		const resolved = resolveConfiguredSecret(candidate.value, candidate.path, cfg);
-		if (resolved.status === "available") return resolved.value;
-		if (resolved.status === "blocked") blockedConfiguredSecret = true;
-	}
-	if (blockedConfiguredSecret) return;
-	return normalizeSecretInput(process.env[FIRECRAWL_API_KEY_ENV_VAR]) || void 0;
-}
-function resolveFirecrawlBaseUrl(cfg) {
-	const search = resolveFirecrawlSearchConfig(cfg);
-	const fetch = resolveFirecrawlFetchConfig(cfg);
-	return normalizeOptionalString(search?.baseUrl) || normalizeOptionalString(fetch?.baseUrl) || normalizeSecretInput(process.env.FIRECRAWL_BASE_URL) || "https://api.firecrawl.dev";
+function resolveFirecrawlConnection(cfg, scope) {
+	const scopes = {
+		webSearch: resolveFirecrawlSearchConfig(cfg),
+		webFetch: resolveFirecrawlFetchConfig(cfg)
+	};
+	const primary = scopes[scope];
+	const selectedScope = primary?.apiKey === void 0 && !normalizeOptionalString(primary?.baseUrl) ? scope === "webSearch" ? "webFetch" : "webSearch" : scope;
+	const connection = scopes[selectedScope];
+	const resolved = resolveConfiguredSecret(connection?.apiKey, `plugins.entries.firecrawl.config.${selectedScope}.apiKey`, cfg);
+	return {
+		apiKey: resolved.status === "available" ? resolved.value : resolved.status === "blocked" ? void 0 : normalizeSecretInput(process.env[FIRECRAWL_API_KEY_ENV_VAR]) || void 0,
+		baseUrl: normalizeOptionalString(connection?.baseUrl) || normalizeSecretInput(process.env.FIRECRAWL_BASE_URL) || "https://api.firecrawl.dev"
+	};
 }
 function resolveFirecrawlOnlyMainContent(cfg, override) {
 	return asBoolean(override) ?? asBoolean(resolveFirecrawlFetchConfig(cfg)?.onlyMainContent) ?? true;
@@ -240,7 +231,8 @@ async function runFirecrawlSearch(params) {
 	params.signal?.throwIfAborted();
 	const keyless = params.access === "keyless";
 	const providerId = keyless ? "firecrawl-free" : "firecrawl";
-	const apiKey = keyless ? void 0 : resolveFirecrawlApiKey(params.cfg);
+	const connection = resolveFirecrawlConnection(params.cfg, "webSearch");
+	const apiKey = keyless ? void 0 : connection.apiKey;
 	if (!apiKey && !keyless) throw new Error("web_search (firecrawl) needs a Firecrawl API key. Set FIRECRAWL_API_KEY in the Gateway environment, or configure plugins.entries.firecrawl.config.webSearch.apiKey.");
 	const count = resolveIntegerOption(params.count, DEFAULT_SEARCH_COUNT, {
 		min: 1,
@@ -256,10 +248,11 @@ async function runFirecrawlSearch(params) {
 	const tbs = normalizeOptionalString(params.tbs);
 	const location = normalizeOptionalString(params.location);
 	const country = normalizeOptionalString(params.country);
-	const baseUrl = resolveFirecrawlBaseUrl(params.cfg);
+	const baseUrl = connection.baseUrl;
 	const cacheKey = normalizeCacheKey(JSON.stringify({
 		type: "firecrawl-search",
 		provider: providerId,
+		credential: apiKey ? hash("sha256", apiKey, "hex") : void 0,
 		q: params.query,
 		count,
 		baseUrl,
@@ -392,9 +385,8 @@ function parseFirecrawlScrapePayload(params) {
 async function runFirecrawlScrape(params) {
 	params.signal?.throwIfAborted();
 	assertFirecrawlScrapeTargetAllowed(params.url);
-	const apiKey = resolveFirecrawlApiKey(params.cfg);
+	const { apiKey, baseUrl } = resolveFirecrawlConnection(params.cfg, "webFetch");
 	if (!apiKey && params.access !== "keyless") throw new Error("firecrawl_scrape needs a Firecrawl API key. Set FIRECRAWL_API_KEY in the Gateway environment, or configure plugins.entries.firecrawl.config.webFetch.apiKey.");
-	const baseUrl = resolveFirecrawlBaseUrl(params.cfg);
 	const timeoutSeconds = resolveFirecrawlScrapeTimeoutSeconds(params.cfg, params.timeoutSeconds);
 	const onlyMainContent = resolveFirecrawlOnlyMainContent(params.cfg, params.onlyMainContent);
 	const maxAgeMs = resolveFirecrawlMaxAgeMs(params.cfg, params.maxAgeMs);

package/dist/.setup/{firecrawl-fetch-provider-uRENNKri.mjs → firecrawl-fetch-provider-Br32KRpR.mjs}

@@ -51,7 +51,7 @@ const FIRECRAWL_WEB_FETCH_PROVIDER_SHARED = {
 };
 //#endregion
 //#region extensions/firecrawl/src/firecrawl-fetch-provider.ts
-const loadFirecrawlClientModule = createLazyRuntimeModule(() => import("./firecrawl-client-CMLsufX8.mjs").then((n) => n.t));
+const loadFirecrawlClientModule = createLazyRuntimeModule(() => import("./firecrawl-client--j4MjwgU.mjs").then((n) => n.t));
 function createFirecrawlWebFetchProvider() {
 	return {
 		...FIRECRAWL_WEB_FETCH_PROVIDER_SHARED,

package/dist/.setup/{firecrawl-search-provider-CFhWH8gx.mjs → firecrawl-search-provider-D_gyroLO.mjs}

@@ -4,7 +4,7 @@ import { asOptionalRecord } from "openclaw/plugin-sdk/string-coerce-runtime";
 import { createWebSearchProviderContractFields, enablePluginInConfig } from "openclaw/plugin-sdk/provider-web-search-contract";
 //#region extensions/firecrawl/src/firecrawl-search-provider.ts
 const FIRECRAWL_CREDENTIAL_PATH = "plugins.entries.firecrawl.config.webSearch.apiKey";
-const loadFirecrawlClientModule = createLazyRuntimeModule(() => import("./firecrawl-client-CMLsufX8.mjs").then((n) => n.t));
+const loadFirecrawlClientModule = createLazyRuntimeModule(() => import("./firecrawl-client--j4MjwgU.mjs").then((n) => n.t));
 const GenericFirecrawlSearchSchema = {
 	type: "object",
 	properties: {

package/dist/api.js

@@ -1,4 +1,4 @@
-import { n as runFirecrawlScrape } from "./.setup/firecrawl-client-CMLsufX8.mjs";
+import { n as runFirecrawlScrape } from "./.setup/firecrawl-client--j4MjwgU.mjs";
 //#region extensions/firecrawl/api.ts
 async function fetchFirecrawlContent(params) {
 	const cfg = { plugins: { entries: { firecrawl: {

package/dist/index.js

@@ -1,6 +1,6 @@
-import { n as runFirecrawlScrape, r as runFirecrawlSearch } from "./.setup/firecrawl-client-CMLsufX8.mjs";
-import { t as createFirecrawlWebFetchProvider } from "./.setup/firecrawl-fetch-provider-uRENNKri.mjs";
-import { n as createFirecrawlWebSearchProvider, t as createFirecrawlFreeWebSearchProvider } from "./.setup/firecrawl-search-provider-CFhWH8gx.mjs";
+import { n as runFirecrawlScrape, r as runFirecrawlSearch } from "./.setup/firecrawl-client--j4MjwgU.mjs";
+import { t as createFirecrawlWebFetchProvider } from "./.setup/firecrawl-fetch-provider-Br32KRpR.mjs";
+import { n as createFirecrawlWebSearchProvider, t as createFirecrawlFreeWebSearchProvider } from "./.setup/firecrawl-search-provider-D_gyroLO.mjs";
 import { definePluginEntry } from "openclaw/plugin-sdk/plugin-entry";
 import { optionalStringEnum } from "openclaw/plugin-sdk/channel-actions";
 import { jsonResult, readNonNegativeIntegerParam, readPositiveIntegerParam, readStringArrayParam, readStringParam } from "openclaw/plugin-sdk/provider-web-search";

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

@@ -1,3 +1,3 @@
-import { t as createFirecrawlWebFetchProvider } from "./.setup/firecrawl-fetch-provider-uRENNKri.mjs";
+import { t as createFirecrawlWebFetchProvider } from "./.setup/firecrawl-fetch-provider-Br32KRpR.mjs";
 import "./web-fetch-provider.js";
 export { createFirecrawlWebFetchProvider };

package/dist/web-fetch-provider.js

@@ -1,2 +1,2 @@
-import { t as createFirecrawlWebFetchProvider } from "./.setup/firecrawl-fetch-provider-uRENNKri.mjs";
+import { t as createFirecrawlWebFetchProvider } from "./.setup/firecrawl-fetch-provider-Br32KRpR.mjs";
 export { createFirecrawlWebFetchProvider };

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

@@ -1,3 +1,3 @@
-import { n as createFirecrawlWebSearchProvider, t as createFirecrawlFreeWebSearchProvider } from "./.setup/firecrawl-search-provider-CFhWH8gx.mjs";
+import { n as createFirecrawlWebSearchProvider, t as createFirecrawlFreeWebSearchProvider } from "./.setup/firecrawl-search-provider-D_gyroLO.mjs";
 import "./web-search-provider.js";
 export { createFirecrawlFreeWebSearchProvider, createFirecrawlWebSearchProvider };

package/dist/web-search-provider.js

@@ -1,2 +1,2 @@
-import { n as createFirecrawlWebSearchProvider, t as createFirecrawlFreeWebSearchProvider } from "./.setup/firecrawl-search-provider-CFhWH8gx.mjs";
+import { n as createFirecrawlWebSearchProvider, t as createFirecrawlFreeWebSearchProvider } from "./.setup/firecrawl-search-provider-D_gyroLO.mjs";
 export { createFirecrawlFreeWebSearchProvider, createFirecrawlWebSearchProvider };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openclaw/firecrawl-plugin",
-  "version": "2026.11.2",
+  "version": "2026.11.3",
   "description": "OpenClaw Firecrawl plugin.",
   "repository": {
     "type": "git",
@@ -21,10 +21,10 @@
       "minHostVersion": ">=2026.6.8"
     },
     "compat": {
-      "pluginApi": ">=2026.11.2"
+      "pluginApi": ">=2026.11.3"
     },
     "build": {
-      "openclawVersion": "2026.11.2",
+      "openclawVersion": "2026.11.3",
       "bundledDist": false
     },
     "release": {
@@ -43,7 +43,7 @@
     "assets/activity.svg"
   ],
   "peerDependencies": {
-    "openclaw": ">=2026.11.2"
+    "openclaw": ">=2026.11.3"
   },
   "peerDependenciesMeta": {
     "openclaw": {