@wecom/wecom-openclaw-plugin 2026.3.20 → 2026.3.24-beta.0

package/README.md

@@ -37,7 +37,25 @@
 
 - OpenClaw `>= 2026.2.13`
 
-### Installation
+### Quick Install
+
+Use the CLI tool to automatically install the plugin and complete bot configuration in one step:
+
+```shell
+# Automatically install the channel plugin and quickly complete configuration; also works for updates
+npx -y @wecom/wecom-openclaw-cli install
+```
+
+More Options
+```shell
+# If installation fails, try force install
+npx -y @wecom/wecom-openclaw-cli install --force
+
+# Use --help to learn more about the tool
+npx -y @wecom/wecom-openclaw-cli --help
+```
+
+### Manual Install
 
 ```shell
 openclaw plugins install @wecom/wecom-openclaw-plugin

package/dist/index.cjs.js

@@ -2,7 +2,7 @@
 
 Object.defineProperty(exports, '__esModule', { value: true });
 
-var pluginSdk = require('openclaw/plugin-sdk');
+var core = require('openclaw/plugin-sdk/core');
 var os$1 = require('os');
 var path$1 = require('path');
 var aibotNodeSdk = require('@wecom/aibot-node-sdk');
@@ -11,7 +11,10 @@ var path = require('node:path');
 var os = require('node:os');
 var node_url = require('node:url');
 var fileType = require('file-type');
+var jsonStore = require('openclaw/plugin-sdk/json-store');
+var infraRuntime = require('openclaw/plugin-sdk/infra-runtime');
 var node_fs = require('node:fs');
+var setup = require('openclaw/plugin-sdk/setup');
 
 var _documentCurrentScript = typeof document !== 'undefined' ? document.currentScript : null;
 function _interopNamespaceDefault(e) {
@@ -57,7 +60,7 @@ function getWeComRuntime() {
  * 本模块在加载时一次性探测 SDK 导出，存在则直接 re-export SDK 版本，
  * 不存在则导出 fallback 实现。其他模块统一从本文件导入，无需关心底层兼容细节。
  */
-const _sdkReady = import('openclaw/plugin-sdk')
+const _sdkReady = import('openclaw/plugin-sdk/core')
     .then((sdk) => {
     const exports$1 = {};
     if (typeof sdk.loadOutboundMediaFromUrl === "function") {
@@ -1320,9 +1323,9 @@ function createPersistentReqIdStore(accountId, options) {
         dirty = false;
         const now = Date.now();
         try {
-            await pluginSdk.withFileLock(filePath, DEFAULT_LOCK_OPTIONS, async () => {
+            await infraRuntime.withFileLock(filePath, DEFAULT_LOCK_OPTIONS, async () => {
                 // 读取现有磁盘数据并合并
-                const { value } = await pluginSdk.readJsonFileWithFallback(filePath, {});
+                const { value } = await jsonStore.readJsonFileWithFallback(filePath, {});
                 const data = sanitizeData(value);
                 // 将内存中未过期的数据合并到磁盘数据（内存优先）
                 for (const [chatId, entry] of memory) {
@@ -1333,7 +1336,7 @@ function createPersistentReqIdStore(accountId, options) {
                 // 清理过期和超量
                 pruneFileData(data, now);
                 // 原子写入
-                await pluginSdk.writeJsonFileAtomically(filePath, data);
+                await jsonStore.writeJsonFileAtomically(filePath, data);
             });
         }
         catch (error) {
@@ -1362,7 +1365,7 @@ function createPersistentReqIdStore(accountId, options) {
         }
         // 2. 内存 miss，回查磁盘并回填内存
         try {
-            const { value } = await pluginSdk.readJsonFileWithFallback(filePath, {});
+            const { value } = await jsonStore.readJsonFileWithFallback(filePath, {});
             const data = sanitizeData(value);
             const diskEntry = data[chatId];
             if (diskEntry && !isExpired(diskEntry, now)) {
@@ -1394,7 +1397,7 @@ function createPersistentReqIdStore(accountId, options) {
     async function warmup(onError) {
         const now = Date.now();
         try {
-            const { value } = await pluginSdk.readJsonFileWithFallback(filePath, {});
+            const { value } = await jsonStore.readJsonFileWithFallback(filePath, {});
             const data = sanitizeData(value);
             let loaded = 0;
             for (const [chatId, entry] of Object.entries(data)) {
@@ -2277,7 +2280,7 @@ const DefaultWsUrl = "wss://openws.work.weixin.qq.com";
 function resolveWeComAccount(cfg) {
     const wecomConfig = (cfg.channels?.[CHANNEL_ID] ?? {});
     return {
-        accountId: pluginSdk.DEFAULT_ACCOUNT_ID,
+        accountId: core.DEFAULT_ACCOUNT_ID,
         name: wecomConfig.name ?? "企业微信",
         enabled: wecomConfig.enabled ?? false,
         websocketUrl: wecomConfig.websocketUrl || DefaultWsUrl,
@@ -2359,7 +2362,7 @@ function setWeComDmPolicy(cfg, dmPolicy) {
     const account = resolveWeComAccount(cfg);
     const existingAllowFrom = account.config.allowFrom ?? [];
     const allowFrom = dmPolicy === "open"
-        ? pluginSdk.addWildcardAllowFrom(existingAllowFrom.map((x) => String(x)))
+        ? setup.addWildcardAllowFrom(existingAllowFrom.map((x) => String(x)))
         : existingAllowFrom.map((x) => String(x));
     return setWeComAccount(cfg, {
         dmPolicy,
@@ -2435,7 +2438,7 @@ const wecomOnboardingAdapter = {
  * 无需依赖 reqId，直接向指定会话推送消息
  */
 async function sendWeComMessage({ to, content, accountId, }) {
-    const resolvedAccountId = accountId ?? pluginSdk.DEFAULT_ACCOUNT_ID;
+    const resolvedAccountId = accountId ?? core.DEFAULT_ACCOUNT_ID;
     // 从 to 中提取 chatId（格式是 "${CHANNEL_ID}:chatId" 或直接是 chatId）
     const channelPrefix = new RegExp(`^${CHANNEL_ID}:`, "i");
     const chatId = to.replace(channelPrefix, "");
@@ -2497,11 +2500,11 @@ const wecomPlugin = {
     reload: { configPrefixes: [`channels.${CHANNEL_ID}`] },
     config: {
         // 列出所有账户 ID（最小实现只支持默认账户）
-        listAccountIds: () => [pluginSdk.DEFAULT_ACCOUNT_ID],
+        listAccountIds: () => [core.DEFAULT_ACCOUNT_ID],
         // 解析账户配置
         resolveAccount: (cfg) => resolveWeComAccount(cfg),
         // 获取默认账户 ID
-        defaultAccountId: () => pluginSdk.DEFAULT_ACCOUNT_ID,
+        defaultAccountId: () => core.DEFAULT_ACCOUNT_ID,
         // 设置账户启用状态
         setAccountEnabled: ({ cfg, enabled }) => {
             const wecomConfig = (cfg.channels?.[CHANNEL_ID] ?? {});
@@ -2557,7 +2560,7 @@ const wecomPlugin = {
                 allowFrom: account.config.allowFrom ?? [],
                 policyPath: `${basePath}dmPolicy`,
                 allowFromPath: basePath,
-                approveHint: pluginSdk.formatPairingApproveHint(CHANNEL_ID),
+                approveHint: core.formatPairingApproveHint(CHANNEL_ID),
                 normalizeEntry: (raw) => raw.replace(new RegExp(`^${CHANNEL_ID}:`, "i"), "").trim(),
             };
         },
@@ -2613,7 +2616,7 @@ const wecomPlugin = {
             return sendWeComMessage({ to, content: text, accountId: accountId ?? undefined });
         },
         sendMedia: async ({ to, text, mediaUrl, mediaLocalRoots, accountId }) => {
-            const resolvedAccountId = accountId ?? pluginSdk.DEFAULT_ACCOUNT_ID;
+            const resolvedAccountId = accountId ?? core.DEFAULT_ACCOUNT_ID;
             const channelPrefix = new RegExp(`^${CHANNEL_ID}:`, "i");
             const chatId = to.replace(channelPrefix, "");
             // 获取 WSClient 实例
@@ -2658,14 +2661,14 @@ const wecomPlugin = {
     },
     status: {
         defaultRuntime: {
-            accountId: pluginSdk.DEFAULT_ACCOUNT_ID,
+            accountId: core.DEFAULT_ACCOUNT_ID,
             running: false,
             lastStartAt: null,
             lastStopAt: null,
             lastError: null,
         },
         collectStatusIssues: (accounts) => accounts.flatMap((entry) => {
-            const accountId = String(entry.accountId ?? pluginSdk.DEFAULT_ACCOUNT_ID);
+            const accountId = String(entry.accountId ?? core.DEFAULT_ACCOUNT_ID);
             const enabled = entry.enabled !== false;
             const configured = entry.configured === true;
             if (!enabled) {
@@ -2832,7 +2835,7 @@ const inflightInitRequests = new Map();
  * @returns 完整的 response.body 配置对象（至少包含 url 字段）
  */
 async function fetchMcpConfig(category) {
-    const wsClient = getWeComWebSocket(pluginSdk.DEFAULT_ACCOUNT_ID);
+    const wsClient = getWeComWebSocket(core.DEFAULT_ACCOUNT_ID);
     if (!wsClient) {
         throw new Error("WSClient 未连接，无法拉取 MCP 配置");
     }
@@ -3573,7 +3576,7 @@ const plugin = {
     id: "wecom-openclaw-plugin",
     name: "企业微信",
     description: "企业微信 OpenClaw 插件",
-    configSchema: pluginSdk.emptyPluginConfigSchema(),
+    configSchema: core.emptyPluginConfigSchema(),
     register(api) {
         setWeComRuntime(api.runtime);
         api.registerChannel({ plugin: wecomPlugin });