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/qianfan/README.md

@@ -0,0 +1,12 @@
+# OpenClaw Qianfan Provider
+
+Official OpenClaw provider plugin for Qianfan.
+
+Install from OpenClaw:
+
+```bash
+openclaw plugins install @openclaw/qianfan-provider
+openclaw gateway restart
+```
+
+See <https://docs.openclaw.ai/providers/qianfan> for setup and configuration.

extensions/qianfan/api.ts

@@ -0,0 +1,7 @@
+// Qianfan API module exposes the plugin public contract.
+export {
+  QIANFAN_BASE_URL,
+  QIANFAN_DEFAULT_MODEL_ID,
+  buildQianfanProvider,
+} from "./provider-catalog.js";
+export { QIANFAN_DEFAULT_MODEL_REF } from "./onboard.js";

extensions/qianfan/index.test.ts

@@ -0,0 +1,134 @@
+// Qianfan tests cover index plugin behavior.
+import {
+  registerSingleProviderPlugin,
+  resolveProviderPluginChoice,
+} from "openclaw/plugin-sdk/plugin-test-runtime";
+import { resolveAgentModelPrimaryValue } from "openclaw/plugin-sdk/provider-onboard";
+import { describe, expect, it } from "vitest";
+import { runSingleProviderCatalog } from "../test-support/provider-model-test-helpers.js";
+import qianfanPlugin from "./index.js";
+import {
+  applyQianfanConfig,
+  applyQianfanProviderConfig,
+  QIANFAN_DEFAULT_MODEL_REF,
+} from "./onboard.js";
+
+function expectRecord<T>(value: T | null | undefined, label: string): NonNullable<T> {
+  if (!value) {
+    throw new Error(`Expected ${label}`);
+  }
+  return value;
+}
+
+describe("qianfan provider plugin", () => {
+  it("registers Qianfan with api-key auth wizard metadata", async () => {
+    const provider = await registerSingleProviderPlugin(qianfanPlugin);
+    const resolved = resolveProviderPluginChoice({
+      providers: [provider],
+      choice: "qianfan-api-key",
+    });
+
+    expect(provider.id).toBe("qianfan");
+    expect(provider.label).toBe("Qianfan");
+    expect(provider.docsPath).toBe("/providers/qianfan");
+    expect(provider.envVars).toEqual(["QIANFAN_API_KEY"]);
+    expect(provider.auth).toHaveLength(1);
+    const resolvedChoice = expectRecord(resolved, "Qianfan provider choice");
+    expect({
+      providerId: resolvedChoice.provider.id,
+      methodId: resolvedChoice.method.id,
+    }).toEqual({
+      providerId: "qianfan",
+      methodId: "api-key",
+    });
+  });
+
+  it("builds the static Qianfan model catalog", async () => {
+    const provider = await registerSingleProviderPlugin(qianfanPlugin);
+    const catalogProvider = await runSingleProviderCatalog(provider);
+
+    expect(catalogProvider.api).toBe("openai-completions");
+    expect(catalogProvider.baseUrl).toBe("https://qianfan.baidubce.com/v2");
+    const models = expectRecord(catalogProvider.models, "Qianfan catalog models");
+    expect(models.map((model) => model.id)).toEqual([
+      "deepseek-v3.2",
+      "ernie-5.0-thinking-preview",
+    ]);
+    expect(
+      expectRecord(
+        models.find((model) => model.id === "deepseek-v3.2"),
+        "deepseek model",
+      ),
+    ).toEqual({
+      name: "DEEPSEEK V3.2",
+      id: "deepseek-v3.2",
+      reasoning: true,
+      input: ["text"],
+      contextWindow: 98304,
+      maxTokens: 32768,
+      cost: {
+        input: 0,
+        output: 0,
+        cacheRead: 0,
+        cacheWrite: 0,
+      },
+    });
+    expect(
+      expectRecord(
+        models.find((model) => model.id === "ernie-5.0-thinking-preview"),
+        "ernie model",
+      ),
+    ).toEqual({
+      name: "ERNIE-5.0-Thinking-Preview",
+      id: "ernie-5.0-thinking-preview",
+      reasoning: true,
+      input: ["text", "image"],
+      contextWindow: 119000,
+      maxTokens: 64000,
+      cost: {
+        input: 0,
+        output: 0,
+        cacheRead: 0,
+        cacheWrite: 0,
+      },
+    });
+  });
+
+  it("adds Qianfan provider defaults without changing primary model in provider-only mode", () => {
+    const cfg = applyQianfanProviderConfig({
+      agents: {
+        defaults: {
+          model: { primary: "anthropic/claude-opus-4-6" },
+        },
+      },
+    });
+
+    const modelsConfig = expectRecord(cfg.models, "models config");
+    const providers = expectRecord(modelsConfig.providers, "model providers");
+    const providerConfig = expectRecord(providers.qianfan, "Qianfan provider config");
+    expect(providerConfig.api).toBe("openai-completions");
+    expect(providerConfig.baseUrl).toBe("https://qianfan.baidubce.com/v2");
+    const providerModels = expectRecord(providerConfig.models, "Qianfan provider models");
+    expect(providerModels.map((model) => model.id)).toEqual([
+      "deepseek-v3.2",
+      "ernie-5.0-thinking-preview",
+    ]);
+    const agentsConfig = expectRecord(cfg.agents, "agents config");
+    const agentDefaults = expectRecord(agentsConfig.defaults, "agent defaults");
+    const agentModelAliases = expectRecord(agentDefaults.models, "agent model aliases");
+    const qianfanAlias = expectRecord(
+      agentModelAliases[QIANFAN_DEFAULT_MODEL_REF],
+      "Qianfan model alias",
+    );
+    expect(qianfanAlias.alias).toBe("QIANFAN");
+    expect(resolveAgentModelPrimaryValue(agentDefaults.model)).toBe("anthropic/claude-opus-4-6");
+  });
+
+  it("sets Qianfan as the agent primary model in full onboarding mode", () => {
+    const cfg = applyQianfanConfig({});
+
+    const agentsConfig = expectRecord(cfg.agents, "agents config");
+    const agentDefaults = expectRecord(agentsConfig.defaults, "agent defaults");
+    expect(resolveAgentModelPrimaryValue(agentDefaults.model)).toBe(QIANFAN_DEFAULT_MODEL_REF);
+  });
+});

extensions/qianfan/index.ts

@@ -0,0 +1,32 @@
+// Qianfan plugin entrypoint registers its OpenClaw integration.
+import { defineSingleProviderPluginEntry } from "openclaw/plugin-sdk/provider-entry";
+import { applyQianfanConfig, QIANFAN_DEFAULT_MODEL_REF } from "./onboard.js";
+import { buildQianfanProvider } from "./provider-catalog.js";
+
+const PROVIDER_ID = "qianfan";
+
+export default defineSingleProviderPluginEntry({
+  id: PROVIDER_ID,
+  name: "Qianfan Provider",
+  description: "Bundled Qianfan provider plugin",
+  provider: {
+    label: "Qianfan",
+    docsPath: "/providers/qianfan",
+    auth: [
+      {
+        methodId: "api-key",
+        label: "Qianfan API key",
+        hint: "API key",
+        optionKey: "qianfanApiKey",
+        flagName: "--qianfan-api-key",
+        envVar: "QIANFAN_API_KEY",
+        promptMessage: "Enter Qianfan API key",
+        defaultModel: QIANFAN_DEFAULT_MODEL_REF,
+        applyConfig: (cfg) => applyQianfanConfig(cfg),
+      },
+    ],
+    catalog: {
+      buildProvider: buildQianfanProvider,
+    },
+  },
+});

extensions/qianfan/npm-shrinkwrap.json

@@ -0,0 +1,12 @@
+{
+  "name": "@openclaw/qianfan-provider",
+  "version": "2026.6.11",
+  "lockfileVersion": 3,
+  "requires": true,
+  "packages": {
+    "": {
+      "name": "@openclaw/qianfan-provider",
+      "version": "2026.6.11"
+    }
+  }
+}

extensions/qianfan/onboard.ts

@@ -0,0 +1,62 @@
+// Qianfan setup module handles plugin onboarding behavior.
+import {
+  createDefaultModelsPresetAppliers,
+  type ModelApi,
+  type OpenClawConfig,
+} from "openclaw/plugin-sdk/provider-onboard";
+import {
+  buildQianfanProvider,
+  QIANFAN_BASE_URL,
+  QIANFAN_DEFAULT_MODEL_ID,
+} from "./provider-catalog.js";
+
+export const QIANFAN_DEFAULT_MODEL_REF = `qianfan/${QIANFAN_DEFAULT_MODEL_ID}`;
+
+function resolveQianfanPreset(cfg: OpenClawConfig): {
+  api: ModelApi;
+  baseUrl: string;
+  defaultModels: NonNullable<ReturnType<typeof buildQianfanProvider>["models"]>;
+} {
+  const defaultProvider = buildQianfanProvider();
+  const existingProvider = cfg.models?.providers?.qianfan as
+    | {
+        baseUrl?: unknown;
+        api?: unknown;
+      }
+    | undefined;
+  const existingBaseUrl =
+    typeof existingProvider?.baseUrl === "string" ? existingProvider.baseUrl.trim() : "";
+  const api =
+    typeof existingProvider?.api === "string"
+      ? (existingProvider.api as ModelApi)
+      : "openai-completions";
+
+  return {
+    api,
+    baseUrl: existingBaseUrl || QIANFAN_BASE_URL,
+    defaultModels: defaultProvider.models ?? [],
+  };
+}
+
+const qianfanPresetAppliers = createDefaultModelsPresetAppliers({
+  primaryModelRef: QIANFAN_DEFAULT_MODEL_REF,
+  resolveParams: (cfg: OpenClawConfig) => {
+    const preset = resolveQianfanPreset(cfg);
+    return {
+      providerId: "qianfan",
+      api: preset.api,
+      baseUrl: preset.baseUrl,
+      defaultModels: preset.defaultModels,
+      defaultModelId: QIANFAN_DEFAULT_MODEL_ID,
+      aliases: [{ modelRef: QIANFAN_DEFAULT_MODEL_REF, alias: "QIANFAN" }],
+    };
+  },
+});
+
+export function applyQianfanProviderConfig(cfg: OpenClawConfig): OpenClawConfig {
+  return qianfanPresetAppliers.applyProviderConfig(cfg);
+}
+
+export function applyQianfanConfig(cfg: OpenClawConfig): OpenClawConfig {
+  return qianfanPresetAppliers.applyConfig(cfg);
+}

extensions/qianfan/openclaw.plugin.json

@@ -0,0 +1,79 @@
+{
+  "id": "qianfan",
+  "icon": "https://cdn.simpleicons.org/baidu",
+  "activation": {
+    "onStartup": false
+  },
+  "enabledByDefault": true,
+  "providers": ["qianfan"],
+  "setup": {
+    "providers": [
+      {
+        "id": "qianfan",
+        "authMethods": ["api-key"],
+        "envVars": ["QIANFAN_API_KEY"]
+      }
+    ]
+  },
+  "modelCatalog": {
+    "providers": {
+      "qianfan": {
+        "baseUrl": "https://qianfan.baidubce.com/v2",
+        "api": "openai-completions",
+        "models": [
+          {
+            "id": "deepseek-v3.2",
+            "name": "DEEPSEEK V3.2",
+            "input": ["text"],
+            "reasoning": true,
+            "contextWindow": 98304,
+            "maxTokens": 32768,
+            "cost": {
+              "input": 0,
+              "output": 0,
+              "cacheRead": 0,
+              "cacheWrite": 0
+            }
+          },
+          {
+            "id": "ernie-5.0-thinking-preview",
+            "name": "ERNIE-5.0-Thinking-Preview",
+            "input": ["text", "image"],
+            "reasoning": true,
+            "contextWindow": 119000,
+            "maxTokens": 64000,
+            "cost": {
+              "input": 0,
+              "output": 0,
+              "cacheRead": 0,
+              "cacheWrite": 0
+            }
+          }
+        ]
+      }
+    },
+    "discovery": {
+      "qianfan": "static"
+    }
+  },
+  "providerAuthChoices": [
+    {
+      "provider": "qianfan",
+      "method": "api-key",
+      "choiceId": "qianfan-api-key",
+      "choiceLabel": "Qianfan API key",
+      "groupId": "qianfan",
+      "groupLabel": "Qianfan",
+      "groupHint": "API key",
+      "optionKey": "qianfanApiKey",
+      "cliFlag": "--qianfan-api-key",
+      "cliOption": "--qianfan-api-key <key>",
+      "cliDescription": "QIANFAN API key"
+    }
+  ],
+  "configSchema": {
+    "type": "object",
+    "additionalProperties": false,
+    "properties": {}
+  }
+}

extensions/qianfan/package.json

@@ -0,0 +1,35 @@
+{
+  "name": "@openclaw/qianfan-provider",
+  "version": "2026.6.11",
+  "description": "OpenClaw Qianfan provider plugin.",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/openclaw/openclaw"
+  },
+  "type": "module",
+  "devDependencies": {
+    "@openclaw/plugin-sdk": "workspace:*"
+  },
+  "openclaw": {
+    "extensions": [
+      "./index.ts"
+    ],
+    "install": {
+      "clawhubSpec": "clawhub:@openclaw/qianfan-provider",
+      "npmSpec": "@openclaw/qianfan-provider",
+      "defaultChoice": "npm",
+      "minHostVersion": ">=2026.6.8"
+    },
+    "compat": {
+      "pluginApi": ">=2026.6.11"
+    },
+    "build": {
+      "openclawVersion": "2026.6.11",
+      "bundledDist": false
+    },
+    "release": {
+      "publishToClawHub": true,
+      "publishToNpm": true
+    }
+  }
+}

extensions/qianfan/provider-catalog.ts

@@ -0,0 +1,14 @@
+// Qianfan provider module implements model/runtime integration.
+import { buildManifestModelProviderConfig } from "openclaw/plugin-sdk/provider-catalog-shared";
+import type { ModelProviderConfig } from "openclaw/plugin-sdk/provider-model-shared";
+import manifest from "./openclaw.plugin.json" with { type: "json" };
+
+export const QIANFAN_BASE_URL = "https://qianfan.baidubce.com/v2";
+export const QIANFAN_DEFAULT_MODEL_ID = "deepseek-v3.2";
+
+export function buildQianfanProvider(): ModelProviderConfig {
+  return buildManifestModelProviderConfig({
+    providerId: "qianfan",
+    catalog: manifest.modelCatalog.providers.qianfan,
+  });
+}

extensions/qianfan/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"
+  ]
+}