@marshulll/openclaw-wecom 0.1.20 → 0.1.22

package/README.en.md

@@ -10,9 +10,10 @@ OpenClaw WeCom plugin supporting **Bot API mode** and **Internal App mode** with
 - Dual mode: Bot API (JSON callback + stream) / App (XML callback + ACK + proactive send)
 - Multi-account: `channels.wecom.accounts`
 - Message types: text / image / voice / video / file (send & receive)
-- Commands: `/help`, `/status`, `/clear`
+- Commands: `/help`, `/status`, `/clear`, `/sendfile`
 - Stability: signature verification, AES decrypt, token cache, rate limit & retries
 - Group chat: uses `appchat/send` when `chatId` is present
+- Advanced: folder zip sending, send queue, operation logs, media auto recognition
 
 ## Install
 ### npm
@@ -88,6 +89,20 @@ Install guide: `docs/INSTALL.md`
 - Bot mode media bridge: if reply payload includes `mediaUrl + mediaType`,
   and App credentials are present, media will be uploaded and sent
 
+## Extra commands
+- `/sendfile`: send files from server (multiple absolute paths)
+  - Directories are zipped automatically
+  - Example: `/sendfile /tmp/openclaw-wecom /home/shu/Desktop/report.pdf`
+
+## Media auto recognition (optional)
+- **Voice send/receive does NOT require API**; only auto transcription needs an OpenAI-compatible API
+- **Video recognition requires ffmpeg** (install on server, then set `media.auto.video.enabled = true`)
+- Small text files can be previewed automatically
+
+## Send queue & operation logs (optional)
+- `sendQueue.intervalMs`: delay between /sendfile items to avoid rate limit
+- `operations.logPath`: JSONL log for file sending and push actions
+
 ## Troubleshooting
 - Callback verification failed: check Token / AESKey / URL
 - No reply: ensure plugin enabled and gateway restarted

package/README.md

@@ -10,9 +10,10 @@ OpenClaw WeCom 插件，支持 **智能机器人 API 模式** 与 **自建应用
 - 双模式：Bot API（JSON 回调 + stream）/ App（XML 回调 + ACK + 主动发送）
 - 多账户：`channels.wecom.accounts`
 - 消息类型：文本 / 图片 / 语音 / 视频 / 文件（收发均支持）
-- 机器人命令：`/help`、`/status`、`/clear`
+- 机器人命令：`/help`、`/status`、`/clear`、`/sendfile`
 - 稳定性：签名校验、AES 解密、token 缓存、限流与重试
 - 群聊：自动识别 `chatId` 并使用 `appchat/send`
+- 进阶：文件夹打包发送、发送队列、操作日志、多媒体自动识别
 
 ## 安装
 ### npm 安装
@@ -90,6 +91,20 @@ openclaw gateway restart
 - Bot 模式媒体桥接：当 reply payload 含 `mediaUrl + mediaType` 时，
   若已配置 App 凭据，会自动上传并发送媒体
 
+## 命令补充
+- `/sendfile`：发送服务器文件（支持多个绝对路径）
+  - 支持目录：自动打包为 zip 后发送
+  - 示例：`/sendfile /tmp/openclaw-wecom /home/shu/Desktop/report.pdf`
+
+## 多媒体自动识别（可选）
+- **语音收发不需要 API**，只有开启“语音自动转写”才需要 OpenAI 兼容接口
+- **视频识别需要 ffmpeg**（服务器已安装后，将 `media.auto.video.enabled` 设为 `true`）
+- 文本文件可自动预览（小文件直接读入）
+
+## 发送队列与操作日志（可选）
+- `sendQueue.intervalMs`：/sendfile 多文件发送间隔（防止限流）
+- `operations.logPath`：记录发送文件/主动推送（JSONL）
+
 ## 常见问题
 - 回调验证失败：检查 Token / AESKey / URL 是否一致
 - 没有回复：确认已启用插件并重启 gateway

package/README.zh.md

@@ -10,9 +10,10 @@ OpenClaw WeCom 插件，支持 **智能机器人 API 模式** 与 **自建应用
 - 双模式：Bot API（JSON 回调 + stream）/ App（XML 回调 + ACK + 主动发送）
 - 多账户：`channels.wecom.accounts`
 - 消息类型：文本 / 图片 / 语音 / 视频 / 文件（收发均支持）
-- 机器人命令：`/help`、`/status`、`/clear`
+- 机器人命令：`/help`、`/status`、`/clear`、`/sendfile`
 - 稳定性：签名校验、AES 解密、token 缓存、限流与重试
 - 群聊：自动识别 `chatId` 并使用 `appchat/send`
+- 进阶：文件夹打包发送、发送队列、操作日志、多媒体自动识别
 
 ## 安装
 ### npm 安装
@@ -90,6 +91,20 @@ openclaw gateway restart
 - Bot 模式媒体桥接：当 reply payload 含 `mediaUrl + mediaType` 时，
   若已配置 App 凭据，会自动上传并发送媒体
 
+## 命令补充
+- `/sendfile`：发送服务器文件（支持多个绝对路径）
+  - 支持目录：自动打包为 zip 后发送
+  - 示例：`/sendfile /tmp/openclaw-wecom /home/shu/Desktop/report.pdf`
+
+## 多媒体自动识别（可选）
+- **语音收发不需要 API**，只有开启“语音自动转写”才需要 OpenAI 兼容接口
+- **视频识别需要 ffmpeg**（服务器已安装后，将 `media.auto.video.enabled` 设为 `true`）
+- 文本文件可自动预览（小文件直接读入）
+
+## 发送队列与操作日志（可选）
+- `sendQueue.intervalMs`：/sendfile 多文件发送间隔（防止限流）
+- `operations.logPath`：记录发送文件/主动推送（JSONL）
+
 ## 常见问题
 - 回调验证失败：检查 Token / AESKey / URL 是否一致
 - 没有回复：确认已启用插件并重启 gateway

package/docs/INSTALL.md

@@ -127,6 +127,25 @@ openclaw gateway restart
 - Bot 模式 `receiveId`：建议填写 **Bot ID（aibotid）**，用于回调加解密校验；不填也可通过，但会降低校验严格性。
 - App 模式回调解密使用 **CorpID**（即 `corpId`），与 Bot 模式的 `receiveId` 无关。
 
+## 高级能力（可选）
+### /sendfile（文件与文件夹）
+- `/sendfile` 仅支持 **服务器绝对路径**
+- 目录会自动打包为 zip 再发送
+
+示例：
+```
+/sendfile /tmp/openclaw-wecom /home/shu/Desktop/report.pdf
+```
+
+### 多媒体自动识别
+- **语音收发不需要 API**；只有开启“语音自动转写”才需要 OpenAI 兼容接口
+- **视频识别需要 ffmpeg**（服务器安装后将 `media.auto.video.enabled=true`）
+- 文本文件可自动预览（小文件直接读入）
+
+### 发送队列与操作日志
+- `sendQueue.intervalMs`：/sendfile 多文件发送间隔
+- `operations.logPath`：JSONL 日志，记录发送文件与主动推送
+
 ## Webhook 验证
 - Bot 模式与 App 模式都要求公网 HTTPS。
 - 在企业微信后台配置回调 URL。

package/docs/wecom.config.full.example.json

@@ -37,7 +37,7 @@
             "maxBytes": 5242880
           },
           "video": {
-            "enabled": false,
+            "enabled": true,
             "ffmpegPath": "ffmpeg",
             "maxBytes": 104857600
           }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@marshulll/openclaw-wecom",
-  "version": "0.1.20",
+  "version": "0.1.22",
   "type": "module",
   "description": "OpenClaw WeCom channel plugin (intelligent bot + internal app)",
   "author": "OpenClaw",

package/wecom/src/media-vision.ts

@@ -56,43 +56,52 @@ export async function describeImageWithVision(params: {
     return null;
   }
 
-  const controller = new AbortController();
-  const timeout = setTimeout(() => controller.abort(), config.timeoutMs ?? 15000);
+  const imageBase64 = buffer.toString("base64");
+  const payload = {
+    model: config.model,
+    messages: [
+      {
+        role: "user",
+        content: [
+          { type: "text", text: config.prompt },
+          { type: "image_url", image_url: { url: `data:${mimeType};base64,${imageBase64}` } },
+        ],
+      },
+    ],
+    max_tokens: config.maxTokens ?? 400,
+  };
 
-  try {
-    const imageBase64 = buffer.toString("base64");
-    const payload = {
-      model: config.model,
-      messages: [
-        {
-          role: "user",
-          content: [
-            { type: "text", text: config.prompt },
-            { type: "image_url", image_url: { url: `data:${mimeType};base64,${imageBase64}` } },
-          ],
+  for (let attempt = 0; attempt < 2; attempt += 1) {
+    const controller = new AbortController();
+    const timeout = setTimeout(() => controller.abort(), config.timeoutMs ?? 15000);
+    try {
+      const res = await fetch(`${config.baseUrl}/chat/completions`, {
+        method: "POST",
+        headers: {
+          "Content-Type": "application/json",
+          Authorization: `Bearer ${config.apiKey}`,
         },
-      ],
-      max_tokens: config.maxTokens ?? 400,
-    };
-
-    const res = await fetch(`${config.baseUrl}/chat/completions`, {
-      method: "POST",
-      headers: {
-        "Content-Type": "application/json",
-        Authorization: `Bearer ${config.apiKey}`,
-      },
-      body: JSON.stringify(payload),
-      signal: controller.signal,
-    });
+        body: JSON.stringify(payload),
+        signal: controller.signal,
+      });
 
-    if (!res.ok) return null;
-    const data = await res.json() as any;
-    const content = data?.choices?.[0]?.message?.content;
-    if (typeof content !== "string") return null;
-    return content.trim() || null;
-  } catch {
-    return null;
-  } finally {
-    clearTimeout(timeout);
+      if (!res.ok) {
+        continue;
+      }
+      const data = await res.json() as any;
+      const content = data?.choices?.[0]?.message?.content;
+      if (typeof content !== "string") {
+        continue;
+      }
+      const trimmed = content.trim();
+      if (!trimmed) continue;
+      return trimmed;
+    } catch {
+      // retry once
+    } finally {
+      clearTimeout(timeout);
+    }
   }
+
+  return null;
 }

package/wecom/src/wecom-app.ts

@@ -695,6 +695,14 @@ async function processAppMessage(params: {
               createdAt: Date.now(),
               size: buffer.length,
             });
+            if (visionConfig && !summary) {
+              await appendOperationLog(target, {
+                action: "vision-image-failed",
+                accountId: target.account.accountId,
+                path: tempImagePath,
+                size: buffer.length,
+              });
+            }
             logVerbose(target, `app image saved (${buffer.length} bytes): ${tempImagePath}`);
             if (summary) {
               messageText = `[用户发送了一张图片]\n\n[图片识别结果]\n${summary}\n\n请根据识别结果回复用户。`;