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

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

extensions/groq/api.ts

@@ -0,0 +1,51 @@
+// Groq API module exposes the plugin public contract.
+import type { ModelCompatConfig } from "openclaw/plugin-sdk/provider-model-shared";
+
+const GROQ_QWEN3_32B_ID = "qwen/qwen3-32b";
+const GROQ_GPT_OSS_REASONING_IDS = new Set([
+  "openai/gpt-oss-20b",
+  "openai/gpt-oss-120b",
+  "openai/gpt-oss-safeguard-20b",
+]);
+
+const GROQ_QWEN_REASONING_EFFORTS = ["none", "default"] as const;
+const GROQ_GPT_OSS_REASONING_EFFORTS = ["low", "medium", "high"] as const;
+
+const GROQ_QWEN_REASONING_EFFORT_MAP: Record<string, string> = {
+  off: "none",
+  none: "none",
+  minimal: "default",
+  low: "default",
+  medium: "default",
+  high: "default",
+  xhigh: "default",
+  adaptive: "default",
+  max: "default",
+};
+
+function normalizeGroqModelId(modelId: string | undefined): string {
+  return modelId?.trim().toLowerCase() ?? "";
+}
+
+export function resolveGroqReasoningCompatPatch(
+  modelId: string,
+): Pick<
+  ModelCompatConfig,
+  "supportsReasoningEffort" | "supportedReasoningEfforts" | "reasoningEffortMap"
+> | null {
+  const normalized = normalizeGroqModelId(modelId);
+  if (normalized === GROQ_QWEN3_32B_ID) {
+    return {
+      supportsReasoningEffort: true,
+      supportedReasoningEfforts: [...GROQ_QWEN_REASONING_EFFORTS],
+      reasoningEffortMap: GROQ_QWEN_REASONING_EFFORT_MAP,
+    };
+  }
+  if (GROQ_GPT_OSS_REASONING_IDS.has(normalized)) {
+    return {
+      supportsReasoningEffort: true,
+      supportedReasoningEfforts: [...GROQ_GPT_OSS_REASONING_EFFORTS],
+    };
+  }
+  return null;
+}

extensions/groq/index.test.ts

@@ -0,0 +1,69 @@
+// Groq tests cover index plugin behavior.
+import { capturePluginRegistration } from "openclaw/plugin-sdk/plugin-test-runtime";
+import { describe, expect, it } from "vitest";
+import { resolveGroqReasoningCompatPatch } from "./api.js";
+import plugin from "./index.js";
+
+describe("groq provider compat", () => {
+  it("maps Groq Qwen 3 reasoning to provider-native none/default values", () => {
+    expect(resolveGroqReasoningCompatPatch("qwen/qwen3-32b")).toEqual({
+      supportsReasoningEffort: true,
+      supportedReasoningEfforts: ["none", "default"],
+      reasoningEffortMap: {
+        adaptive: "default",
+        high: "default",
+        off: "none",
+        none: "none",
+        minimal: "default",
+        low: "default",
+        medium: "default",
+        max: "default",
+        xhigh: "default",
+      },
+    });
+  });
+
+  it("keeps GPT-OSS reasoning on the Groq low/medium/high contract", () => {
+    expect(resolveGroqReasoningCompatPatch("openai/gpt-oss-120b")).toEqual({
+      supportsReasoningEffort: true,
+      supportedReasoningEfforts: ["low", "medium", "high"],
+    });
+  });
+
+  it("registers Groq model and media providers", () => {
+    const captured = capturePluginRegistration(plugin);
+    const [provider] = captured.providers;
+    if (!provider) {
+      throw new Error("Expected Groq provider");
+    }
+    expect(provider).toMatchObject({
+      docsPath: "/providers/groq",
+      envVars: ["GROQ_API_KEY"],
+      id: "groq",
+      label: "Groq",
+    });
+    expect(provider.auth).toHaveLength(1);
+    expect(provider.auth[0]).toMatchObject({
+      id: "api-key",
+      kind: "api_key",
+      label: "Groq API key",
+      wizard: {
+        choiceId: "groq-api-key",
+        groupId: "groq",
+      },
+    });
+    expect(captured.mediaUnderstandingProviders).toHaveLength(1);
+    const [mediaProvider] = captured.mediaUnderstandingProviders;
+    if (!mediaProvider) {
+      throw new Error("Expected Groq media understanding provider");
+    }
+    const { transcribeAudio, ...mediaProviderMetadata } = mediaProvider;
+    expect(mediaProviderMetadata).toEqual({
+      autoPriority: { audio: 20 },
+      capabilities: ["audio"],
+      defaultModels: { audio: "whisper-large-v3-turbo" },
+      id: "groq",
+    });
+    expect(transcribeAudio).toBeTypeOf("function");
+  });
+});

extensions/groq/index.ts

@@ -0,0 +1,42 @@
+// Groq 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 { groqMediaUnderstandingProvider } from "./media-understanding-provider.js";
+
+const GROQ_DEFAULT_MODEL_REF = "groq/llama-3.3-70b-versatile";
+
+export default definePluginEntry({
+  id: "groq",
+  name: "Groq Provider",
+  description: "Bundled Groq provider plugin",
+  register(api) {
+    api.registerProvider({
+      id: "groq",
+      label: "Groq",
+      docsPath: "/providers/groq",
+      envVars: ["GROQ_API_KEY"],
+      auth: [
+        createProviderApiKeyAuthMethod({
+          providerId: "groq",
+          methodId: "api-key",
+          label: "Groq API key",
+          hint: "Fast OpenAI-compatible inference",
+          optionKey: "groqApiKey",
+          flagName: "--groq-api-key",
+          envVar: "GROQ_API_KEY",
+          promptMessage: "Enter Groq API key",
+          defaultModel: GROQ_DEFAULT_MODEL_REF,
+          wizard: {
+            choiceId: "groq-api-key",
+            choiceLabel: "Groq API key",
+            choiceHint: "Fast OpenAI-compatible inference",
+            groupId: "groq",
+            groupLabel: "Groq",
+            groupHint: "Fast OpenAI-compatible inference",
+          },
+        }),
+      ],
+    });
+    api.registerMediaUnderstandingProvider(groqMediaUnderstandingProvider);
+  },
+});

extensions/groq/media-understanding-provider.ts

@@ -0,0 +1,22 @@
+// Groq provider module implements model/runtime integration.
+import {
+  transcribeOpenAiCompatibleAudio,
+  type MediaUnderstandingProvider,
+} from "openclaw/plugin-sdk/media-understanding";
+
+const DEFAULT_GROQ_AUDIO_BASE_URL = "https://api.groq.com/openai/v1";
+const DEFAULT_GROQ_AUDIO_MODEL = "whisper-large-v3-turbo";
+
+export const groqMediaUnderstandingProvider: MediaUnderstandingProvider = {
+  id: "groq",
+  capabilities: ["audio"],
+  defaultModels: { audio: DEFAULT_GROQ_AUDIO_MODEL },
+  autoPriority: { audio: 20 },
+  transcribeAudio: (req) =>
+    transcribeOpenAiCompatibleAudio({
+      ...req,
+      baseUrl: req.baseUrl ?? DEFAULT_GROQ_AUDIO_BASE_URL,
+      defaultBaseUrl: DEFAULT_GROQ_AUDIO_BASE_URL,
+      defaultModel: DEFAULT_GROQ_AUDIO_MODEL,
+    }),
+};

extensions/groq/npm-shrinkwrap.json

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

extensions/groq/openclaw.plugin.json

@@ -0,0 +1,191 @@
+{
+  "id": "groq",
+  "activation": {
+    "onStartup": false
+  },
+  "enabledByDefault": true,
+  "providers": ["groq"],
+  "providerEndpoints": [
+    {
+      "endpointClass": "groq-native",
+      "hosts": ["api.groq.com"]
+    }
+  ],
+  "providerRequest": {
+    "providers": {
+      "groq": {
+        "family": "groq"
+      }
+    }
+  },
+  "setup": {
+    "providers": [
+      {
+        "id": "groq",
+        "authMethods": ["api-key"],
+        "envVars": ["GROQ_API_KEY"]
+      }
+    ]
+  },
+  "modelCatalog": {
+    "providers": {
+      "groq": {
+        "baseUrl": "https://api.groq.com/openai/v1",
+        "api": "openai-completions",
+        "models": [
+          {
+            "id": "groq/compound",
+            "name": "Compound",
+            "reasoning": true,
+            "input": ["text"],
+            "contextWindow": 131072,
+            "maxTokens": 8192,
+            "cost": {
+              "input": 0,
+              "output": 0,
+              "cacheRead": 0,
+              "cacheWrite": 0
+            }
+          },
+          {
+            "id": "groq/compound-mini",
+            "name": "Compound Mini",
+            "reasoning": true,
+            "input": ["text"],
+            "contextWindow": 131072,
+            "maxTokens": 8192,
+            "cost": {
+              "input": 0,
+              "output": 0,
+              "cacheRead": 0,
+              "cacheWrite": 0
+            }
+          },
+          {
+            "id": "llama-3.1-8b-instant",
+            "name": "Llama 3.1 8B Instant",
+            "reasoning": false,
+            "input": ["text"],
+            "contextWindow": 131072,
+            "maxTokens": 131072,
+            "cost": {
+              "input": 0.05,
+              "output": 0.08,
+              "cacheRead": 0,
+              "cacheWrite": 0
+            }
+          },
+          {
+            "id": "llama-3.3-70b-versatile",
+            "name": "Llama 3.3 70B Versatile",
+            "reasoning": false,
+            "input": ["text"],
+            "contextWindow": 131072,
+            "maxTokens": 32768,
+            "cost": {
+              "input": 0.59,
+              "output": 0.79,
+              "cacheRead": 0,
+              "cacheWrite": 0
+            }
+          },
+          {
+            "id": "meta-llama/llama-4-scout-17b-16e-instruct",
+            "name": "Llama 4 Scout 17B",
+            "reasoning": false,
+            "input": ["text", "image"],
+            "mediaInput": {
+              "image": { "maxPixels": 33177600, "preferredSidePx": 2048, "tokenMode": "provider" }
+            },
+            "contextWindow": 131072,
+            "maxTokens": 8192,
+            "cost": {
+              "input": 0.11,
+              "output": 0.34,
+              "cacheRead": 0,
+              "cacheWrite": 0
+            }
+          },
+          {
+            "id": "openai/gpt-oss-120b",
+            "name": "GPT OSS 120B",
+            "reasoning": true,
+            "input": ["text"],
+            "contextWindow": 131072,
+            "maxTokens": 65536,
+            "cost": {
+              "input": 0.15,
+              "output": 0.6,
+              "cacheRead": 0,
+              "cacheWrite": 0
+            }
+          },
+          {
+            "id": "openai/gpt-oss-20b",
+            "name": "GPT OSS 20B",
+            "reasoning": true,
+            "input": ["text"],
+            "contextWindow": 131072,
+            "maxTokens": 65536,
+            "cost": {
+              "input": 0.075,
+              "output": 0.3,
+              "cacheRead": 0,
+              "cacheWrite": 0
+            }
+          },
+          {
+            "id": "openai/gpt-oss-safeguard-20b",
+            "name": "Safety GPT OSS 20B",
+            "reasoning": true,
+            "input": ["text"],
+            "contextWindow": 131072,
+            "maxTokens": 65536,
+            "cost": {
+              "input": 0.075,
+              "output": 0.3,
+              "cacheRead": 0.037,
+              "cacheWrite": 0
+            }
+          },
+          {
+            "id": "qwen/qwen3-32b",
+            "name": "Qwen3 32B",
+            "reasoning": true,
+            "input": ["text"],
+            "contextWindow": 131072,
+            "maxTokens": 40960,
+            "cost": {
+              "input": 0.29,
+              "output": 0.59,
+              "cacheRead": 0,
+              "cacheWrite": 0
+            }
+          }
+        ]
+      }
+    },
+    "discovery": {
+      "groq": "static"
+    }
+  },
+  "contracts": {
+    "mediaUnderstandingProviders": ["groq"]
+  },
+  "mediaUnderstandingProviderMetadata": {
+    "groq": {
+      "capabilities": ["audio"],
+      "defaultModels": {
+        "audio": "whisper-large-v3-turbo"
+      },
+      "autoPriority": {
+        "audio": 20
+      }
+    }
+  },
+  "configSchema": {
+    "type": "object",
+    "additionalProperties": false,
+    "properties": {}
+  }
+}

extensions/groq/package.json

@@ -0,0 +1,35 @@
+{
+  "name": "@openclaw/groq-provider",
+  "version": "2026.6.11",
+  "description": "OpenClaw Groq media-understanding provider.",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/openclaw/openclaw"
+  },
+  "type": "module",
+  "devDependencies": {
+    "@openclaw/plugin-sdk": "workspace:*"
+  },
+  "openclaw": {
+    "extensions": [
+      "./index.ts"
+    ],
+    "install": {
+      "clawhubSpec": "clawhub:@openclaw/groq-provider",
+      "npmSpec": "@openclaw/groq-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/groq/test-api.ts

@@ -0,0 +1,2 @@
+// Groq API module exposes the plugin public contract.
+export { groqMediaUnderstandingProvider } from "./media-understanding-provider.js";

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