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/synthetic/api.ts

@@ -0,0 +1,10 @@
+// Synthetic API module exposes the plugin public contract.
+export { applySyntheticConfig, applySyntheticProviderConfig } from "./onboard.js";
+export {
+  buildSyntheticModelDefinition,
+  SYNTHETIC_BASE_URL,
+  SYNTHETIC_DEFAULT_MODEL_ID,
+  SYNTHETIC_DEFAULT_MODEL_REF,
+  SYNTHETIC_MODEL_CATALOG,
+} from "./models.js";
+export { buildSyntheticProvider } from "./provider-catalog.js";

extensions/synthetic/index.ts

@@ -0,0 +1,32 @@
+// Synthetic plugin entrypoint registers its OpenClaw integration.
+import { defineSingleProviderPluginEntry } from "openclaw/plugin-sdk/provider-entry";
+import { applySyntheticConfig, SYNTHETIC_DEFAULT_MODEL_REF } from "./onboard.js";
+import { buildSyntheticProvider } from "./provider-catalog.js";
+
+const PROVIDER_ID = "synthetic";
+
+export default defineSingleProviderPluginEntry({
+  id: PROVIDER_ID,
+  name: "Synthetic Provider",
+  description: "Bundled Synthetic provider plugin",
+  provider: {
+    label: "Synthetic",
+    docsPath: "/providers/synthetic",
+    auth: [
+      {
+        methodId: "api-key",
+        label: "Synthetic API key",
+        hint: "Anthropic-compatible (multi-model)",
+        optionKey: "syntheticApiKey",
+        flagName: "--synthetic-api-key",
+        envVar: "SYNTHETIC_API_KEY",
+        promptMessage: "Enter Synthetic API key",
+        defaultModel: SYNTHETIC_DEFAULT_MODEL_REF,
+        applyConfig: (cfg) => applySyntheticConfig(cfg),
+      },
+    ],
+    catalog: {
+      buildProvider: buildSyntheticProvider,
+    },
+  },
+});

extensions/synthetic/models.ts

@@ -0,0 +1,197 @@
+// Synthetic plugin module implements models behavior.
+import type { ModelDefinitionConfig } from "openclaw/plugin-sdk/provider-model-shared";
+
+export const SYNTHETIC_BASE_URL = "https://api.synthetic.new/anthropic";
+export const SYNTHETIC_DEFAULT_MODEL_ID = "hf:MiniMaxAI/MiniMax-M2.5";
+export const SYNTHETIC_DEFAULT_MODEL_REF = `synthetic/${SYNTHETIC_DEFAULT_MODEL_ID}`;
+const SYNTHETIC_DEFAULT_COST = {
+  input: 0,
+  output: 0,
+  cacheRead: 0,
+  cacheWrite: 0,
+};
+
+export const SYNTHETIC_MODEL_CATALOG = [
+  {
+    id: SYNTHETIC_DEFAULT_MODEL_ID,
+    name: "MiniMax M2.5",
+    reasoning: false,
+    input: ["text"],
+    contextWindow: 192000,
+    maxTokens: 65536,
+  },
+  {
+    id: "hf:moonshotai/Kimi-K2-Thinking",
+    name: "Kimi K2 Thinking",
+    reasoning: true,
+    input: ["text"],
+    contextWindow: 256000,
+    maxTokens: 8192,
+  },
+  {
+    id: "hf:zai-org/GLM-4.7",
+    name: "GLM-4.7",
+    reasoning: false,
+    input: ["text"],
+    contextWindow: 198000,
+    maxTokens: 128000,
+  },
+  {
+    id: "hf:deepseek-ai/DeepSeek-R1-0528",
+    name: "DeepSeek R1 0528",
+    reasoning: false,
+    input: ["text"],
+    contextWindow: 128000,
+    maxTokens: 8192,
+  },
+  {
+    id: "hf:deepseek-ai/DeepSeek-V3-0324",
+    name: "DeepSeek V3 0324",
+    reasoning: false,
+    input: ["text"],
+    contextWindow: 128000,
+    maxTokens: 8192,
+  },
+  {
+    id: "hf:deepseek-ai/DeepSeek-V3.1",
+    name: "DeepSeek V3.1",
+    reasoning: false,
+    input: ["text"],
+    contextWindow: 128000,
+    maxTokens: 8192,
+  },
+  {
+    id: "hf:deepseek-ai/DeepSeek-V3.1-Terminus",
+    name: "DeepSeek V3.1 Terminus",
+    reasoning: false,
+    input: ["text"],
+    contextWindow: 128000,
+    maxTokens: 8192,
+  },
+  {
+    id: "hf:deepseek-ai/DeepSeek-V3.2",
+    name: "DeepSeek V3.2",
+    reasoning: false,
+    input: ["text"],
+    contextWindow: 159000,
+    maxTokens: 8192,
+  },
+  {
+    id: "hf:meta-llama/Llama-3.3-70B-Instruct",
+    name: "Llama 3.3 70B Instruct",
+    reasoning: false,
+    input: ["text"],
+    contextWindow: 128000,
+    maxTokens: 8192,
+  },
+  {
+    id: "hf:meta-llama/Llama-4-Maverick-17B-128E-Instruct-FP8",
+    name: "Llama 4 Maverick 17B 128E Instruct FP8",
+    reasoning: false,
+    input: ["text"],
+    contextWindow: 524000,
+    maxTokens: 8192,
+  },
+  {
+    id: "hf:moonshotai/Kimi-K2-Instruct-0905",
+    name: "Kimi K2 Instruct 0905",
+    reasoning: false,
+    input: ["text"],
+    contextWindow: 256000,
+    maxTokens: 8192,
+  },
+  {
+    id: "hf:moonshotai/Kimi-K2.5",
+    name: "Kimi K2.5",
+    reasoning: true,
+    input: ["text", "image"],
+    contextWindow: 256000,
+    maxTokens: 8192,
+  },
+  {
+    id: "hf:openai/gpt-oss-120b",
+    name: "GPT OSS 120B",
+    reasoning: false,
+    input: ["text"],
+    contextWindow: 128000,
+    maxTokens: 8192,
+  },
+  {
+    id: "hf:Qwen/Qwen3-235B-A22B-Instruct-2507",
+    name: "Qwen3 235B A22B Instruct 2507",
+    reasoning: false,
+    input: ["text"],
+    contextWindow: 256000,
+    maxTokens: 8192,
+  },
+  {
+    id: "hf:Qwen/Qwen3-Coder-480B-A35B-Instruct",
+    name: "Qwen3 Coder 480B A35B Instruct",
+    reasoning: false,
+    input: ["text"],
+    contextWindow: 256000,
+    maxTokens: 8192,
+  },
+  {
+    id: "hf:Qwen/Qwen3-VL-235B-A22B-Instruct",
+    name: "Qwen3 VL 235B A22B Instruct",
+    reasoning: false,
+    input: ["text", "image"],
+    contextWindow: 250000,
+    maxTokens: 8192,
+  },
+  {
+    id: "hf:zai-org/GLM-4.5",
+    name: "GLM-4.5",
+    reasoning: false,
+    input: ["text"],
+    contextWindow: 128000,
+    maxTokens: 128000,
+  },
+  {
+    id: "hf:zai-org/GLM-4.6",
+    name: "GLM-4.6",
+    reasoning: false,
+    input: ["text"],
+    contextWindow: 198000,
+    maxTokens: 128000,
+  },
+  {
+    id: "hf:zai-org/GLM-5",
+    name: "GLM-5",
+    reasoning: true,
+    input: ["text", "image"],
+    contextWindow: 256000,
+    maxTokens: 128000,
+  },
+  {
+    id: "hf:deepseek-ai/DeepSeek-V3",
+    name: "DeepSeek V3",
+    reasoning: false,
+    input: ["text"],
+    contextWindow: 128000,
+    maxTokens: 8192,
+  },
+  {
+    id: "hf:Qwen/Qwen3-235B-A22B-Thinking-2507",
+    name: "Qwen3 235B A22B Thinking 2507",
+    reasoning: true,
+    input: ["text"],
+    contextWindow: 256000,
+    maxTokens: 8192,
+  },
+] as const;
+
+type SyntheticCatalogEntry = (typeof SYNTHETIC_MODEL_CATALOG)[number];
+
+export function buildSyntheticModelDefinition(entry: SyntheticCatalogEntry): ModelDefinitionConfig {
+  return {
+    id: entry.id,
+    name: entry.name,
+    reasoning: entry.reasoning,
+    input: [...entry.input],
+    cost: SYNTHETIC_DEFAULT_COST,
+    contextWindow: entry.contextWindow,
+    maxTokens: entry.maxTokens,
+  };
+}

extensions/synthetic/onboard.test.ts

@@ -0,0 +1,60 @@
+// Synthetic tests cover onboard plugin behavior.
+import { resolveAgentModelPrimaryValue } from "openclaw/plugin-sdk/provider-onboard";
+import { expectProviderOnboardMergedLegacyConfig } from "openclaw/plugin-sdk/provider-test-contracts";
+import { beforeAll, describe, expect, it } from "vitest";
+import { SYNTHETIC_DEFAULT_MODEL_REF as SYNTHETIC_DEFAULT_MODEL_REF_PUBLIC } from "./api.js";
+import { buildSyntheticModelDefinition, SYNTHETIC_MODEL_CATALOG } from "./models.js";
+import {
+  applySyntheticConfig,
+  applySyntheticProviderConfig,
+  SYNTHETIC_DEFAULT_MODEL_REF,
+} from "./onboard.js";
+
+describe("synthetic onboard", () => {
+  let defaultCfg: ReturnType<typeof applySyntheticConfig>;
+  let mergedProvider: ReturnType<typeof expectProviderOnboardMergedLegacyConfig>;
+
+  beforeAll(() => {
+    defaultCfg = applySyntheticConfig({});
+    mergedProvider = expectProviderOnboardMergedLegacyConfig({
+      applyProviderConfig: applySyntheticProviderConfig,
+      providerId: "synthetic",
+      providerApi: "anthropic-messages",
+      baseUrl: "https://api.synthetic.new/anthropic",
+      legacyApi: "openai-completions",
+    });
+  });
+
+  it("adds synthetic provider with correct settings", () => {
+    const provider = defaultCfg.models?.providers?.synthetic;
+    expect(provider?.baseUrl).toBe("https://api.synthetic.new/anthropic");
+    expect(provider?.api).toBe("anthropic-messages");
+    expect(provider?.models.map((model) => model.id)).toContain(
+      SYNTHETIC_DEFAULT_MODEL_REF.replace(/^synthetic\//, ""),
+    );
+    expect(defaultCfg.agents?.defaults?.models?.[SYNTHETIC_DEFAULT_MODEL_REF]).toEqual({
+      alias: "MiniMax M2.5",
+    });
+    expect(defaultCfg.agents?.defaults?.model).toEqual({
+      primary: "synthetic/hf:MiniMaxAI/MiniMax-M2.5",
+    });
+    expect(provider).toEqual({
+      baseUrl: "https://api.synthetic.new/anthropic",
+      api: "anthropic-messages",
+      models: SYNTHETIC_MODEL_CATALOG.map(buildSyntheticModelDefinition),
+    });
+  });
+
+  it("keeps the public default model ref aligned", () => {
+    expect(SYNTHETIC_DEFAULT_MODEL_REF).toBe(SYNTHETIC_DEFAULT_MODEL_REF_PUBLIC);
+    expect(resolveAgentModelPrimaryValue(defaultCfg.agents?.defaults?.model)).toBe(
+      SYNTHETIC_DEFAULT_MODEL_REF,
+    );
+  });
+
+  it("merges existing synthetic provider models", () => {
+    const ids = mergedProvider?.models.map((m) => m.id);
+    expect(ids).toContain("old-model");
+    expect(ids).toContain(SYNTHETIC_DEFAULT_MODEL_REF.replace(/^synthetic\//, ""));
+  });
+});

extensions/synthetic/onboard.ts

@@ -0,0 +1,32 @@
+// Synthetic setup module handles plugin onboarding behavior.
+import {
+  createModelCatalogPresetAppliers,
+  type OpenClawConfig,
+} from "openclaw/plugin-sdk/provider-onboard";
+import {
+  buildSyntheticModelDefinition,
+  SYNTHETIC_BASE_URL,
+  SYNTHETIC_DEFAULT_MODEL_REF,
+  SYNTHETIC_MODEL_CATALOG,
+} from "./models.js";
+
+export { SYNTHETIC_DEFAULT_MODEL_REF };
+
+const syntheticPresetAppliers = createModelCatalogPresetAppliers({
+  primaryModelRef: SYNTHETIC_DEFAULT_MODEL_REF,
+  resolveParams: (_cfg: OpenClawConfig) => ({
+    providerId: "synthetic",
+    api: "anthropic-messages",
+    baseUrl: SYNTHETIC_BASE_URL,
+    catalogModels: SYNTHETIC_MODEL_CATALOG.map(buildSyntheticModelDefinition),
+    aliases: [{ modelRef: SYNTHETIC_DEFAULT_MODEL_REF, alias: "MiniMax M2.5" }],
+  }),
+});
+
+export function applySyntheticProviderConfig(cfg: OpenClawConfig): OpenClawConfig {
+  return syntheticPresetAppliers.applyProviderConfig(cfg);
+}
+
+export function applySyntheticConfig(cfg: OpenClawConfig): OpenClawConfig {
+  return syntheticPresetAppliers.applyConfig(cfg);
+}

extensions/synthetic/openclaw.plugin.json

@@ -0,0 +1,36 @@
+{
+  "id": "synthetic",
+  "activation": {
+    "onStartup": false
+  },
+  "enabledByDefault": true,
+  "providers": ["synthetic"],
+  "setup": {
+    "providers": [
+      {
+        "id": "synthetic",
+        "envVars": ["SYNTHETIC_API_KEY"]
+      }
+    ]
+  },
+  "providerAuthChoices": [
+    {
+      "provider": "synthetic",
+      "method": "api-key",
+      "choiceId": "synthetic-api-key",
+      "choiceLabel": "Synthetic API key",
+      "groupId": "synthetic",
+      "groupLabel": "Synthetic",
+      "groupHint": "Anthropic-compatible (multi-model)",
+      "optionKey": "syntheticApiKey",
+      "cliFlag": "--synthetic-api-key",
+      "cliOption": "--synthetic-api-key <key>",
+      "cliDescription": "Synthetic API key"
+    }
+  ],
+  "configSchema": {
+    "type": "object",
+    "additionalProperties": false,
+    "properties": {}
+  }
+}

extensions/synthetic/package.json

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

extensions/synthetic/provider-catalog.ts

@@ -0,0 +1,15 @@
+// Synthetic provider module implements model/runtime integration.
+import type { ModelProviderConfig } from "openclaw/plugin-sdk/provider-model-shared";
+import {
+  buildSyntheticModelDefinition,
+  SYNTHETIC_BASE_URL,
+  SYNTHETIC_MODEL_CATALOG,
+} from "./models.js";
+
+export function buildSyntheticProvider(): ModelProviderConfig {
+  return {
+    baseUrl: SYNTHETIC_BASE_URL,
+    api: "anthropic-messages",
+    models: SYNTHETIC_MODEL_CATALOG.map(buildSyntheticModelDefinition),
+  };
+}

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