@thclouds/openclaw-channel-taidesk 0.1.0 → 0.1.1

package/index.ts

@@ -1,14 +1,28 @@
-import { defineChannelPluginEntry } from "openclaw/plugin-sdk/core";
+import { buildChannelConfigSchema } from "openclaw/plugin-sdk/channel-config-schema";
+import type { OpenClawPluginApi } from "openclaw/plugin-sdk/plugin-entry";
 
 import { taideskPlugin } from "./src/channel.js";
+import { assertHostCompatibility } from "./src/compat.js";
+import { TaideskChannelConfigSchema } from "./src/config-schema.js";
 import { setTaideskRuntime } from "./src/runtime.js";
 
 export { taideskPlugin, setTaideskRuntime };
 
-export default defineChannelPluginEntry({
+export default {
   id: "taidesk",
-  name: "Taidesk Channel",
-  description: "Taidesk WebSocket inbound + HTTP outbound",
-  plugin: taideskPlugin,
-  setRuntime: setTaideskRuntime,
-});
+  name: "Taidesk",
+  description: "Taidesk channel (MQTT inbound + HTTP webhook outbound)",
+  configSchema: buildChannelConfigSchema(TaideskChannelConfigSchema),
+  register(api: OpenClawPluginApi) {
+    assertHostCompatibility(api.runtime?.version);
+
+    if (api.runtime) {
+      setTaideskRuntime(api.runtime);
+    }
+
+    api.registerChannel({ plugin: taideskPlugin });
+
+    const mode = (api as { registrationMode?: string }).registrationMode;
+    if (mode && mode !== "full") return;
+  },
+};

package/openclaw.plugin.json

@@ -1,6 +1,10 @@
 {
   "id": "taidesk",
-  "name": "Taidesk Channel",
-  "description": "Taidesk WebSocket inbound + HTTP outbound",
-  "extensions": ["./index.ts"]
+  "version": "0.1.1",
+  "channels": ["taidesk"],
+  "configSchema": {
+    "type": "object",
+    "additionalProperties": false,
+    "properties": {}
+  }
 }

package/package.json

@@ -1,15 +1,15 @@
 {
   "name": "@thclouds/openclaw-channel-taidesk",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "OpenClaw Taidesk channel plugin (MQTT inbound + HTTP outbound)",
   "license": "MIT",
+  "author": "thclouds",
   "type": "module",
-  "main": "index.ts",
   "files": [
+    "src/",
     "index.ts",
-    "setup-entry.ts",
-    "src/**/*.ts",
-    "openclaw.plugin.json"
+    "openclaw.plugin.json",
+    "README.md"
   ],
   "scripts": {
     "type-check": "tsc -p tsconfig.json --noEmit",

package/src/channel.ts

@@ -2,9 +2,7 @@ import { randomUUID } from "node:crypto";
 
 import type { ChannelGatewayContext, ChannelPlugin } from "openclaw/plugin-sdk";
 import type { OpenClawConfig } from "openclaw/plugin-sdk/core";
-import { buildChannelConfigSchema } from "openclaw/plugin-sdk/core";
 
-import { TaideskChannelConfigSchema } from "./config-schema.js";
 import {
   applyTaideskAccountDefaults,
   getTaideskConfig,
@@ -40,9 +38,17 @@ export const taideskPlugin: ChannelPlugin<ResolvedTaideskAccount> = {
     label: "Taidesk",
     selectionLabel: "Taidesk (MQTT)",
     docsPath: "/channels/taidesk",
+    docsLabel: "Taidesk",
     blurb: "Taidesk：MQTT 入站 `/open/{agentId}` + HTTP 出站",
+    order: 76,
+  },
+  configSchema: {
+    schema: {
+      type: "object",
+      additionalProperties: false,
+      properties: {},
+    },
   },
-  configSchema: buildChannelConfigSchema(TaideskChannelConfigSchema),
   reload: { configPrefixes: ["channels.taidesk"] },
   capabilities: {
     chatTypes: ["direct"],

package/src/compat.ts

@@ -0,0 +1,51 @@
+/**
+ * OpenClaw 宿主版本校验（日期版本 YYYY.M.DD，如 2026.3.22）。
+ * 对齐微信插件 openclaw-weixin 的 compat 行为，避免在过低版本主机上误加载。
+ */
+
+export const PLUGIN_VERSION = "0.1.1";
+
+export const SUPPORTED_HOST_MIN = "2026.3.22";
+
+export interface OpenClawVersion {
+  year: number;
+  month: number;
+  day: number;
+}
+
+export function parseOpenClawVersion(version: string): OpenClawVersion | null {
+  const base = version.trim().split("-")[0];
+  const parts = base.split(".");
+  if (parts.length !== 3) return null;
+  const [year, month, day] = parts.map(Number);
+  if (Number.isNaN(year) || Number.isNaN(month) || Number.isNaN(day)) return null;
+  return { year, month, day };
+}
+
+export function compareVersions(a: OpenClawVersion, b: OpenClawVersion): -1 | 0 | 1 {
+  for (const key of ["year", "month", "day"] as const) {
+    if (a[key] < b[key]) return -1;
+    if (a[key] > b[key]) return 1;
+  }
+  return 0;
+}
+
+export function isHostVersionSupported(hostVersion: string): boolean {
+  const host = parseOpenClawVersion(hostVersion);
+  if (!host) return false;
+  const min = parseOpenClawVersion(SUPPORTED_HOST_MIN)!;
+  return compareVersions(host, min) >= 0;
+}
+
+export function assertHostCompatibility(hostVersion: string | undefined): void {
+  if (!hostVersion || hostVersion === "unknown") {
+    return;
+  }
+  if (isHostVersionSupported(hostVersion)) {
+    return;
+  }
+  throw new Error(
+    `@thclouds/openclaw-channel-taidesk@${PLUGIN_VERSION} requires OpenClaw >=${SUPPORTED_HOST_MIN}, ` +
+      `but found ${hostVersion}. Please upgrade OpenClaw.`,
+  );
+}

package/setup-entry.ts

@@ -1,5 +0,0 @@
-import { defineSetupPluginEntry } from "openclaw/plugin-sdk/core";
-
-import { taideskPlugin } from "./src/channel.js";
-
-export default defineSetupPluginEntry(taideskPlugin);