@xuanyue202/wecom 2026.3.21

package/openclaw.plugin.json

@@ -0,0 +1,72 @@
+{
+  "id": "wecom",
+  "name": "WeCom",
+  "description": "企业微信消息渠道插件",
+  "version": "0.1.3",
+  "channels": ["wecom"],
+  "skills": ["./skills"],
+  "configSchema": {
+    "type": "object",
+    "additionalProperties": false,
+    "properties": {
+      "enabled": { "type": "boolean" },
+      "name": { "type": "string" },
+      "mode": { "type": "string", "enum": ["webhook", "ws"], "default": "ws" },
+      "webhookPath": { "type": "string" },
+      "token": { "type": "string" },
+      "encodingAESKey": { "type": "string" },
+      "receiveId": { "type": "string" },
+      "botId": { "type": "string" },
+      "secret": { "type": "string" },
+      "wsUrl": { "type": "string" },
+      "heartbeatIntervalMs": { "type": "integer", "minimum": 1 },
+      "reconnectInitialDelayMs": { "type": "integer", "minimum": 1 },
+      "reconnectMaxDelayMs": { "type": "integer", "minimum": 1 },
+      "publicBaseUrl": { "type": "string" },
+      "wsImageReplyMode": { "type": "string", "enum": ["native", "markdown-url"] },
+      "welcomeText": { "type": "string" },
+      "dmPolicy": { "type": "string", "enum": ["open", "pairing", "allowlist", "disabled"] },
+      "allowFrom": { "type": "array", "items": { "type": "string" } },
+      "groupPolicy": { "type": "string", "enum": ["open", "allowlist", "disabled"] },
+      "groupAllowFrom": { "type": "array", "items": { "type": "string" } },
+      "requireMention": { "type": "boolean" },
+      "defaultAccount": { "type": "string" },
+      "accounts": {
+        "type": "object",
+        "additionalProperties": {
+          "type": "object",
+          "additionalProperties": false,
+          "properties": {
+            "name": { "type": "string" },
+            "enabled": { "type": "boolean" },
+            "mode": { "type": "string", "enum": ["webhook", "ws"], "default": "ws" },
+            "webhookPath": { "type": "string" },
+            "token": { "type": "string" },
+            "encodingAESKey": { "type": "string" },
+            "receiveId": { "type": "string" },
+            "botId": { "type": "string" },
+            "secret": { "type": "string" },
+            "wsUrl": { "type": "string" },
+            "heartbeatIntervalMs": { "type": "integer", "minimum": 1 },
+            "reconnectInitialDelayMs": { "type": "integer", "minimum": 1 },
+            "reconnectMaxDelayMs": { "type": "integer", "minimum": 1 },
+            "publicBaseUrl": { "type": "string" },
+            "wsImageReplyMode": { "type": "string", "enum": ["native", "markdown-url"] },
+            "welcomeText": { "type": "string" },
+            "dmPolicy": { "type": "string", "enum": ["open", "pairing", "allowlist", "disabled"] },
+            "allowFrom": { "type": "array", "items": { "type": "string" } },
+            "groupPolicy": { "type": "string", "enum": ["open", "allowlist", "disabled"] },
+            "groupAllowFrom": { "type": "array", "items": { "type": "string" } },
+            "requireMention": { "type": "boolean" }
+          }
+        }
+      }
+    }
+  },
+  "uiHints": {
+    "token": { "label": "Token", "sensitive": true },
+    "encodingAESKey": { "label": "EncodingAESKey", "sensitive": true },
+    "secret": { "label": "Secret", "sensitive": true },
+    "webhookPath": { "label": "Webhook Path" }
+  }
+}

package/package.json

@@ -0,0 +1,123 @@
+{
+  "name": "@xuanyue202/wecom",
+  "version": "2026.3.21",
+  "type": "module",
+  "description": "Moltbot WeCom smart bot channel plugin",
+  "license": "MIT",
+  "files": [
+    "dist",
+    "skills",
+    "moltbot.plugin.json",
+    "clawdbot.plugin.json",
+    "openclaw.plugin.json"
+  ],
+  "openclaw": {
+    "extensions": [
+      "./dist/index.js"
+    ],
+    "channel": {
+      "id": "wecom",
+      "label": "WeCom",
+      "selectionLabel": "WeCom (企业微信)",
+      "docsPath": "/channels/wecom",
+      "blurb": "企业微信智能机器人（Webhook / 长连接）",
+      "aliases": [
+        "wechatwork",
+        "wework",
+        "qywx"
+      ],
+      "order": 85
+    },
+    "install": {
+      "npmSpec": "@xuanyue202/wecom",
+      "localPath": ".",
+      "defaultChoice": "npm"
+    }
+  },
+  "moltbot": {
+    "extensions": [
+      "./dist/index.js"
+    ],
+    "channel": {
+      "id": "wecom",
+      "label": "WeCom",
+      "selectionLabel": "WeCom (企业微信)",
+      "docsPath": "/channels/wecom",
+      "blurb": "企业微信智能机器人（Webhook / 长连接）",
+      "aliases": [
+        "wechatwork",
+        "wework",
+        "qywx"
+      ],
+      "order": 85
+    },
+    "install": {
+      "npmSpec": "@xuanyue202/wecom",
+      "localPath": ".",
+      "defaultChoice": "npm"
+    }
+  },
+  "clawdbot": {
+    "extensions": [
+      "./dist/index.js"
+    ],
+    "channel": {
+      "id": "wecom",
+      "label": "WeCom",
+      "selectionLabel": "WeCom (企业微信)",
+      "docsPath": "/channels/wecom",
+      "blurb": "企业微信智能机器人（Webhook / 长连接）",
+      "aliases": [
+        "wechatwork",
+        "wework",
+        "qywx"
+      ],
+      "order": 85
+    },
+    "install": {
+      "npmSpec": "@xuanyue202/wecom",
+      "localPath": ".",
+      "defaultChoice": "npm"
+    }
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "test": "vitest --run",
+    "test:watch": "vitest",
+    "release": "npm run build && npm publish",
+    "release:patch": "npm run build && npm version patch && npm publish",
+    "release:minor": "npm run build && npm version minor && npm publish",
+    "release:major": "npm run build && npm version major && npm publish"
+  },
+  "dependencies": {
+    "@xuanyue202/shared": "2026.3.21",
+    "@wecom/aibot-node-sdk": "^1.0.2",
+    "ws": "^8.18.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "@types/ws": "^8.5.14",
+    "tsup": "^8.2.0",
+    "typescript": "^5.7.0",
+    "vitest": "^2.1.0",
+    "zod": "^3.23.0"
+  },
+  "peerDependencies": {
+    "moltbot": ">=0.1.0"
+  },
+  "peerDependenciesMeta": {
+    "moltbot": {
+      "optional": true
+    }
+  },
+  "private": false
+}

package/skills/wecom-doc/SKILL.md

@@ -0,0 +1,120 @@
+---
+name: wecom-doc
+description: 当用户提到企业微信文档、智能表格、创建文档、编辑文档、写文档时启用。优先复用 wecom channel 自动写入的文档 MCP 配置，并通过 mcporter 调用文档能力。
+metadata:
+  {
+    "openclaw":
+      {
+        "emoji": "📄",
+        "always": true,
+        "requires":
+          {
+            "bins": ["mcporter"],
+          },
+        "install":
+          [
+            {
+              "id": "mcporter",
+              "kind": "node",
+              "package": "mcporter",
+              "bins": ["mcporter"],
+              "label": "Install mcporter (npm)",
+            },
+          ],
+      },
+  }
+---
+
+# 企业微信文档 MCP
+
+这个 skill 只负责通过 `mcporter` 调用企业微信文档 MCP，不要直接调用企业微信 Wedoc API。
+
+## 使用时机
+
+- 用户要创建企业微信文档
+- 用户要创建企业微信智能表格
+- 用户要编辑机器人创建的企微文档或智能表格
+
+## 前置检查
+
+### 1. 检查 mcporter
+
+先确认 `mcporter` 可执行。若未安装，提示用户安装；用户同意后执行：
+
+```bash
+npm install -g mcporter
+```
+
+安装完成后继续后续步骤，不要停在中间。
+
+### 2. 确认 wecom-doc MCP 已配置
+
+先执行：
+
+```bash
+mcporter list wecom-doc --output json
+```
+
+如果已经能正常返回 tool 列表，直接进入调用阶段。
+
+如果返回 `server not found`、`unknown server` 或类似错误，读取：
+
+```bash
+~/.openclaw/wecomConfig/config.json
+```
+
+检查是否存在 `mcpConfig.doc.type` 和 `mcpConfig.doc.url`。若存在，执行：
+
+```bash
+mcporter config add wecom-doc --type "<type>" --url "<url>"
+```
+
+添加完成后再次执行 `mcporter list wecom-doc --output json` 进行验证。
+
+### 3. 自动配置失败时的引导
+
+如果本地没有 `mcpConfig.doc`，说明当前 wecom 长连接还没成功拉到文档 MCP 配置。此时：
+
+- 如果能读取到 `channels.wecom.botId`，提示用户去企业微信授权当前机器人文档权限
+- 或让用户直接发送 `StreamableHttp URL` / `JSON Config`
+
+当用户提供 URL 或 JSON Config 后，提取 `url` 并执行：
+
+```bash
+mcporter config add wecom-doc --type streamable-http --url "<url>"
+```
+
+配置完成后重新执行 `mcporter list wecom-doc --output json`，然后继续用户原始请求。
+
+## 调用规则
+
+- 所有请求必须通过 `mcporter call wecom-doc.<tool> --args '{...}' --output json` 执行
+- 先用 `mcporter list wecom-doc --output json` 读取实际 tool 列表，不要硬编码 tool 名称和参数结构
+- `create_doc` 返回的 `docid` 要保存在当前会话里，后续编辑操作依赖它
+- 如果用户要编辑已有文档，但当前会话里没有机器人创建时返回的 `docid`，直接输出：
+
+> 仅支持对机器人创建的文档进行编辑
+
+## 文档工作流
+
+### 新建普通文档
+
+1. 调用 `create_doc`，传 `doc_type: 3`
+2. 保存返回的 `docid`
+3. 如需写内容，调用 `edit_doc_content`
+
+### 新建智能表格
+
+1. 调用 `create_doc`，传 `doc_type: 10`
+2. 保存返回的 `docid`
+3. 根据需要继续调用智能表格相关 tool
+
+## 错误处理
+
+- 如果 `mcporter call` 返回 `help_message`，优先把其中面向用户的说明直接输出给用户
+- 如果返回 `850001`，说明还需要用户提供配置或授权，按上面的配置引导继续处理
+- 如果返回 `daemon not running` 或 `connection refused`，提示用户先执行：
+
+```bash
+mcporter daemon start
+```