Vendor OpenClaw source as Adolf fork baseline

Adolf is a fork/vendored clone of github.com/openclaw/openclaw (v2026.6.11),
free to diverge. Tree copied sans upstream .git; upstream remote added for
future syncs. Node pinned to 24 (.nvmrc); engines already require >=22.19.
Preserves docs/ARCHITECTURE.md.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01LeqyaxJF2nbRXJtae2kNB2

extensions/firecrawl/web-search-shared.ts

@@ -0,0 +1,66 @@
+// Firecrawl plugin module implements web search shared behavior.
+import {
+  createWebSearchProviderContractFields,
+  enablePluginInConfig,
+  type WebSearchProviderPlugin,
+} from "openclaw/plugin-sdk/provider-web-search-contract";
+
+export const FIRECRAWL_CREDENTIAL_PATH = "plugins.entries.firecrawl.config.webSearch.apiKey";
+export const FIRECRAWL_FETCH_CREDENTIAL_PATH = "plugins.entries.firecrawl.config.webFetch.apiKey";
+
+export function getConfiguredFirecrawlFetchCredentialFallback(config?: {
+  plugins?: { entries?: { firecrawl?: { config?: unknown } } };
+}) {
+  const apiKey = (
+    config?.plugins?.entries?.firecrawl?.config as { webFetch?: { apiKey?: unknown } } | undefined
+  )?.webFetch?.apiKey;
+  return apiKey === undefined
+    ? undefined
+    : {
+        path: FIRECRAWL_FETCH_CREDENTIAL_PATH,
+        value: apiKey,
+      };
+}
+
+export function buildFirecrawlWebSearchProviderBase(): Omit<WebSearchProviderPlugin, "createTool"> {
+  const contractFields = createWebSearchProviderContractFields({
+    credentialPath: FIRECRAWL_CREDENTIAL_PATH,
+    searchCredential: { type: "scoped", scopeId: "firecrawl" },
+    configuredCredential: { pluginId: "firecrawl" },
+  });
+
+  return {
+    id: "firecrawl",
+    label: "Firecrawl Search",
+    hint: "Structured results with optional result scraping",
+    onboardingScopes: ["text-inference"],
+    credentialLabel: "Firecrawl API key",
+    envVars: ["FIRECRAWL_API_KEY"],
+    placeholder: "fc-...",
+    signupUrl: "https://www.firecrawl.dev/",
+    docsUrl: "https://docs.openclaw.ai/tools/firecrawl",
+    autoDetectOrder: 60,
+    credentialPath: FIRECRAWL_CREDENTIAL_PATH,
+    ...contractFields,
+    applySelectionConfig: (config) => {
+      const enabled = enablePluginInConfig(config, "firecrawl");
+      if (!enabled.enabled || enabled.config.tools?.web?.fetch?.provider) {
+        return enabled.config;
+      }
+      return {
+        ...enabled.config,
+        tools: {
+          ...enabled.config.tools,
+          web: {
+            ...enabled.config.tools?.web,
+            fetch: {
+              ...enabled.config.tools?.web?.fetch,
+              provider: "firecrawl",
+            },
+          },
+        },
+      };
+    },
+    getConfiguredCredentialFallback: getConfiguredFirecrawlFetchCredentialFallback,
+  };
+}