@marshulll/openclaw-wecom 0.1.23 → 0.1.24

package/README.en.md

@@ -93,6 +93,7 @@ Install guide: `docs/INSTALL.md`
 - `/sendfile`: send files from server (multiple absolute paths)
   - Directories are zipped automatically
   - Example: `/sendfile /tmp/openclaw-wecom /home/shu/Desktop/report.pdf`
+  - Natural language also works: "send me this file image-xxx.jpg" (default match in `media.tempDir`)
 
 ## Media auto recognition (optional)
 - **Voice send/receive does NOT require API**; only auto transcription needs an OpenAI-compatible API

package/README.md

@@ -95,6 +95,7 @@ openclaw gateway restart
 - `/sendfile`：发送服务器文件（支持多个绝对路径）
   - 支持目录：自动打包为 zip 后发送
   - 示例：`/sendfile /tmp/openclaw-wecom /home/shu/Desktop/report.pdf`
+  - 也支持自然语言：`把这个文件发给我 image-xxx.jpg`（默认仅在 `media.tempDir` 内匹配）
 
 ## 多媒体自动识别（可选）
 - **语音收发不需要 API**，只有开启“语音自动转写”才需要 OpenAI 兼容接口

package/README.zh.md

@@ -95,6 +95,7 @@ openclaw gateway restart
 - `/sendfile`：发送服务器文件（支持多个绝对路径）
   - 支持目录：自动打包为 zip 后发送
   - 示例：`/sendfile /tmp/openclaw-wecom /home/shu/Desktop/report.pdf`
+  - 也支持自然语言：`把这个文件发给我 image-xxx.jpg`（默认仅在 `media.tempDir` 内匹配）
 
 ## 多媒体自动识别（可选）
 - **语音收发不需要 API**，只有开启“语音自动转写”才需要 OpenAI 兼容接口

package/docs/INSTALL.md

@@ -131,6 +131,7 @@ openclaw gateway restart
 ### /sendfile（文件与文件夹）
 - `/sendfile` 仅支持 **服务器绝对路径**
 - 目录会自动打包为 zip 再发送
+- 自然语言也可触发：`把这个文件发给我 image-xxx.jpg`（默认仅在 `media.tempDir` 内匹配）
 
 示例：
 ```

package/package.json

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

package/wecom/src/wecom-app.ts

@@ -130,6 +130,139 @@ function sleep(ms: number): Promise<void> {
   return new Promise((resolve) => setTimeout(resolve, ms));
 }
 
+function resolveSendIntervalMs(target: WecomWebhookTarget): number {
+  const interval = target.account.config.sendQueue?.intervalMs;
+  return typeof interval === "number" && interval >= 0 ? interval : 400;
+}
+
+function extractFilenameCandidates(text: string): string[] {
+  const candidates = new Set<string>();
+  const normalized = text.replace(/[，,；;|]/g, " ");
+  const regex = /(?:\/|file:\/\/)?[A-Za-z0-9._-]+\.[A-Za-z0-9]{1,8}/g;
+  for (const match of normalized.matchAll(regex)) {
+    const value = match[0];
+    if (value) candidates.add(value.replace(/^file:\/\//, ""));
+  }
+  return Array.from(candidates);
+}
+
+async function tryHandleNaturalFileSend(params: {
+  target: WecomWebhookTarget;
+  text: string;
+  fromUser: string;
+  chatId?: string;
+  isGroup: boolean;
+}): Promise<boolean> {
+  const { target, text, fromUser, chatId, isGroup } = params;
+  if (!text || text.trim().startsWith("/")) return false;
+  if (!/(发给我|发送给我|发我|给我)/.test(text)) return false;
+  const names = extractFilenameCandidates(text);
+  if (names.length === 0) return false;
+
+  const tempDir = resolveMediaTempDir(target);
+  let dirEntries: string[] = [];
+  try {
+    dirEntries = await readdir(tempDir);
+  } catch {
+    dirEntries = [];
+  }
+  const dirSet = new Set(dirEntries);
+
+  const resolved: string[] = [];
+  const missing: string[] = [];
+  for (const name of names) {
+    let fullPath = "";
+    if (name.startsWith("/")) {
+      fullPath = name;
+    } else if (dirSet.has(name)) {
+      fullPath = join(tempDir, name);
+    }
+    if (!fullPath) {
+      missing.push(name);
+      continue;
+    }
+    try {
+      const info = await stat(fullPath);
+      if (info.isFile()) {
+        resolved.push(fullPath);
+      } else {
+        missing.push(name);
+      }
+    } catch {
+      missing.push(name);
+    }
+  }
+
+  if (resolved.length === 0) {
+    const hint = dirEntries.length ? `可用文件示例：${dirEntries.slice(0, 5).join(", ")}` : "当前目录无可用文件";
+    await sendWecomText({
+      account: target.account,
+      toUser: fromUser,
+      chatId: isGroup ? chatId : undefined,
+      text: `未找到指定文件：${missing.join(", ")}。\n${hint}`,
+    });
+    return true;
+  }
+
+  const maxBytes = resolveMediaMaxBytes(target);
+  const intervalMs = resolveSendIntervalMs(target);
+  let sent = 0;
+  const failed: string[] = [];
+
+  for (const path of resolved) {
+    try {
+      const info = await stat(path);
+      if (maxBytes && info.size > maxBytes) {
+        failed.push(`${basename(path)}(过大)`);
+        continue;
+      }
+      const buffer = await readFile(path);
+      const filename = basename(path) || "file.bin";
+      const mediaId = await uploadWecomMedia({
+        account: target.account,
+        type: "file",
+        buffer,
+        filename,
+      });
+      await sendWecomFile({
+        account: target.account,
+        toUser: fromUser,
+        chatId: isGroup ? chatId : undefined,
+        mediaId,
+      });
+      sent += 1;
+      await appendOperationLog(target, {
+        action: "natural-sendfile",
+        accountId: target.account.accountId,
+        toUser: fromUser,
+        chatId,
+        path,
+        size: info.size,
+      });
+      if (intervalMs) await sleep(intervalMs);
+    } catch (err) {
+      failed.push(basename(path));
+      await appendOperationLog(target, {
+        action: "natural-sendfile",
+        accountId: target.account.accountId,
+        toUser: fromUser,
+        chatId,
+        path,
+        error: String(err),
+      });
+    }
+  }
+
+  const summary = `已发送 ${sent} 个文件${failed.length ? `，失败：${failed.join(", ")}` : ""}${missing.length ? `，未找到：${missing.join(", ")}` : ""}`;
+  await sendWecomText({
+    account: target.account,
+    toUser: fromUser,
+    chatId: isGroup ? chatId : undefined,
+    text: summary,
+  });
+  return true;
+}
+
 async function appendOperationLog(target: WecomWebhookTarget, entry: Record<string, unknown>): Promise<void> {
   const logPath = target.account.config.operations?.logPath?.trim();
   if (!logPath) return;
@@ -861,6 +994,17 @@ async function processAppMessage(params: {
     if (handled) return;
   }
 
+  if (msgType === "text") {
+    const handled = await tryHandleNaturalFileSend({
+      target,
+      text: messageText,
+      fromUser,
+      chatId,
+      isGroup,
+    });
+    if (handled) return;
+  }
+
   try {
     await startAgentForApp({
       target,