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

@@ -0,0 +1,13 @@
+# Tencent Cloud OpenClaw provider
+
+Official OpenClaw provider plugin for Tencent Cloud.
+
+## Install
+
+```sh
+openclaw plugins install @openclaw/tencent-provider
+```
+
+## Docs
+
+See `docs/providers/tencent.md` in the OpenClaw repository, or the published docs at `https://docs.openclaw.ai/providers/tencent`.

extensions/tencent/api.ts

@@ -0,0 +1,8 @@
+// Tencent API module exposes the plugin public contract.
+export {
+  buildTokenHubModelDefinition,
+  TOKENHUB_BASE_URL,
+  TOKENHUB_MODEL_CATALOG,
+  TOKENHUB_PROVIDER_ID,
+} from "./models.js";
+export { buildTokenHubProvider } from "./provider-catalog.js";

extensions/tencent/index.ts

@@ -0,0 +1,65 @@
+// Tencent plugin entrypoint registers its OpenClaw integration.
+import { definePluginEntry } from "openclaw/plugin-sdk/plugin-entry";
+import { createProviderApiKeyAuthMethod } from "openclaw/plugin-sdk/provider-auth-api-key";
+import { buildSingleProviderApiKeyCatalog } from "openclaw/plugin-sdk/provider-catalog-shared";
+import { TOKENHUB_MODEL_CATALOG, TOKENHUB_PROVIDER_ID } from "./models.js";
+import { applyTokenHubConfig, TOKENHUB_DEFAULT_MODEL_REF } from "./onboard.js";
+import { buildTokenHubProvider } from "./provider-catalog.js";
+
+function buildStaticCatalogEntries(providerId: string, catalog: typeof TOKENHUB_MODEL_CATALOG) {
+  return catalog.map((entry) => ({
+    provider: providerId,
+    id: entry.id,
+    name: entry.name,
+    reasoning: entry.reasoning,
+    input: [...entry.input],
+    contextWindow: entry.contextWindow,
+  }));
+}
+
+export default definePluginEntry({
+  id: "tencent",
+  name: "Tencent Cloud Provider",
+  description: "Bundled Tencent Cloud provider plugin (TokenHub)",
+  register(api) {
+    api.registerProvider({
+      id: TOKENHUB_PROVIDER_ID,
+      label: "Tencent TokenHub",
+      docsPath: "/providers/tencent",
+      envVars: ["TOKENHUB_API_KEY"],
+      auth: [
+        createProviderApiKeyAuthMethod({
+          providerId: TOKENHUB_PROVIDER_ID,
+          methodId: "api-key",
+          label: "Tencent TokenHub",
+          hint: "Hy via Tencent TokenHub Gateway",
+          optionKey: "tokenhubApiKey",
+          flagName: "--tokenhub-api-key",
+          envVar: "TOKENHUB_API_KEY",
+          promptMessage: "Enter Tencent TokenHub API key",
+          defaultModel: TOKENHUB_DEFAULT_MODEL_REF,
+          expectedProviders: [TOKENHUB_PROVIDER_ID],
+          applyConfig: (cfg) => applyTokenHubConfig(cfg),
+          wizard: {
+            choiceId: "tokenhub-api-key",
+            choiceLabel: "Tencent TokenHub",
+            groupId: "tencent",
+            groupLabel: "Tencent Cloud",
+            groupHint: "Tencent TokenHub",
+          },
+        }),
+      ],
+      catalog: {
+        order: "simple",
+        run: (ctx) =>
+          buildSingleProviderApiKeyCatalog({
+            ctx,
+            providerId: TOKENHUB_PROVIDER_ID,
+            buildProvider: buildTokenHubProvider,
+          }),
+      },
+      augmentModelCatalog: () =>
+        buildStaticCatalogEntries(TOKENHUB_PROVIDER_ID, TOKENHUB_MODEL_CATALOG),
+    });
+  },
+});

extensions/tencent/models.ts

@@ -0,0 +1,26 @@
+// Tencent plugin module implements models behavior.
+import { buildManifestModelProviderConfig } from "openclaw/plugin-sdk/provider-catalog-shared";
+import type { ModelDefinitionConfig } from "openclaw/plugin-sdk/provider-model-shared";
+import manifest from "./openclaw.plugin.json" with { type: "json" };
+
+// ---------- TokenHub provider ----------
+
+export const TOKENHUB_PROVIDER_ID = "tencent-tokenhub";
+
+const TOKENHUB_MANIFEST_PROVIDER = buildManifestModelProviderConfig({
+  providerId: TOKENHUB_PROVIDER_ID,
+  catalog: manifest.modelCatalog.providers[TOKENHUB_PROVIDER_ID],
+});
+
+export const TOKENHUB_BASE_URL = TOKENHUB_MANIFEST_PROVIDER.baseUrl;
+
+export const TOKENHUB_MODEL_CATALOG: ModelDefinitionConfig[] = TOKENHUB_MANIFEST_PROVIDER.models;
+
+export function buildTokenHubModelDefinition(
+  model: (typeof TOKENHUB_MODEL_CATALOG)[number],
+): ModelDefinitionConfig {
+  return {
+    ...model,
+    api: "openai-completions",
+  };
+}

extensions/tencent/npm-shrinkwrap.json

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

extensions/tencent/onboard.ts

@@ -0,0 +1,39 @@
+// Tencent setup module handles plugin onboarding behavior.
+import {
+  applyAgentDefaultModelPrimary,
+  applyProviderConfigWithModelCatalog,
+  type OpenClawConfig,
+} from "openclaw/plugin-sdk/provider-onboard";
+import {
+  buildTokenHubModelDefinition,
+  TOKENHUB_BASE_URL,
+  TOKENHUB_MODEL_CATALOG,
+  TOKENHUB_PROVIDER_ID,
+} from "./api.js";
+
+// ---------- TokenHub ----------
+
+export const TOKENHUB_DEFAULT_MODEL_REF = `${TOKENHUB_PROVIDER_ID}/hy3-preview`;
+
+function applyTokenHubProviderConfig(cfg: OpenClawConfig): OpenClawConfig {
+  const models = { ...cfg.agents?.defaults?.models };
+  models[TOKENHUB_DEFAULT_MODEL_REF] = {
+    ...models[TOKENHUB_DEFAULT_MODEL_REF],
+    alias: models[TOKENHUB_DEFAULT_MODEL_REF]?.alias ?? "Hy3 preview (TokenHub)",
+  };
+
+  return applyProviderConfigWithModelCatalog(cfg, {
+    agentModels: models,
+    providerId: TOKENHUB_PROVIDER_ID,
+    api: "openai-completions",
+    baseUrl: TOKENHUB_BASE_URL,
+    catalogModels: TOKENHUB_MODEL_CATALOG.map(buildTokenHubModelDefinition),
+  });
+}
+
+export function applyTokenHubConfig(cfg: OpenClawConfig): OpenClawConfig {
+  return applyAgentDefaultModelPrimary(
+    applyTokenHubProviderConfig(cfg),
+    TOKENHUB_DEFAULT_MODEL_REF,
+  );
+}

extensions/tencent/openclaw.plugin.json

@@ -0,0 +1,91 @@
+{
+  "id": "tencent",
+  "activation": {
+    "onStartup": false
+  },
+  "enabledByDefault": true,
+  "providerCatalogEntry": "./provider-discovery.ts",
+  "providers": ["tencent-tokenhub"],
+  "modelCatalog": {
+    "providers": {
+      "tencent-tokenhub": {
+        "baseUrl": "https://tokenhub.tencentmaas.com/v1",
+        "api": "openai-completions",
+        "models": [
+          {
+            "id": "hy3-preview",
+            "name": "Hy3 preview (TokenHub)",
+            "reasoning": true,
+            "input": ["text"],
+            "contextWindow": 256000,
+            "maxTokens": 64000,
+            "cost": {
+              "input": 0.176,
+              "output": 0.587,
+              "cacheRead": 0.059,
+              "cacheWrite": 0,
+              "tieredPricing": [
+                {
+                  "input": 0.176,
+                  "output": 0.587,
+                  "cacheRead": 0.059,
+                  "cacheWrite": 0,
+                  "range": [0, 16000]
+                },
+                {
+                  "input": 0.235,
+                  "output": 0.939,
+                  "cacheRead": 0.088,
+                  "cacheWrite": 0,
+                  "range": [16000, 32000]
+                },
+                {
+                  "input": 0.293,
+                  "output": 1.173,
+                  "cacheRead": 0.117,
+                  "cacheWrite": 0,
+                  "range": [32000]
+                }
+              ]
+            },
+            "compat": {
+              "supportsUsageInStreaming": true,
+              "supportsReasoningEffort": true
+            }
+          }
+        ]
+      }
+    },
+    "discovery": {
+      "tencent-tokenhub": "static"
+    }
+  },
+  "setup": {
+    "providers": [
+      {
+        "id": "tencent-tokenhub",
+        "envVars": ["TOKENHUB_API_KEY"]
+      }
+    ]
+  },
+  "providerAuthChoices": [
+    {
+      "provider": "tencent-tokenhub",
+      "method": "api-key",
+      "choiceId": "tokenhub-api-key",
+      "choiceLabel": "Tencent TokenHub",
+      "groupId": "tencent",
+      "groupLabel": "Tencent Cloud",
+      "groupHint": "Tencent TokenHub",
+      "optionKey": "tokenhubApiKey",
+      "cliFlag": "--tokenhub-api-key",
+      "cliOption": "--tokenhub-api-key <key>",
+      "cliDescription": "Tencent TokenHub API key"
+    }
+  ],
+  "configSchema": {
+    "type": "object",
+    "additionalProperties": false,
+    "properties": {}
+  }
+}

extensions/tencent/package.json

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

extensions/tencent/provider-catalog.ts

@@ -0,0 +1,15 @@
+// Tencent provider module implements model/runtime integration.
+import type { ModelProviderConfig } from "openclaw/plugin-sdk/provider-model-shared";
+import {
+  buildTokenHubModelDefinition,
+  TOKENHUB_BASE_URL,
+  TOKENHUB_MODEL_CATALOG,
+} from "./models.js";
+
+export function buildTokenHubProvider(): ModelProviderConfig {
+  return {
+    baseUrl: TOKENHUB_BASE_URL,
+    api: "openai-completions",
+    models: TOKENHUB_MODEL_CATALOG.map(buildTokenHubModelDefinition),
+  };
+}

extensions/tencent/provider-discovery.ts

@@ -0,0 +1,18 @@
+// Tencent provider module implements model/runtime integration.
+import type { ProviderPlugin } from "openclaw/plugin-sdk/provider-model-shared";
+import { buildTokenHubProvider } from "./provider-catalog.js";
+
+const tencentProviderDiscovery: ProviderPlugin = {
+  id: "tencent-tokenhub",
+  label: "Tencent TokenHub",
+  docsPath: "/providers/models",
+  auth: [],
+  staticCatalog: {
+    order: "simple",
+    run: async () => ({
+      provider: buildTokenHubProvider(),
+    }),
+  },
+};
+
+export default tencentProviderDiscovery;

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