@jiexiaoyin/wecom-api 0.0.2

package/plugin.cjs

@@ -0,0 +1,172 @@
+/**
+ * OpenClaw 插件入口 - 企业微信工具
+ * 
+ * 继承 OpenClaw HTTP 服务，提供回调处理和 32 个 API 模块
+ */
+
+const path = require('path');
+
+// 导入配置加载器
+const { getConfig } = require('./config.js');
+
+// 导入回调处理模块
+const CallbackModule = require('./src/modules/callback/index.js');
+const CallbackClass = CallbackModule.default || CallbackModule;
+
+// 导入统计模块
+const ContactStats = require('./src/modules/contact_stats/index.js');
+
+// 导入通讯录缓存模块
+const AddressBookCache = require('./src/modules/addressbook_cache/index.js');
+const AddressBook = require('./src/modules/addressbook/index.js');
+
+// 导入回调工具函数
+const { createCallbackHandler } = require('./src/callback-helper.js');
+
+let callbackInstance = null;
+let callbackHandler = null;
+
+const plugin = {
+  id: "wecom-api",
+  name: "WeCom API (企业微信API)",
+  description: "企业微信 API 工具集，支持事件回调和 32 个 API 模块",
+  configSchema: {
+    type: "object",
+    properties: {
+      corpId: { type: "string" },
+      corpSecret: { type: "string" },
+      agentId: { type: "string" },
+      token: { type: "string" },
+      encodingAESKey: { type: "string" },
+    },
+  },
+
+  /**
+   * 注册插件
+   */
+  register(api) {
+    console.log('[wecom-api] 插件注册中...');
+
+    // 加载配置
+    const config = getConfig();
+    
+    // 初始化回调处理实例
+    if (config.corpId && config.corpSecret && config.agentId) {
+      callbackInstance = new CallbackClass(config);
+      console.log('[wecom-api] 回调处理已初始化');
+    } else {
+      console.log('[wecom-api] 配置不完整，跳过回调初始化');
+    }
+    
+    // 初始化统计模块
+    let contactStats = null;
+    if (config.corpId && config.corpSecret) {
+      contactStats = new ContactStats(config);
+      console.log('[wecom-api] 统计模块已初始化');
+    }
+    
+    // 初始化通讯录缓存模块
+    let addressBookCache = null;
+    let addressBook = null;
+    if (config.corpId && config.corpSecret) {
+      addressBook = new AddressBook(config);
+      addressBookCache = new AddressBookCache(config, {
+        onConfirm: () => {
+          // 用户确认后开始同步
+          addressBookCache.syncFromAPI(addressBook);
+        }
+      });
+      
+      // 检查是否需要同步
+      // 如果缓存文件已存在，标记为已同步（无需用户再确认）
+      if (addressBookCache.getSyncStatus().lastSyncTime) {
+        addressBookCache.syncConfirmed = true;
+      }
+      const syncStatus = addressBookCache.requestSync();
+      
+      if (syncStatus.needConfirm) {
+        console.log('[wecom-api] 通讯录缓存未初始化，请回复"同步通讯录"开始同步');
+        // 不自动同步，等待用户确认
+      } else if (syncStatus.alreadySynced) {
+        console.log('[wecom-api] 通讯录缓存已就绪');
+      }
+    }
+
+    // 创建回调处理器
+    callbackHandler = createCallbackHandler({
+      callbackInstance,
+      mode: 'independent',
+      alwaysReturnSuccess: true,
+      onMessage: (message, info) => {
+        const eventType = message.Event || message.MsgType || 'unknown';
+        const fromUser = message.FromUserName || 'unknown';
+        
+        if (callbackInstance && callbackInstance._recordEvent) {
+          callbackInstance._recordEvent({
+            type: eventType,
+            fromUserName: fromUser,
+            raw: message,
+            timestamp: Date.now(),
+            mode: info.mode,
+          });
+        }
+        
+        // 更新客户统计（从事件回调收集）
+        if (contactStats && message.Event) {
+          contactStats.updateTodayStats(message.Event, {
+            userId: message.UserID || message.FromUserName,
+            externalUserId: message.ExternalUserID || message.ExternalUserName,
+            state: message.State,
+          });
+          
+          // 记录统计日志
+          if (['add_external_contact', 'del_external_contact', 'change_external_contact'].includes(message.Event)) {
+            console.log(`[wecom-api] 客户统计: ${message.Event} - ${message.UserID || 'unknown'}`);
+          }
+        }
+        
+        // 更新通讯录缓存（事件驱动）
+        if (addressBookCache && message.Event) {
+          switch (message.Event) {
+            case 'change_member':
+              addressBookCache.onUserUpdate({
+                userid: message.UserID,
+                name: message.Name,
+                // 其他字段
+              });
+              break;
+            case 'change_department':
+              addressBookCache.onDepartmentUpdate({
+                id: message.Id,
+                name: message.Name,
+                parentid: message.ParentId,
+              });
+              break;
+          }
+        }
+        
+        console.log(`[wecom-api] 事件: ${eventType} from ${fromUser}`);
+      },
+    });
+
+    // 注册 HTTP 路由
+    api.registerHttpRoute({
+      path: "/plugins/wecom-api/callback",
+      handler: callbackHandler,
+      auth: "plugin",
+      match: "prefix",
+    });
+
+    // 兼容旧路径
+    api.registerHttpRoute({
+      path: "/wecom-api/callback",
+      handler: callbackHandler,
+      auth: "plugin",
+      match: "prefix",
+    });
+
+    console.log('[wecom-api] 插件注册完成');
+  },
+};
+
+module.exports = plugin;

package/plugin.ts

@@ -0,0 +1,136 @@
+/**
+ * OpenClaw 插件入口 - 企业微信工具
+ * 
+ * 继承 OpenClaw HTTP 服务，提供回调处理和 API 能力
+ */
+
+import type { IncomingMessage, ServerResponse } from "node:http";
+import type { OpenClawPluginApi } from "openclaw/plugin-sdk";
+import { emptyPluginConfigSchema } from "openclaw/plugin-sdk";
+
+// 动态导入 CommonJS 模块（避免 ESM/CJS 混用问题）
+import { createRequire } from 'node:module';
+import { fileURLToPath } from 'node:url';
+import { dirname } from 'node:path';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+
+// 导入配置加载器
+const { getConfig } = require('./config.js');
+
+// 导入回调处理模块
+const Callback = require('./src/modules/callback/index.js');
+
+// 插件配置
+interface PluginConfig {
+  corpId?: string;
+  corpSecret?: string;
+  agentId?: string;
+  token?: string;
+  encodingAESKey?: string;
+}
+
+let callbackInstance: any = null;
+
+const plugin = {
+  id: "wecom-api",
+  name: "WeCom Tool (企业微信工具)",
+  description: "企业微信 API 工具集，支持回调处理和 32 个 API 模块",
+  configSchema: {
+    type: "object",
+    properties: {
+      corpId: { type: "string" },
+      corpSecret: { type: "string" },
+      agentId: { type: "string" },
+      token: { type: "string" },
+      encodingAESKey: { type: "string" },
+    },
+  },
+
+  /**
+   * 注册插件
+   */
+  register(api: OpenClawPluginApi) {
+    console.log('[wecom-api] 插件注册中...');
+
+    // 加载配置
+    const config = getConfig();
+    
+    // 初始化回调处理实例
+    if (config.corpId && config.corpSecret && config.agentId) {
+      callbackInstance = new Callback.default ? new Callback.default(config) : new Callback(config);
+      console.log('[wecom-api] 回调处理已初始化');
+    }
+
+    // 注册 HTTP 路由 - 回调入口
+    api.registerHttpRoute({
+      path: "/plugins/wecom-api/callback",
+      handler: handleCallbackRequest,
+      auth: "none", // 企业微信需要验证签名，不在网关层验证
+      match: "prefix",
+    });
+
+    // 兼容旧路径
+    api.registerHttpRoute({
+      path: "/wecom-api/callback",
+      handler: handleCallbackRequest,
+      auth: "none",
+      match: "prefix",
+    });
+
+    console.log('[wecom-api] 插件注册完成');
+  },
+};
+
+/**
+ * 处理企业微信回调请求
+ */
+async function handleCallbackRequest(req: IncomingMessage, res: ServerResponse): Promise<boolean> {
+  if (!callbackInstance) {
+    res.writeHead(500, { 'Content-Type': 'text/plain' });
+    res.end('wecom-api plugin not initialized');
+    return true;
+  }
+
+  const url = req.url || '';
+  const query = new URLSearchParams(url.split('?')[1] || '');
+  
+  const params = {
+    msgSignature: query.get('msg_signature') || query.get('signature') || '',
+    timestamp: query.get('timestamp') || '',
+    nonce: query.get('nonce') || '',
+    echostr: query.get('echostr') || '',
+  };
+
+  // 读取 body
+  const chunks: Buffer[] = [];
+  for await (const chunk of req) {
+    chunks.push(chunk);
+  }
+  const body = Buffer.concat(chunks).toString();
+
+  try {
+    // 调用回调处理
+    const result = await callbackInstance.handle({
+      ...params,
+      xmlBody: body,
+    });
+
+    if (result.type === 'success') {
+      res.writeHead(200, { 'Content-Type': 'text/plain' });
+      res.end(result.body);
+    } else {
+      res.writeHead(400, { 'Content-Type': 'text/plain' });
+      res.end(result.message || 'error');
+    }
+  } catch (error: any) {
+    console.error('[wecom-api] 回调处理失败:', error);
+    res.writeHead(500, { 'Content-Type': 'text/plain' });
+    res.end('error');
+  }
+
+  return true;
+}
+
+export default plugin;

package/skills/wecom-api/SKILL.md

@@ -0,0 +1,40 @@
+---
+name: wecom-api
+description: |
+  企业微信 API 工具库。激活当用户提到企业微信 API、wecom-api，或需要调用企业微信 API 时。
+  同时支持交互式配置：说"配置企业微信"或"设置wecom-api"来启动配置向导。
+---
+
+# WeCom Tool
+
+企业微信 API 封装，提供 30+ 个模块的接口调用能力。
+
+## 交互式配置
+
+当用户说"配置企业微信"、"设置wecom"或"wecom配置"时，触发配置向导：
+
+```
+配置企业微信
+```
+
+配置向导会引导用户输入：
+1. 企业ID (corpId)
+2. 应用Secret (corpSecret)
+3. 应用AgentID (agentId)
+4. 回调Token（可选）
+5. 回调EncodingAESKey（可选）
+
+配置完成后会自动保存到 config.json。
+
+## 使用示例
+
+```
+# 测试连接
+/skill wecom-api test_connection
+
+# 发送消息
+/skill wecom-api send_message --userId user001 --content "Hello"
+
+# 获取客户列表
+/skill wecom-api get_customer_list --userId user001
+```

package/skills/wecom-api/index.js

@@ -0,0 +1,288 @@
+/**
+ * 企业微信 OpenClaw Skill 入口
+ */
+
+const fs = require('fs');
+const path = require('path');
+
+// 插件根目录：skills/wecom-api 上两级
+const pluginRoot = path.join(__dirname, '..', '..');
+const WeComPlugin = require(path.join(pluginRoot, 'src/index'));
+const CONFIG_PATH = path.join(pluginRoot, 'config.json');
+
+// 缓存插件实例
+let wecomInstance = null;
+
+// 配置状态（用于交互式配置）
+let configState = {
+  step: 0,           // 0: 未开始, 1: corpId, 2: corpSecret, 3: agentId, 4: token, 5: encodingAESKey, 6: 完成
+  pending: {},       // 临时存储配置
+  channel: null      // 配置来源渠道
+};
+
+/**
+ * 获取插件实例
+ */
+function getWecom(config = null) {
+  const userConfig = config || loadConfig();
+  if (!wecomInstance || wecomInstance.config.corpId !== userConfig.corpId) {
+    wecomInstance = new WeComPlugin(userConfig);
+  }
+  return wecomInstance;
+}
+
+/**
+ * 加载配置文件
+ */
+function loadConfig() {
+  if (fs.existsSync(CONFIG_PATH)) {
+    try {
+      return JSON.parse(fs.readFileSync(CONFIG_PATH, 'utf8'));
+    } catch (e) {
+      return {};
+    }
+  }
+  return {};
+}
+
+/**
+ * 保存配置文件
+ */
+function saveConfig(config) {
+  fs.writeFileSync(CONFIG_PATH, JSON.stringify(config, null, 2), 'utf8');
+}
+
+/**
+ * 开始交互式配置
+ */
+function startConfig(channel = 'cli') {
+  configState = {
+    step: 1,
+    pending: {},
+    channel
+  };
+  
+  return {
+    message: '📝 **企业微信配置向导**\n\n请输入您的 **企业ID (corpId)**：\n\n获取方式：企业微信后台 → 我的企业 → 企业信息 → 企业ID',
+    action: 'await_input'
+  };
+}
+
+/**
+ * 处理配置输入
+ */
+function handleConfigInput(input, channel = 'cli') {
+  const trimmed = input.trim();
+  
+  switch (configState.step) {
+    case 1: // corpId
+      if (!trimmed) {
+        return { message: '❌ 企业ID不能为空，请重新输入：' };
+      }
+      configState.pending.corpId = trimmed;
+      configState.step = 2;
+      return {
+        message: '✅ 企业ID已保存\n\n请输入您的 **应用Secret (corpSecret)**：\n\n获取方式：企业微信后台 → 应用管理 → 自建应用 → 查看详情 → Secret'
+      };
+    
+    case 2: // corpSecret
+      if (!trimmed) {
+        return { message: '❌ Secret不能为空，请重新输入：' };
+      }
+      configState.pending.corpSecret = trimmed;
+      configState.step = 3;
+      return {
+        message: '✅ Secret已保存\n\n请输入您的 **应用AgentID**：\n\n获取方式：企业微信后台 → 应用管理 → 自建应用 → 查看详情 → AgentId'
+      };
+    
+    case 3: // agentId
+      if (!trimmed) {
+        return { message: '❌ AgentID不能为空，请重新输入：' };
+      }
+      configState.pending.agentId = trimmed;
+      configState.step = 4;
+      return {
+        message: '✅ AgentID已保存\n\n请输入您的 **回调Token**（可选，直接回车跳过）：\n\n用于接收企业微信回调事件，如不需要回调功能可跳过'
+      };
+    
+    case 4: // token
+      configState.pending.token = trimmed || '';
+      configState.step = 5;
+      return {
+        message: '✅ Token已保存\n\n请输入您的 **回调EncodingAESKey**（可选，直接回车跳过）：\n\n回调消息加解密密钥，如不需要回调功能可跳过'
+      };
+    
+    case 5: // encodingAESKey
+      configState.pending.encodingAESKey = trimmed || '';
+      configState.step = 6;
+      
+      // 保存配置
+      const finalConfig = {
+        ...loadConfig(),
+        ...configState.pending
+      };
+      saveConfig(finalConfig);
+      
+      // 重置实例
+      wecomInstance = null;
+      
+      return {
+        message: `✅ 配置完成！\n\n已保存配置：\n- 企业ID: ${finalConfig.corpId}\n- AgentID: ${finalConfig.agentId}\n- Token: ${finalConfig.token ? '已设置' : '未设置'}\n\n现在可以测试连接：/skill wecom test_connection`
+      };
+    
+    default:
+      return { message: '❌ 配置已结束，请重新开始：/skill wecom config' };
+  }
+}
+
+/**
+ * 显示当前配置状态
+ */
+function showConfig() {
+  const config = loadConfig();
+  
+  if (!config.corpId || config.corpId === 'YOUR_CORP_ID') {
+    return {
+      message: '⚠️ 企业微信尚未配置\n\n请运行：/skill wecom config\n或说"配置企业微信"开始配置'
+    };
+  }
+  
+  return {
+    message: `📋 **当前配置**\n\n- 企业ID: ${config.corpId}\n- AgentID: ${config.agentId}\n- Token: ${config.token ? '✅ 已设置' : '❌ 未设置'}\n- EncodingAESKey: ${config.encodingAESKey ? '✅ 已设置' : '❌ 未设置'}\n\n如需修改配置，请运行：/skill wecom config`
+  };
+}
+
+/**
+ * 测试连接
+ */
+async function testConnection() {
+  try {
+    const wecom = getWecom();
+    const result = await wecom.testConnection();
+    
+    if (result.success) {
+      return {
+        message: `✅ **连接成功！**\n\n- 企业ID: ${wecom.config.corpId}\n- Token: ${result.token.substring(0, 20)}...`
+      };
+    } else {
+      return {
+        message: `❌ **连接失败**\n\n${result.message}\n\n请检查配置是否正确，或重新配置：/skill wecom config`
+      };
+    }
+  } catch (e) {
+    return {
+      message: `❌ **错误**\n\n${e.message}\n\n请先配置：/skill wecom config`
+    };
+  }
+}
+
+/**
+ * Skill 主入口
+ */
+async function wecomSkill(params) {
+  const { action, text, _channel } = params;
+  
+  // 检测是否触发配置
+  const configKeywords = ['config', '配置', '设置', 'setup'];
+  const isConfigRequest = configKeywords.some(kw => 
+    (action && action.toLowerCase().includes(kw)) || 
+    (text && text.toLowerCase().includes(kw))
+  );
+  
+  // 配置模式
+  if (isConfigRequest || configState.step > 0) {
+    // 如果有文本输入，处理配置
+    if (text && configState.step > 0) {
+      return handleConfigInput(text, _channel);
+    }
+    // 开始新配置
+    if (configState.step === 0 || configState.step === 6) {
+      return startConfig(_channel);
+    }
+  }
+  
+  // 查看配置
+  if (action === 'show_config' || action === 'status') {
+    return showConfig();
+  }
+  
+  // 测试连接
+  if (action === 'test_connection') {
+    return await testConnection();
+  }
+  
+  // 其他操作需要先配置
+  const config = loadConfig();
+  if (!config.corpId || config.corpId === 'YOUR_CORP_ID') {
+    return {
+      message: '⚠️ 请先配置企业微信\n\n运行：/skill wecom config\n或说"配置企业微信"开始配置'
+    };
+  }
+  
+  // 执行具体操作
+  return await executeAction(action, params);
+}
+
+/**
+ * 执行具体操作
+ */
+async function executeAction(action, params) {
+  const wecom = getWecom();
+  const args = { ...params };
+  delete args.action;
+  
+  try {
+    switch (action) {
+      case 'send_message':
+        return await wecom.message.sendText(args.userId, args.content, args.agentId);
+      
+      case 'get_customer_list':
+        return await wecom.contact.getCustomerList(args.userId);
+      
+      case 'get_customer_detail':
+        return await wecom.contact.getCustomerDetail(args.userId, args.externalUserId);
+      
+      case 'get_approval_list':
+        return await wecom.approval.getApprovalIds(args.startTime, args.endTime);
+      
+      case 'get_approval_detail':
+        return await wecom.approval.getApprovalDetail(args.spNo);
+      
+      case 'create_meeting':
+        return await wecom.meeting.createMeeting({
+          topic: args.topic,
+          startTime: args.startTime,
+          endTime: args.endTime,
+          organizers: [args.userId]
+        });
+      
+      case 'get_user_list':
+        return await wecom.addressbook.getDepartmentUsers(args.departmentId || 1, args.fetchChild || false);
+      
+      case 'get_department_list':
+        return await wecom.addressbook.getDepartmentList(args.departmentId);
+      
+      case 'get_checkin_records':
+        return await wecom.checkin.getCheckInRecords(args.startTime, args.endTime, args.userId);
+      
+      case 'get_corp_tags':
+        return await wecom.contact.getCorpTags();
+      
+      case 'get_groupchat_list':
+        return await wecom.contact.getGroupChatList(args.cursor, args.size);
+      
+      case 'get_agent_list':
+        return await wecom.app.getAgentList();
+      
+      case 'get_token':
+        return await wecom.approval.getAccessToken();
+      
+      default:
+        return { message: `未知的操作: ${action}` };
+    }
+  } catch (e) {
+    return { message: `❌ 执行失败: ${e.message}` };
+  }
+}
+
+module.exports = { wecomSkill };

package/skills/wecom-api/openclaw.plugin.json

@@ -0,0 +1,10 @@
+{
+  "id": "wecom-api",
+  "channels": [],
+  "skills": ["./skills"],
+  "configSchema": {
+    "type": "object",
+    "additionalProperties": false,
+    "properties": {}
+  }
+}