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

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

extensions/cerebras/api.ts

@@ -0,0 +1,10 @@
+/**
+ * Public Cerebras provider plugin API exports.
+ */
+export {
+  buildCerebrasModelDefinition,
+  CEREBRAS_BASE_URL,
+  CEREBRAS_MODEL_CATALOG,
+} from "./models.js";
+export { buildCerebrasProvider } from "./provider-catalog.js";
+export { applyCerebrasConfig, CEREBRAS_DEFAULT_MODEL_REF } from "./onboard.js";

extensions/cerebras/index.ts

@@ -0,0 +1,44 @@
+/**
+ * Cerebras provider plugin entrypoint.
+ */
+import { defineSingleProviderPluginEntry } from "openclaw/plugin-sdk/provider-entry";
+import { applyCerebrasConfig, CEREBRAS_DEFAULT_MODEL_REF } from "./onboard.js";
+import { buildCerebrasProvider } from "./provider-catalog.js";
+
+const PROVIDER_ID = "cerebras";
+
+export default defineSingleProviderPluginEntry({
+  id: PROVIDER_ID,
+  name: "Cerebras Provider",
+  description: "Bundled Cerebras provider plugin",
+  provider: {
+    label: "Cerebras",
+    docsPath: "/providers/cerebras",
+    auth: [
+      {
+        methodId: "api-key",
+        label: "Cerebras API key",
+        hint: "Fast OpenAI-compatible inference",
+        optionKey: "cerebrasApiKey",
+        flagName: "--cerebras-api-key",
+        envVar: "CEREBRAS_API_KEY",
+        promptMessage: "Enter Cerebras API key",
+        defaultModel: CEREBRAS_DEFAULT_MODEL_REF,
+        applyConfig: (cfg) => applyCerebrasConfig(cfg),
+        noteMessage: [
+          "Cerebras provides high-speed OpenAI-compatible inference for GPT OSS, GLM, Qwen, and Llama models.",
+          "Get your API key at: https://cloud.cerebras.ai",
+        ].join("\n"),
+        noteTitle: "Cerebras",
+        wizard: {
+          groupLabel: "Cerebras",
+          groupHint: "Fast OpenAI-compatible inference",
+        },
+      },
+    ],
+    catalog: {
+      buildProvider: buildCerebrasProvider,
+      buildStaticProvider: buildCerebrasProvider,
+    },
+  },
+});

extensions/cerebras/models.ts

@@ -0,0 +1,32 @@
+/**
+ * Cerebras model catalog helpers derived from the plugin manifest.
+ */
+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" };
+
+const CEREBRAS_MANIFEST_CATALOG = manifest.modelCatalog.providers.cerebras;
+
+/** Base URL for Cerebras OpenAI-compatible inference. */
+export const CEREBRAS_BASE_URL = CEREBRAS_MANIFEST_CATALOG.baseUrl;
+/** Cerebras model catalog entries from the plugin manifest. */
+export const CEREBRAS_MODEL_CATALOG = CEREBRAS_MANIFEST_CATALOG.models;
+
+/** Builds normalized Cerebras catalog model definitions. */
+export function buildCerebrasCatalogModels(): ModelDefinitionConfig[] {
+  return buildManifestModelProviderConfig({
+    providerId: "cerebras",
+    catalog: CEREBRAS_MANIFEST_CATALOG,
+  }).models;
+}
+
+/** Builds one normalized Cerebras model definition from a manifest entry. */
+export function buildCerebrasModelDefinition(
+  model: (typeof CEREBRAS_MODEL_CATALOG)[number],
+): ModelDefinitionConfig {
+  const providerConfig = buildManifestModelProviderConfig({
+    providerId: "cerebras",
+    catalog: { ...CEREBRAS_MANIFEST_CATALOG, models: [model] },
+  });
+  return providerConfig.models[0];
+}

extensions/cerebras/npm-shrinkwrap.json

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

extensions/cerebras/onboard.ts

@@ -0,0 +1,31 @@
+/**
+ * Cerebras onboarding config helpers.
+ */
+import {
+  createModelCatalogPresetAppliers,
+  type OpenClawConfig,
+} from "openclaw/plugin-sdk/provider-onboard";
+import {
+  buildCerebrasModelDefinition,
+  CEREBRAS_BASE_URL,
+  CEREBRAS_MODEL_CATALOG,
+} from "./models.js";
+
+/** Default Cerebras model reference used after onboarding. */
+export const CEREBRAS_DEFAULT_MODEL_REF = "cerebras/zai-glm-4.7";
+
+const cerebrasPresetAppliers = createModelCatalogPresetAppliers({
+  primaryModelRef: CEREBRAS_DEFAULT_MODEL_REF,
+  resolveParams: (_cfg: OpenClawConfig) => ({
+    providerId: "cerebras",
+    api: "openai-completions",
+    baseUrl: CEREBRAS_BASE_URL,
+    catalogModels: CEREBRAS_MODEL_CATALOG.map(buildCerebrasModelDefinition),
+    aliases: [{ modelRef: CEREBRAS_DEFAULT_MODEL_REF, alias: "Cerebras GLM 4.7" }],
+  }),
+});
+
+/** Applies Cerebras provider/catalog config and default model aliases. */
+export function applyCerebrasConfig(cfg: OpenClawConfig): OpenClawConfig {
+  return cerebrasPresetAppliers.applyConfig(cfg);
+}

extensions/cerebras/openclaw.plugin.json

@@ -0,0 +1,116 @@
+{
+  "id": "cerebras",
+  "activation": {
+    "onStartup": false
+  },
+  "enabledByDefault": true,
+  "providers": ["cerebras"],
+  "providerEndpoints": [
+    {
+      "endpointClass": "cerebras-native",
+      "hosts": ["api.cerebras.ai"]
+    }
+  ],
+  "providerRequest": {
+    "providers": {
+      "cerebras": {
+        "family": "cerebras"
+      }
+    }
+  },
+  "modelCatalog": {
+    "providers": {
+      "cerebras": {
+        "baseUrl": "https://api.cerebras.ai/v1",
+        "api": "openai-completions",
+        "models": [
+          {
+            "id": "zai-glm-4.7",
+            "name": "Z.ai GLM 4.7",
+            "input": ["text"],
+            "reasoning": true,
+            "contextWindow": 128000,
+            "maxTokens": 8192,
+            "cost": {
+              "input": 2.25,
+              "output": 2.75,
+              "cacheRead": 2.25,
+              "cacheWrite": 2.75
+            }
+          },
+          {
+            "id": "gpt-oss-120b",
+            "name": "GPT OSS 120B",
+            "input": ["text"],
+            "reasoning": true,
+            "contextWindow": 128000,
+            "maxTokens": 8192,
+            "cost": {
+              "input": 0.35,
+              "output": 0.75,
+              "cacheRead": 0.35,
+              "cacheWrite": 0.75
+            }
+          },
+          {
+            "id": "qwen-3-235b-a22b-instruct-2507",
+            "name": "Qwen 3 235B Instruct",
+            "input": ["text"],
+            "contextWindow": 128000,
+            "maxTokens": 8192,
+            "cost": {
+              "input": 0.6,
+              "output": 1.2,
+              "cacheRead": 0.6,
+              "cacheWrite": 1.2
+            }
+          },
+          {
+            "id": "llama3.1-8b",
+            "name": "Llama 3.1 8B",
+            "input": ["text"],
+            "contextWindow": 128000,
+            "maxTokens": 8192,
+            "cost": {
+              "input": 0.1,
+              "output": 0.1,
+              "cacheRead": 0.1,
+              "cacheWrite": 0.1
+            }
+          }
+        ]
+      }
+    },
+    "discovery": {
+      "cerebras": "static"
+    }
+  },
+  "setup": {
+    "providers": [
+      {
+        "id": "cerebras",
+        "envVars": ["CEREBRAS_API_KEY"]
+      }
+    ]
+  },
+  "providerAuthChoices": [
+    {
+      "provider": "cerebras",
+      "method": "api-key",
+      "choiceId": "cerebras-api-key",
+      "choiceLabel": "Cerebras API key",
+      "groupId": "cerebras",
+      "groupLabel": "Cerebras",
+      "groupHint": "Fast OpenAI-compatible inference",
+      "optionKey": "cerebrasApiKey",
+      "cliFlag": "--cerebras-api-key",
+      "cliOption": "--cerebras-api-key <key>",
+      "cliDescription": "Cerebras API key"
+    }
+  ],
+  "configSchema": {
+    "type": "object",
+    "additionalProperties": false,
+    "properties": {}
+  }
+}

extensions/cerebras/package.json

@@ -0,0 +1,35 @@
+{
+  "name": "@openclaw/cerebras-provider",
+  "version": "2026.6.11",
+  "description": "OpenClaw Cerebras 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/cerebras-provider",
+      "npmSpec": "@openclaw/cerebras-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/cerebras/provider-catalog.ts

@@ -0,0 +1,14 @@
+/**
+ * Cerebras model provider builder.
+ */
+import type { ModelProviderConfig } from "openclaw/plugin-sdk/provider-model-shared";
+import { buildCerebrasCatalogModels, CEREBRAS_BASE_URL } from "./models.js";
+
+/** Builds the Cerebras OpenAI-compatible model provider config. */
+export function buildCerebrasProvider(): ModelProviderConfig {
+  return {
+    baseUrl: CEREBRAS_BASE_URL,
+    api: "openai-completions",
+    models: buildCerebrasCatalogModels(),
+  };
+}

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