@mishap213/openclaw-channel-vk 1.0.2 → 2.0.0

package/index.ts

@@ -1,12 +1,35 @@
-import { defineChannelPluginEntry } from \"openclaw/plugin-sdk/core\";
-import { vkChatPlugin } from \"./src/channel.js\";
+import { defineChannelPluginEntry } from "openclaw/plugin-sdk/channel-core";
+import { vkChannelPlugin } from "./src/channel.js";
 
 export default defineChannelPluginEntry({
-  id: \"vk\",
-  name: \"VKontakte\",
-  description: \"VKontakte messaging channel for OpenClaw\",
-  plugin: vkChatPlugin,
+  id: "vk",
+  name: "VKontakte",
+  description: "VKontakte channel plugin for OpenClaw",
+  plugin: vkChannelPlugin,
+  
+  // CLI-метаданные (показываются в help, не грузят рантайм)
+  registerCliMetadata(api) {
+    api.registerCli(
+      ({ program }) => {
+        program
+          .command("vk")
+          .description("VKontakte channel management");
+      },
+      {
+        descriptors: [
+          {
+            name: "vk",
+            description: "VKontakte channel management",
+            hasSubcommands: false,
+          },
+        ],
+      },
+    );
+  },
+
+  // Полный рантайм (грузится только когда канал включён)
   registerFull(api) {
-    console.log(\"[VK] registerFull called\");
-  }
-});
+    // Здесь можно зарегистрировать HTTP-роуты для вебхуков ВК
+    // api.registerHttpRoute({ path: "/vk/webhook", ... });
+  },
+});

package/openclaw.plugin.json

@@ -1,6 +1,29 @@
-{
+{
   "id": "vk",
-  "type": "channel",
-  "name": "VKontakte",
-  "description": "VKontakte messaging channel for OpenClaw"
-}
+  "version": "1.0.0",
+  "label": "VKontakte Channel",
+  "description": "Channel plugin for VKontakte messaging platform",
+  "entry": "./index.ts",
+  "setupEntry": "./setup-entry.ts",
+  "channel": {
+    "id": "vk",
+    "label": "VKontakte",
+    "blurb": "Connect OpenClaw to VKontakte messaging."
+  },
+  "config": {
+    "type": "object",
+    "properties": {
+      "vkToken": {
+        "type": "string",
+        "description": "VK Community Access Token",
+        "sensitive": true
+      },
+      "groupId": {
+        "type": "integer",
+        "description": "VK Group ID",
+        "default": 237153619
+      }
+    },
+    "required": ["vkToken", "groupId"]
+  }
+}

package/package.json

@@ -1,17 +1,34 @@
 {
   "name": "@mishap213/openclaw-channel-vk",
-  "version": "1.0.2",
+  "version": "2.0.0",
   "type": "module",
   "description": "VKontakte channel plugin for OpenClaw",
   "author": "Mikhail",
   "license": "MIT",
   "main": "index.ts",
   "files": ["index.ts", "setup-entry.ts", "openclaw.plugin.json", "src/"],
-  "peerDependencies": { "openclaw": ">=2026.3.0" },
+  "peerDependencies": {
+    "openclaw": ">=2026.3.0"
+  },
   "openclaw": {
     "extensions": ["./index.ts"],
     "setupEntry": "./setup-entry.ts",
-    "channel": { "id": "vk", "label": "VKontakte", "blurb": "VK channel" }
+    "channel": {
+      "id": "vk",
+      "label": "VKontakte",
+      "blurb": "Connect OpenClaw to VKontakte messaging."
+    },
+    "compat": {
+      "pluginApi": ">=2026.3.0",
+      "minGatewayVersion": "2026.3.0"
+    },
+    "build": {
+      "openclawVersion": "2026.3.0",
+      "pluginSdkVersion": "2026.3.0"
+    }
   },
-  "publishConfig": { "access": "public", "registry": "https://registry.npmjs.org/" }
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  }
 }

package/setup-entry.ts

@@ -1,4 +1,5 @@
-import { defineSetupPluginEntry } from \"openclaw/plugin-sdk/core\";
-import { vkChatPlugin } from \"./src/channel.js\";
+import { defineSetupPluginEntry } from "openclaw/plugin-sdk/channel-core";
+import { vkChannelPlugin } from "./src/channel.js";
 
-export default defineSetupPluginEntry(vkChatPlugin);
+// Эта точка входа грузится при настройке, чтобы не тянуть тяжёлый рантайм
+export default defineSetupPluginEntry(vkChannelPlugin);

package/src/channel.ts

@@ -1,22 +1,91 @@
-import { createChatChannelPlugin, createChannelPluginBase } from \"openclaw/plugin-sdk/core\";
+import {
+  createChatChannelPlugin,
+  createChannelPluginBase,
+  type OpenClawConfig,
+} from "openclaw/plugin-sdk/channel-core";
 
-const vkChatPlugin = createChatChannelPlugin({
+type ResolvedAccount = {
+  accountId: string | null;
+  vkToken: string;
+  groupId: number;
+  allowFrom: string[];
+  dmPolicy: string | undefined;
+};
+
+function resolveAccount(
+  cfg: OpenClawConfig,
+  accountId?: string | null,
+): ResolvedAccount {
+  const section = (cfg.channels as Record<string, any>)?.["vk"];
+  const vkToken = section?.vkToken;
+  const groupId = section?.groupId;
+  
+  if (!vkToken) throw new Error("vk: vkToken is required");
+  if (!groupId) throw new Error("vk: groupId is required");
+  
+  return {
+    accountId: accountId ?? null,
+    vkToken,
+    groupId,
+    allowFrom: section?.allowFrom ?? [],
+    dmPolicy: section?.dmSecurity,
+  };
+}
+
+export const vkChannelPlugin = createChatChannelPlugin<ResolvedAccount>({
   base: createChannelPluginBase({
-    id: \"vk\",
+    id: "vk",
+    setup: {
+      resolveAccount,
+      inspectAccount(cfg, accountId) {
+        const section = (cfg.channels as Record<string, any>)?.["vk"];
+        return {
+          enabled: Boolean(section?.vkToken && section?.groupId),
+          configured: Boolean(section?.vkToken && section?.groupId),
+          tokenStatus: section?.vkToken ? "available" : "missing",
+        };
+      },
+    },
   }),
 
+  // Безопасность: кто может писать боту в ЛС
+  security: {
+    dm: {
+      channelKey: "vk",
+      resolvePolicy: (account) => account.dmPolicy ?? "allowlist",
+      resolveAllowFrom: (account) => account.allowFrom,
+      defaultPolicy: "allowlist",
+    },
+  },
+
+  // Паринг: код подтверждения для новых контактов
+  pairing: {
+    text: {
+      idLabel: "VK user ID",
+      message: "Отправьте этот код для подтверждения:",
+      notify: async ({ target, code }) => {
+        // Здесь будет отправка через vk-io
+        console.log(`[VK] Pairing code ${code} for ${target}`);
+      },
+    },
+  },
+
+  // Поток ответов: как доставлять ответы
+  threading: { topLevelReplyToMode: "reply" },
+
+  // Отправка сообщений в ВК
   outbound: {
     attachedResults: {
       sendText: async (params) => {
-        console.log([VK SEND] to : );
-        return { messageId: Date.now().toString() };
-      }
-    }
+        // Здесь будет реальный вызов vk-io
+        console.log(`[VK] Send to ${params.to}: ${params.text}`);
+        return { messageId: `vk_${Date.now()}` };
+      },
+    },
+    base: {
+      sendMedia: async (params) => {
+        console.log(`[VK] Send media to ${params.to}`);
+      },
+    },
   },
-
-  activate: async (config) => {
-    console.log(\"✅ VK PLUGIN: activate() called\", config);
-  }
 });
-
-export { vkChatPlugin };