Merge branch 'main' into fix/plugin-host-peer-floor

extensions/bluebubbles/package.json

@@ -12,11 +12,6 @@
   "peerDependencies": {
     "openclaw": ">=2026.3.14"
   },
-  "peerDependenciesMeta": {
-    "openclaw": {
-      "optional": true
-    }
-  },
   "openclaw": {
     "extensions": [
       "./index.ts"

extensions/discord/package.json

@@ -16,11 +16,6 @@
   "peerDependencies": {
     "openclaw": ">=2026.3.14"
   },
-  "peerDependenciesMeta": {
-    "openclaw": {
-      "optional": true
-    }
-  },
   "openclaw": {
     "extensions": [
       "./index.ts"

extensions/feishu/package.json

@@ -15,11 +15,6 @@
   "peerDependencies": {
     "openclaw": ">=2026.3.14"
   },
-  "peerDependenciesMeta": {
-    "openclaw": {
-      "optional": true
-    }
-  },
   "openclaw": {
     "extensions": [
       "./index.ts"

extensions/googlechat/package.json

@@ -13,11 +13,6 @@
   "peerDependencies": {
     "openclaw": ">=2026.3.14"
   },
-  "peerDependenciesMeta": {
-    "openclaw": {
-      "optional": true
-    }
-  },
   "openclaw": {
     "extensions": [
       "./index.ts"

extensions/irc/package.json

@@ -6,6 +6,9 @@
   "dependencies": {
     "zod": "^4.3.6"
   },
+  "peerDependencies": {
+    "openclaw": ">=2026.3.14"
+  },
   "openclaw": {
     "extensions": [
       "./index.ts"

extensions/line/package.json

@@ -10,11 +10,6 @@
   "peerDependencies": {
     "openclaw": ">=2026.3.14"
   },
-  "peerDependenciesMeta": {
-    "openclaw": {
-      "optional": true
-    }
-  },
   "openclaw": {
     "extensions": [
       "./index.ts"

extensions/matrix/package.json

@@ -17,11 +17,6 @@
   "peerDependencies": {
     "openclaw": ">=2026.3.14"
   },
-  "peerDependenciesMeta": {
-    "openclaw": {
-      "optional": true
-    }
-  },
   "openclaw": {
     "extensions": [
       "./index.ts"

extensions/mattermost/package.json

@@ -13,11 +13,6 @@
   "peerDependencies": {
     "openclaw": ">=2026.3.14"
   },
-  "peerDependenciesMeta": {
-    "openclaw": {
-      "optional": true
-    }
-  },
   "openclaw": {
     "extensions": [
       "./index.ts"

extensions/msteams/package.json

@@ -14,11 +14,6 @@
   "peerDependencies": {
     "openclaw": ">=2026.3.14"
   },
-  "peerDependenciesMeta": {
-    "openclaw": {
-      "optional": true
-    }
-  },
   "openclaw": {
     "extensions": [
       "./index.ts"

extensions/nextcloud-talk/package.json

@@ -12,11 +12,6 @@
   "peerDependencies": {
     "openclaw": ">=2026.3.14"
   },
-  "peerDependenciesMeta": {
-    "openclaw": {
-      "optional": true
-    }
-  },
   "openclaw": {
     "extensions": [
       "./index.ts"

extensions/nostr/package.json

@@ -13,11 +13,6 @@
   "peerDependencies": {
     "openclaw": ">=2026.3.14"
   },
-  "peerDependenciesMeta": {
-    "openclaw": {
-      "optional": true
-    }
-  },
   "openclaw": {
     "extensions": [
       "./index.ts"

extensions/tlon/package.json

@@ -16,11 +16,6 @@
   "peerDependencies": {
     "openclaw": ">=2026.3.14"
   },
-  "peerDependenciesMeta": {
-    "openclaw": {
-      "optional": true
-    }
-  },
   "openclaw": {
     "extensions": [
       "./index.ts"

extensions/twitch/package.json

@@ -9,6 +9,9 @@
     "@twurple/chat": "^8.0.3",
     "zod": "^4.3.6"
   },
+  "peerDependencies": {
+    "openclaw": ">=2026.3.14"
+  },
   "openclaw": {
     "extensions": [
       "./index.ts"

extensions/voice-call/package.json

@@ -15,11 +15,6 @@
   "peerDependencies": {
     "openclaw": ">=2026.3.14"
   },
-  "peerDependenciesMeta": {
-    "openclaw": {
-      "optional": true
-    }
-  },
   "openclaw": {
     "extensions": [
       "./index.ts"

extensions/whatsapp/package.json

@@ -12,11 +12,6 @@
   "peerDependencies": {
     "openclaw": ">=2026.3.14"
   },
-  "peerDependenciesMeta": {
-    "openclaw": {
-      "optional": true
-    }
-  },
   "openclaw": {
     "extensions": [
       "./index.ts"

extensions/zalo/package.json

@@ -13,11 +13,6 @@
   "peerDependencies": {
     "openclaw": ">=2026.3.14"
   },
-  "peerDependenciesMeta": {
-    "openclaw": {
-      "optional": true
-    }
-  },
   "openclaw": {
     "extensions": [
       "./index.ts"

extensions/zalouser/package.json

@@ -14,11 +14,6 @@
   "peerDependencies": {
     "openclaw": ">=2026.3.14"
   },
-  "peerDependenciesMeta": {
-    "openclaw": {
-      "optional": true
-    }
-  },
   "openclaw": {
     "extensions": [
       "./index.ts"

src/plugins/install-host-peer-guardrails.test.ts

@@ -0,0 +1,49 @@
+import { readFileSync } from "node:fs";
+import { resolve } from "node:path";
+import { describe, expect, it } from "vitest";
+
+const MIN_HOST_VERSION = ">=2026.3.14";
+const INSTALLABLE_PLUGIN_IDS_REQUIRING_HOST_FLOOR = [
+  "bluebubbles",
+  "discord",
+  "feishu",
+  "googlechat",
+  "irc",
+  "line",
+  "matrix",
+  "mattermost",
+  "msteams",
+  "nextcloud-talk",
+  "nostr",
+  "tlon",
+  "twitch",
+  "voice-call",
+  "whatsapp",
+  "zalo",
+  "zalouser",
+] as const;
+
+function readPackageManifest(pluginId: string) {
+  return JSON.parse(
+    readFileSync(resolve(process.cwd(), "extensions", pluginId, "package.json"), "utf8"),
+  ) as {
+    peerDependencies?: Record<string, string>;
+    peerDependenciesMeta?: Record<string, { optional?: boolean }>;
+  };
+}
+
+describe("installable plugin host peer guardrails", () => {
+  it("requires a non-optional openclaw peer floor for plugins that rely on new plugin-sdk subpaths", () => {
+    for (const pluginId of INSTALLABLE_PLUGIN_IDS_REQUIRING_HOST_FLOOR) {
+      const manifest = readPackageManifest(pluginId);
+      expect(
+        manifest.peerDependencies?.openclaw,
+        `${pluginId} should declare an openclaw peer`,
+      ).toBe(MIN_HOST_VERSION);
+      expect(
+        manifest.peerDependenciesMeta?.openclaw?.optional,
+        `${pluginId} should not mark the openclaw peer optional`,
+      ).not.toBe(true);
+    }
+  });
+});