@wecom/wecom-openclaw-plugin 2026.3.20-beta.4 → 2026.3.20-beta.7

package/dist/src/const.d.ts

@@ -28,8 +28,10 @@ export declare const REPLY_SEND_TIMEOUT_MS = 15000;
 export declare const MESSAGE_PROCESS_TIMEOUT_MS: number;
 /** WebSocket 心跳间隔（毫秒） */
 export declare const WS_HEARTBEAT_INTERVAL_MS = 30000;
-/** WebSocket 最大重连次数 */
-export declare const WS_MAX_RECONNECT_ATTEMPTS = 100;
+/** WebSocket 连接断开时的最大重连次数 */
+export declare const WS_MAX_RECONNECT_ATTEMPTS = 10;
+/** WebSocket 认证失败时的最大重试次数 */
+export declare const WS_MAX_AUTH_FAILURE_ATTEMPTS = 5;
 /** messageStates Map 条目的最大 TTL（毫秒），防止内存泄漏 */
 export declare const MESSAGE_STATE_TTL_MS: number;
 /** messageStates Map 清理间隔（毫秒） */

package/dist/src/interface.d.ts

@@ -12,6 +12,8 @@ export type WeComMonitorOptions = {
     config: OpenClawConfig;
     runtime: RuntimeEnv;
     abortSignal?: AbortSignal;
+    /** 框架层提供的状态更新回调，用于在致命错误场景中标记 channel 已停止 */
+    setStatus?: (next: Record<string, unknown>) => void;
 };
 /**
  * 消息状态

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wecom/wecom-openclaw-plugin",
-  "version": "2026.3.20-beta.4",
+  "version": "2026.3.20-beta.7",
   "type": "module",
   "main": "dist/index.cjs.js",
   "module": "dist/index.esm.js",
@@ -57,6 +57,6 @@
   },
   "dependencies": {
     "file-type": "^21.3.0",
-    "@wecom/aibot-node-sdk": "^1.0.3"
+    "@wecom/aibot-node-sdk": "^1.0.4"
   }
 }

package/skills/wecom-msg/SKILL.md

@@ -71,6 +71,11 @@ metadata:
    - 精确匹配：显示username
    - 无匹配：保持显示userid
 
+### 强制交互步骤（不可跳过）
+以下步骤在涉及非文本消息下载时**必须逐一执行**，不得合并、省略或跳过，即使用户未主动询问也必须执行：
+1. **必须主动告知文件位置**：下载完成后必须立即向用户展示所有文件的完整路径和存放目录
+2. **必须询问是否删除**：告知位置后必须立即询问用户是否需要清理临时文件
+
 ---
 
 ## 典型工作流
@@ -113,16 +118,16 @@ metadata:
      - 补全或修正后缀后，将文件重命名为正确的文件名
      - 确认文件可正常读取（文件大小 > 0），若文件为空或损坏则告知用户该文件下载异常
    - ⚠️ **不要对下载的文件使用 `MEDIA:` 指令**：这些文件是从聊天记录中下载的历史附件，仅需告知用户本地存放路径即可，**严禁**通过 `MEDIA:` 指令重新发送给用户
-   - ⚠️ **必须主动告知文件位置**（此步骤不可省略）：所有文件下载并检查完成后，**必须立即、主动**以汇总形式向用户展示文件存放目录和每个文件的完整路径，不要等用户询问。示例：
-     > 📁 文件已下载到以下位置：
-     > - 图片：`/tmp/wecom_media/screenshot.png`
-     > - 文件：`/tmp/wecom_media/report.pdf`
-     >
-     > 你可以在 `/tmp/wecom_media/` 目录下找到所有下载的文件。
-   - ⚠️**询问是否删除**（此步骤不可省略）：告知文件位置后，**必须立即、主动**询问用户是否需要删除已下载的临时文件（如："如果不再需要这些文件，是否需要我帮你清理？"）
-     - 用户确认删除后，删除 `local_path` 对应的文件
-     - 用户不需要删除则保留文件
-8. 若 `next_cursor` 不为空，告知用户还有更多消息可继续查看
+8. ⚠️ **必须主动告知文件位置**（此步骤不可跳过）：所有文件下载并检查完成后，**必须立即、主动**以汇总形式向用户展示文件存放目录和每个文件的完整路径，不要等用户询问。示例：
+   > 📁 文件已下载到以下位置：
+   > - 图片：`xxx/yyy.png`
+   > - 文件：`xxx/yyy.pdf`
+   >
+   > 你可以在 `xxx/yyy/` 目录下找到所有下载的文件。
+9. ⚠️ **必须询问是否删除**（此步骤不可跳过）：告知文件位置后，**必须立即、主动**询问用户是否需要删除已下载的临时文件（如："如果不再需要这些文件，是否需要我帮你清理？"）
+   - 用户确认删除后，删除 `local_path` 对应的文件
+   - 用户不需要删除则保留文件
+10. 若 `next_cursor` 不为空，告知用户还有更多消息可继续查看
 
 ### 发送消息
 **用户query示例**：

package/skills/wecom-msg/references/api-get-msg-media.md

@@ -36,7 +36,7 @@
         "media_id": "MEDIAID_xxxxxx",
         "name": "screenshot.png",
         "type": "image",
-        "local_path": "/tmp/wecom_media/screenshot.png",
+        "local_path": "xxx/yyy/screenshot.png",
         "size": 102400,
         "content_type": "image/png"
     }

package/skills/wecom-send-media/SKILL.md

@@ -36,16 +36,17 @@ MEDIA: <文件的绝对路径>
 
 ## 文件大小与格式限制
 
-| 类型 | 大小上限 | 格式要求 |
-|------|----------|----------|
-| 图片 | 10 MB | 常见图片格式均可 |
-| 视频 | 10 MB | 常见视频格式均可 |
-| 语音 | 2 MB | **仅支持 AMR 格式**（`.amr`） |
-| 文件 | 20 MB | 不限 |
+| 类型 | 大小上限 | 格式要求 | 备注 |
+|------|----------|----------|------|
+| 图片 | 10 MB | 常见图片格式均可 | openclaw 默认会对图片进行压缩处理 |
+| 视频 | 10 MB | 常见视频格式均可 | |
+| 语音 | 2 MB | **仅支持 AMR 格式**（`.amr`） | |
+| 文件 | 20 MB | 不限 | |
 
-⚠️ 重要：请务必**先检查文件大小和格式**是否满足要求。如果不满足要求，请主动告知用户以下”降级与限制处理“措施：
+⚠️ 重要：请务必**先检查文件大小和格式**是否满足要求。如果不满足要求，请主动告知用户以下“降级与限制处理”措施：
 
-- **自动降级**：当图片、视频或语音超过各自的大小限制时，系统会自动将其转为文件消息发送，请主动告诉用户。
+- **图片压缩情况**：openclaw 默认会对图片进行压缩处理。如果本地图片（原图）大小超过上限，经过压缩后不一定会超过上限。因此当你检测到本地图片大小超过上限时，务必要告诉用户这个特殊情况。
+- **自动降级**：视频或语音类型的文件，超过各自的大小限制时，系统会自动将其转为文件消息发送，请主动告诉用户。
 - **硬性上限**：文件大小超过 20 MB 时无法发送。请主动告知用户，并尝试压缩或拆分文件后再发送。
 - **语音格式**：语音消息仅支持 AMR 格式（`.amr`）。非 AMR 格式的音频文件将以文件消息的形式发送。
 - **发送耗时**：文件发送涉及系统处理，可能耗时较长。发送含 `MEDIA:` 指令的消息 30 秒后，请主动检查文件是否已成功发送。如果没有请重试。