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

test/official-channel-catalog.test.ts

@@ -0,0 +1,343 @@
+// Official channel catalog tests validate catalog metadata and entries.
+import fs from "node:fs";
+import path from "node:path";
+import { bundledPluginRoot } from "openclaw/plugin-sdk/test-fixtures";
+import { afterEach, describe, expect, it } from "vitest";
+import {
+  buildOfficialChannelCatalog,
+  OFFICIAL_CHANNEL_CATALOG_RELATIVE_PATH,
+  writeOfficialChannelCatalog,
+} from "../scripts/write-official-channel-catalog.mjs";
+import { describePluginInstallSource } from "../src/plugins/install-source-info.js";
+import { cleanupTempDirs, makeTempRepoRoot, writeJsonFile } from "./helpers/temp-repo.js";
+
+const tempDirs: string[] = [];
+
+type OfficialChannelCatalogEntry = ReturnType<
+  typeof buildOfficialChannelCatalog
+>["entries"][number];
+type OfficialChannelInstall = NonNullable<
+  NonNullable<OfficialChannelCatalogEntry["openclaw"]>["install"]
+>;
+
+function makeRepoRoot(prefix: string): string {
+  return makeTempRepoRoot(tempDirs, prefix);
+}
+
+function writeJson(filePath: string, value: unknown): void {
+  writeJsonFile(filePath, value);
+}
+
+function requireInstall(entry: OfficialChannelCatalogEntry | undefined): OfficialChannelInstall {
+  const install = entry?.openclaw?.install;
+  if (!install) {
+    throw new Error("expected official channel install config");
+  }
+  return install;
+}
+
+function requireNpmInstallSource(source: ReturnType<typeof describePluginInstallSource>) {
+  if (!source.npm) {
+    throw new Error("expected npm install source");
+  }
+  return source.npm;
+}
+
+function findCatalogEntry(
+  entries: OfficialChannelCatalogEntry[],
+  predicate: (entry: OfficialChannelCatalogEntry) => boolean,
+): OfficialChannelCatalogEntry {
+  const entry = entries.find(predicate);
+  if (!entry) {
+    throw new Error("expected official channel catalog entry");
+  }
+  return entry;
+}
+
+function summarizeCatalogEntry(entry: OfficialChannelCatalogEntry) {
+  return {
+    name: entry.name,
+    description: entry.description,
+    source: entry.source,
+    plugin: entry.openclaw?.plugin,
+    channel: entry.openclaw?.channel,
+    install: entry.openclaw?.install,
+  };
+}
+
+afterEach(() => {
+  cleanupTempDirs(tempDirs);
+});
+
+describe("buildOfficialChannelCatalog", () => {
+  it("includes publishable official channel plugins and skips non-publishable entries", () => {
+    const repoRoot = makeRepoRoot("openclaw-official-channel-catalog-");
+    writeJson(path.join(repoRoot, "extensions", "whatsapp", "package.json"), {
+      name: "@openclaw/whatsapp",
+      version: "2026.3.23",
+      description: "OpenClaw WhatsApp channel plugin",
+      openclaw: {
+        channel: {
+          id: "whatsapp",
+          label: "WhatsApp",
+          selectionLabel: "WhatsApp (QR link)",
+          detailLabel: "WhatsApp Web",
+          docsPath: "/channels/whatsapp",
+          blurb: "works with your own number; recommend a separate phone + eSIM.",
+        },
+        install: {
+          clawhubSpec: "clawhub:@openclaw/whatsapp",
+          npmSpec: "@openclaw/whatsapp",
+          localPath: bundledPluginRoot("whatsapp"),
+          defaultChoice: "clawhub",
+        },
+        release: {
+          publishToNpm: true,
+        },
+      },
+    });
+    writeJson(path.join(repoRoot, "extensions", "local-only", "package.json"), {
+      name: "@openclaw/local-only",
+      openclaw: {
+        channel: {
+          id: "local-only",
+          label: "Local Only",
+          selectionLabel: "Local Only",
+          docsPath: "/channels/local-only",
+          blurb: "dev only",
+        },
+        install: {
+          localPath: bundledPluginRoot("local-only"),
+        },
+        release: {
+          publishToNpm: false,
+        },
+      },
+    });
+
+    const entries = buildOfficialChannelCatalog({ repoRoot }).entries;
+
+    expect(
+      summarizeCatalogEntry(
+        findCatalogEntry(entries, (entry) => entry.name === "@wecom/wecom-openclaw-plugin"),
+      ),
+    ).toEqual({
+      name: "@wecom/wecom-openclaw-plugin",
+      description: "OpenClaw WeCom channel plugin by the Tencent WeCom team.",
+      source: "external",
+      plugin: {
+        id: "wecom-openclaw-plugin",
+        label: "WeCom",
+      },
+      channel: {
+        id: "wecom",
+        label: "WeCom",
+        selectionLabel: "WeCom（企业微信）",
+        detailLabel: "WeCom",
+        docsLabel: "wecom",
+        docsPath: "/plugins/community#wecom",
+        blurb: "Enterprise messaging and documents, scheduling, task tools.",
+        order: 45,
+        aliases: ["qywx", "wework", "enterprise-wechat"],
+      },
+      install: {
+        npmSpec: "@wecom/wecom-openclaw-plugin@2026.5.7",
+        defaultChoice: "npm",
+        expectedIntegrity:
+          "sha512-TCkP9as00WfEhgFWG8YL/rcmaWGIshAki2HQh83nTRccGfVBCoGjrEboTTqq3yDmK9koWTV11zi8u8A4dNtvug==",
+      },
+    });
+    expect(
+      summarizeCatalogEntry(
+        findCatalogEntry(entries, (entry) => entry.name === "openclaw-plugin-yuanbao"),
+      ),
+    ).toEqual({
+      name: "openclaw-plugin-yuanbao",
+      description: "OpenClaw Yuanbao channel plugin by the Tencent Yuanbao team.",
+      source: "external",
+      plugin: {
+        id: "openclaw-plugin-yuanbao",
+        label: "Yuanbao",
+      },
+      channel: {
+        id: "yuanbao",
+        label: "Yuanbao",
+        selectionLabel: "Yuanbao (元宝)",
+        detailLabel: "Yuanbao",
+        docsLabel: "yuanbao",
+        docsPath: "/plugins/community#yuanbao",
+        blurb: "Tencent Yuanbao AI assistant conversation channel.",
+        order: 85,
+        aliases: ["yuanbao", "yb", "tencent-yuanbao", "元宝"],
+      },
+      install: {
+        npmSpec: "openclaw-plugin-yuanbao@2.15.0",
+        defaultChoice: "npm",
+        expectedIntegrity:
+          "sha512-3GD+mf3EjTSUTOAREjTHAyp/deXdpgqB+q+xE0b19Qtat4ADhUV1mHDwFkVCRqTCBY5ATFKtKcipoDejqFj/+w==",
+      },
+    });
+    expect(
+      summarizeCatalogEntry(
+        findCatalogEntry(entries, (entry) => entry.name === "@openclaw/whatsapp"),
+      ),
+    ).toEqual({
+      name: "@openclaw/whatsapp",
+      description: "OpenClaw WhatsApp channel plugin",
+      source: "official",
+      plugin: undefined,
+      channel: {
+        id: "whatsapp",
+        label: "WhatsApp",
+        selectionLabel: "WhatsApp (QR link)",
+        detailLabel: "WhatsApp Web",
+        docsLabel: "whatsapp",
+        docsPath: "/channels/whatsapp",
+        blurb: "works with your own number; recommend a separate phone + eSIM.",
+        systemImage: "message",
+      },
+      install: {
+        clawhubSpec: "clawhub:@openclaw/whatsapp",
+        npmSpec: "@openclaw/whatsapp",
+        defaultChoice: "clawhub",
+        minHostVersion: ">=2026.4.25",
+      },
+    });
+  });
+
+  it("keeps third-party official external catalog npm sources exactly pinned", () => {
+    const repoRoot = makeRepoRoot("openclaw-official-channel-catalog-policy-");
+    const entries = buildOfficialChannelCatalog({ repoRoot }).entries.filter(
+      (entry) => entry.source === "external" && !entry.name?.startsWith("@openclaw/"),
+    );
+
+    expect(entries.length).toBeGreaterThan(0);
+    for (const entry of entries) {
+      const installSource = describePluginInstallSource(requireInstall(entry));
+      expect(installSource.warnings).toStrictEqual([]);
+      expect(requireNpmInstallSource(installSource).pinState).toBe("exact-with-integrity");
+    }
+  });
+
+  it("allows official OpenClaw channel npm specs without integrity during launch", () => {
+    const repoRoot = makeRepoRoot("openclaw-official-channel-catalog-openclaw-policy-");
+    const twitch = buildOfficialChannelCatalog({ repoRoot }).entries.find(
+      (entry) => entry.openclaw?.channel?.id === "twitch",
+    );
+
+    expect({
+      name: twitch?.name,
+      install: twitch?.openclaw?.install,
+    }).toEqual({
+      name: "@openclaw/twitch",
+      install: {
+        npmSpec: "@openclaw/twitch",
+        defaultChoice: "npm",
+        minHostVersion: ">=2026.4.10",
+      },
+    });
+    const installSource = describePluginInstallSource(requireInstall(twitch));
+    expect(requireNpmInstallSource(installSource).pinState).toBe("floating-without-integrity");
+    expect(installSource.warnings).toEqual(["npm-spec-floating", "npm-spec-missing-integrity"]);
+  });
+
+  it("preserves ClawHub specs when generating publishable channel catalog entries", () => {
+    const repoRoot = makeRepoRoot("openclaw-official-channel-catalog-clawhub-");
+    writeJson(path.join(repoRoot, "extensions", "storepack-chat", "package.json"), {
+      name: "@openclaw/storepack-chat",
+      openclaw: {
+        channel: {
+          id: "storepack-chat",
+          label: "Storepack Chat",
+          selectionLabel: "Storepack Chat",
+          docsPath: "/channels/storepack-chat",
+          blurb: "storepack-first channel",
+        },
+        install: {
+          clawhubSpec: "clawhub:@openclaw/storepack-chat",
+          npmSpec: "@openclaw/storepack-chat",
+          defaultChoice: "clawhub",
+        },
+        release: {
+          publishToNpm: true,
+        },
+      },
+    });
+
+    const entry = buildOfficialChannelCatalog({ repoRoot }).entries.find(
+      (candidate) => candidate.openclaw?.channel?.id === "storepack-chat",
+    );
+
+    expect(requireInstall(entry)).toEqual({
+      clawhubSpec: "clawhub:@openclaw/storepack-chat",
+      npmSpec: "@openclaw/storepack-chat",
+      defaultChoice: "clawhub",
+    });
+  });
+
+  it("writes the official catalog under dist", () => {
+    const repoRoot = makeRepoRoot("openclaw-official-channel-catalog-write-");
+    writeJson(path.join(repoRoot, "extensions", "whatsapp", "package.json"), {
+      name: "@openclaw/whatsapp",
+      openclaw: {
+        channel: {
+          id: "whatsapp",
+          label: "WhatsApp",
+          selectionLabel: "WhatsApp",
+          docsPath: "/channels/whatsapp",
+          blurb: "wa",
+        },
+        install: {
+          npmSpec: "@openclaw/whatsapp",
+        },
+        release: {
+          publishToNpm: true,
+        },
+      },
+    });
+
+    writeOfficialChannelCatalog({ repoRoot });
+
+    const outputPath = path.join(repoRoot, OFFICIAL_CHANNEL_CATALOG_RELATIVE_PATH);
+    expect(fs.existsSync(outputPath)).toBe(true);
+    const entries = JSON.parse(fs.readFileSync(outputPath, "utf8")).entries;
+    expect(entries.map((entry: { name?: string }) => entry.name)).toContain(
+      "@wecom/wecom-openclaw-plugin",
+    );
+    expect(entries.map((entry: { name?: string }) => entry.name)).toContain(
+      "openclaw-plugin-yuanbao",
+    );
+    const whatsappEntry = findCatalogEntry(
+      entries,
+      (entry: { openclaw?: { channel?: { id?: string } } }) =>
+        entry.openclaw?.channel?.id === "whatsapp",
+    );
+    expect(summarizeCatalogEntry(whatsappEntry)).toEqual({
+      name: "@openclaw/whatsapp",
+      description: "OpenClaw WhatsApp channel plugin",
+      source: "official",
+      plugin: undefined,
+      channel: {
+        id: "whatsapp",
+        label: "WhatsApp",
+        selectionLabel: "WhatsApp (QR link)",
+        detailLabel: "WhatsApp Web",
+        docsLabel: "whatsapp",
+        docsPath: "/channels/whatsapp",
+        blurb: "works with your own number; recommend a separate phone + eSIM.",
+        systemImage: "message",
+      },
+      install: {
+        clawhubSpec: "clawhub:@openclaw/whatsapp",
+        npmSpec: "@openclaw/whatsapp",
+        defaultChoice: "clawhub",
+        minHostVersion: ">=2026.4.25",
+      },
+    });
+    const whatsappEntries = entries.filter(
+      (entry: { openclaw?: { channel?: { id?: string } } }) =>
+        entry.openclaw?.channel?.id === "whatsapp",
+    );
+    expect(whatsappEntries).toHaveLength(1);
+  });
+});