ylib-wecom-openclaw-plugin 2026.4.29

package/skills/wecom-meeting/references/example-security.md

@@ -0,0 +1,22 @@
+# 创建会议 - 安全设置场景示例
+
+## 场景 4: 会议密码 + 等候室 + 主持人设置
+
+**用户意图**: "帮我创建一个重要的客户汇报会议, 需要设置密码1234, 开启等候室, 不允许外部人员入会"
+
+```json
+{
+  "title": "客户汇报会议",
+  "meeting_start_datetime": "2026-03-19 14:00",
+  "meeting_duration": 5400,
+  "invitees": {
+    "userid": ["zhangsan", "lisi", "wangwu"]
+  },
+  "settings": {
+    "password": "1234",
+    "enable_waiting_room": true,
+    "allow_enter_before_host": false,
+    "allow_external_user": false
+  }
+}
+```

package/skills/wecom-meeting/references/response-get-meeting-info.md

@@ -0,0 +1,148 @@
+# 获取会议详情 (get_meeting_info) - 返回参数
+
+## 返回参数
+
+```json
+{
+  "errcode": 0,
+  "errmsg": "ok",
+  "creator_userid": "创建者userid",
+  "admin_userid": "会议管理userid (与 creator_userid 有且仅返回一个)",
+  "title": "会议标题",
+  "meeting_start_datetime": "YYYY-MM-DD HH:mm",
+  "meeting_duration": "会议时长秒数",
+  "description": "会议描述文本",
+  "location": "会议地点文本",
+  "main_department": "创建者主部门ID",
+  "status": "会议状态枚举值",
+  "meeting_type": "会议类型枚举值",
+  "attendees": {
+    "member": [
+      {
+        "userid": "内部成员userid",
+        "status": "与会状态枚举值",
+        "first_join_datetime": "YYYY-MM-DD HH:mm",
+        "last_quit_datetime": "YYYY-MM-DD HH:mm",
+        "total_join_count": "加入次数",
+        "cumulative_time": "累计在会时长秒数"
+      }
+    ],
+    "tmp_external_user": [
+      {
+        "tmp_external_userid": "外部临时用户ID",
+        "status": "与会状态枚举值",
+        "first_join_datetime": "YYYY-MM-DD HH:mm",
+        "last_quit_datetime": "YYYY-MM-DD HH:mm",
+        "total_join_count": "加入次数",
+        "cumulative_time": "累计在会时长秒数"
+      }
+    ]
+  },
+  "settings": {
+    "remind_scope": "提醒范围枚举值",
+    "need_password": "是否需要密码布尔值",
+    "password": "会议密码",
+    "enable_waiting_room": "是否启用等候室布尔值",
+    "allow_enter_before_host": "是否允许提前入会布尔值",
+    "enable_enter_mute": "入会静音枚举值",
+    "allow_unmute_self": "是否允许自我解除静音布尔值",
+    "allow_external_user": "是否允许外部用户布尔值",
+    "enable_screen_watermark": "是否开启水印布尔值",
+    "watermark_type": "水印类型枚举值",
+    "auto_record_type": "录制类型枚举字符串",
+    "attendee_join_auto_record": "参会者加入自动录制布尔值",
+    "enable_host_pause_auto_record": "主持人可暂停录制布尔值",
+    "enable_doc_upload_permission": "允许上传文档布尔值",
+    "enable_enroll": "是否开启报名布尔值",
+    "enable_host_key": "是否启用主持人密钥布尔值",
+    "host_key": "主持人密钥字符串",
+    "hosts": {"userid": ["主持人userid列表"]},
+    "current_hosts": {"userid": ["当前主持人userid列表"]},
+    "co_hosts": {"userid": ["联席主持人userid列表"]},
+    "ring_users": {"userid": ["响铃用户userid列表"]}
+  },
+  "meeting_code": "会议号码字符串",
+  "meeting_link": "会议链接URL",
+  "has_vote": "是否有投票布尔值",
+  "has_more_sub_meeting": "是否还有更多子会议枚举值",
+  "remain_sub_meetings": "剩余子会议场数",
+  "current_sub_meetingid": "当前子会议ID",
+  "guests": [
+    {
+      "area": "国际区号",
+      "phone_number": "手机号字符串",
+      "guest_name": "嘉宾姓名"
+    }
+  ],
+  "reminders": {
+    "is_repeat": "是否周期性枚举值",
+    "repeat_type": "重复类型枚举值",
+    "repeat_until_type": "结束类型枚举值",
+    "repeat_until_count": "限定次数",
+    "repeat_until_datetime": "YYYY-MM-DD HH:mm",
+    "repeat_interval": "重复间隔数值",
+    "is_custom_repeat": "是否自定义重复枚举值",
+    "repeat_day_of_week": ["星期几数组"],
+    "repeat_day_of_month": ["日期数组"],
+    "remind_before": ["提醒秒数数组"]
+  },
+  "sub_meetings": [
+    {
+      "sub_meetingid": "子会议ID",
+      "status": "子会议状态枚举值",
+      "start_datetime": "YYYY-MM-DD HH:mm",
+      "end_datetime": "YYYY-MM-DD HH:mm",
+      "title": "子会议标题",
+      "repeat_id": "周期性会议分段ID"
+    }
+  ],
+  "sub_repeat_list": [
+    {
+      "repeat_id": "周期性会议分段ID",
+      "repeat_type": "重复类型枚举值",
+      "repeat_until_type": "结束类型枚举值",
+      "repeat_until_count": "限定次数",
+      "repeat_until_datetime": "YYYY-MM-DD HH:mm",
+      "repeat_interval": "重复间隔数值",
+      "is_custom_repeat": "是否自定义重复枚举值",
+      "repeat_day_of_week": ["星期几数组"],
+      "repeat_day_of_month": ["日期数组"]
+    }
+  ]
+}
+```
+
+## 关键返回字段
+
+| 字段                                    | 类型    | 说明                                                                                                          |
+| --------------------------------------- | ------- | ------------------------------------------------------------------------------------------------------------- |
+| `creator_userid`                        | string  | 创建者 userid，与 `admin_userid` 有且仅返回一个                                                               |
+| `admin_userid`                          | string  | 会议管理 userid，与 `creator_userid` 有且仅返回一个                                                           |
+| `title`                                 | string  | 会议标题                                                                                                      |
+| `meeting_start_datetime`                | string  | 会议开始时间                                                                                                  |
+| `meeting_duration`                      | integer | 会议时长 (秒)                                                                                                 |
+| `main_department`                       | integer | 创建者所属主部门                                                                                              |
+| `status`                                | integer | 会议状态 (1: 待开始，2: 会议中，3: 已结束，4: 已取消，5: 已过期)                                              |
+| `meeting_type`                          | integer | 会议类型 (0: 一次性会议，1: 周期性会议，2: 微信专属会议，3: Rooms 投屏会议，5: 个人会议号会议，6: 网络研讨会) |
+| `meeting_code`                          | string  | 会议号码                                                                                                      |
+| `meeting_link`                          | string  | 会议链接                                                                                                      |
+| `attendees.member`                      | array   | 内部参与者列表                                                                                                |
+| `attendees.member[].status`             | integer | 与会状态 (1: 已参与，2: 未参与)                                                                               |
+| `attendees.tmp_external_user`           | array   | 外部参与者 (临时 ID)                                                                                          |
+| `attendees.tmp_external_user[].status`  | integer | 与会状态 (1: 已参与，2: 未参与)                                                                               |
+| `guests`                                | array   | 外部嘉宾列表，每项含 `area`，`phone_number`，`guest_name`                                                     |
+| `current_sub_meetingid`                 | string  | 当前子会议 ID                                                                                                 |
+| `settings.ring_users`                   | object  | 响铃用户列表                                                                                                  |
+| `settings.need_password`                | boolean | 是否需要密码 (只读字段)                                                                                       |
+| `settings.enable_doc_upload_permission` | boolean | 是否允许成员上传文档                                                                                          |
+| `settings.hosts`                        | object  | 主持人列表                                                                                                    |
+| `settings.current_hosts`                | object  | 当前主持人列表                                                                                                |
+| `settings.co_hosts`                     | object  | 联席主持人列表                                                                                                |
+| `reminders`                             | object  | 周期性配置                                                                                                    |
+| `has_vote`                              | boolean | 是否有投票 (仅会议创建人和主持人有权限查询)                                                                   |
+| `has_more_sub_meeting`                  | integer | 是否还有更多子会议特例 (0: 无更多，1: 有更多)                                                                 |
+| `remain_sub_meetings`                   | integer | 剩余子会议场数                                                                                                |
+| `sub_meetings`                          | array   | 子会议列表                                                                                                    |
+| `sub_meetings[].status`                 | integer | 子会议状态 (0: 默认/存在，1: 已删除)                                                                          |
+| `sub_meetings[].repeat_id`              | string  | 周期性会议分段 ID，用于关联子会议所属分段                                                                     |
+| `sub_repeat_list`                       | array   | 周期性会议分段信息，修改周期性会议某一场后可能产生不同分段，各分段有不同重复规则                              |

package/skills/wecom-msg/SKILL.md

@@ -0,0 +1,157 @@
+---
+name: wecom-msg
+description: 企业微信消息技能。提供会话列表查询、消息记录拉取（支持文本/图片/文件/语音/视频）、多媒体文件获取和文本消息发送能力。当用户需要"查看消息"、"看聊天记录"、"发消息给某人"、"最近有什么消息"、"给群里发消息"、"看看发了什么图片/文件"时触发。
+metadata:
+  {
+    "openclaw": { "emoji": "💬" },
+  }
+---
+
+# 企业微信消息技能
+
+> `wecom_mcp` 是一个 MCP tool，所有操作通过调用该 tool 完成。
+
+> ⚠️ **前置条件**：首次调用 `wecom_mcp` 前，必须按 `wecom-preflight` 技能执行前置条件检查，确保工具已加入白名单。
+
+通过 `wecom_mcp call msg <接口名> '<json入参>'` 与企业微信消息系统交互。
+
+---
+
+## 接口列表
+
+### get_msg_chat_list — 获取会话列表
+
+使用 `wecom_mcp` tool 调用 `wecom_mcp call msg get_msg_chat_list '{"begin_time": "2026-03-11 00:00:00", "end_time": "2026-03-17 23:59:59"}'`
+
+按时间范围查询有消息的会话列表，支持分页。参见 [API 详情](references/api-get-msg-chat-list.md)。
+
+### get_message — 拉取会话消息
+
+使用 `wecom_mcp` tool 调用 `wecom_mcp call msg get_message '{"chat_type": 1, "chatid": "zhangsan", "begin_time": "2026-03-17 09:00:00", "end_time": "2026-03-17 18:00:00"}'`
+
+根据会话类型和 ID 拉取指定时间范围内的消息记录，支持分页。支持 text/image/file/voice/video 消息类型，仅支持 7 天内。参见 [API 详情](references/api-get-messages.md)。
+
+### get_msg_media — 获取消息文件内容
+
+使用 `wecom_mcp` tool 调用 `wecom_mcp call msg get_msg_media '{"media_id": "MEDIAID_xxxxxx"}'`
+
+根据文件 ID 自动下载文件到本地，返回文件的本地路径（`local_path`）、名称、类型、大小及 MIME 类型。用于获取图片、文件、语音、视频等非文本消息的实际内容。参见 [API 详情](references/api-get-msg-media.md)。
+
+### send_message — 发送文本消息
+
+使用 `wecom_mcp` tool 调用 `wecom_mcp call msg send_message '{"chat_type": 1, "chatid": "zhangsan", "msgtype": "text", "text": {"content": "hello world"}}'`
+
+向单聊或群聊发送文本消息。参见 [API 详情](references/api-send-message.md)。
+
+---
+
+## 核心规则
+
+### 时间范围规则
+- **格式**：所有时间参数使用 `YYYY-MM-DD HH:mm:ss` 格式
+- **默认范围**：用户未指定时，默认使用最近7天（当前时间往前推7天）
+- **限制**：开始时间不能早于当前时间的7天前，不能晚于当前时间
+- **相对时间支持**：支持"昨天"、"最近三天"等自动推算
+
+### chatid查找规则
+- 当用户提供人名或群名而非ID时：
+  1. 调用 `get_msg_chat_list` 获取会话列表（时间范围与目标查询一致）
+  2. 在 `chats` 中按 `chat_name` 匹配
+  3. **匹配策略**：
+     - 精确匹配唯一结果：直接使用
+     - 模糊匹配多个结果：展示候选列表让用户选择
+     - 无匹配结果：告知用户未找到
+- **chat_type 判断**：`get_msg_chat_list` 返回中不含会话类型字段，需根据上下文推断：用户明确提到「群」时使用 `chat_type=2`，否则默认 `chat_type=1`（单聊）
+
+### userid转username
+**流程**：
+1. 调用 `wecom-contact get_userlist` 获取用户列表
+2. 建立userid到username的映射关系
+3. **展示策略**：
+   - 精确匹配：显示username
+   - 无匹配：保持显示userid
+
+### 强制交互步骤（不可跳过）
+以下步骤在涉及非文本消息下载时**必须逐一执行**，不得合并、省略或跳过，即使用户未主动询问也必须执行：
+1. **必须主动告知文件位置**：下载完成后必须立即向用户展示所有文件的完整路径和存放目录
+2. **必须询问是否删除**：告知位置后必须立即询问用户是否需要清理临时文件
+
+---
+
+## 典型工作流
+
+### 查看会话列表
+**用户query示例**：
+- "看看我最近一周有哪些聊天"
+- "这几天谁给我发过消息"
+
+**执行流程**：
+1. 确定时间范围（用户指定或默认最近7天）
+2. 调用 `get_msg_chat_list` 获取会话列表
+3. 展示会话名称、最后消息时间、消息数量
+4. 若 `has_more` 为 `true`，告知用户还有更多会话可继续查看
+
+### 查看聊天记录
+**用户query示例**：
+- "帮我看看和张三最近的聊天记录"
+- "看看项目群里最近的消息"
+
+**执行流程**：
+1. 确定时间范围（用户指定或默认最近7天）
+2. 通过 **chatid查找规则** 确定目标会话的 `chatid` 和 `chat_type`
+3. 调用 `get_message` 拉取消息列表
+4. 调用 `wecom-contact` 的 `get_userlist` 获取通讯录，建立 userid→姓名 映射
+5. **统计非文本消息**：遍历消息列表，统计 `msgtype` 非 `text` 的消息（image/file/voice/video）数量和类型
+6. 展示消息时将 `userid` 替换为可读姓名，格式：
+   - 文本消息：`姓名 [时间]: 内容`
+   - 图片消息：`姓名 [时间]:[图片]`
+   - 文件消息：`姓名 [时间]:[文件] 文件名称`
+   - 语音消息：`姓名 [时间]:[语音] 语音内容`
+   - 视频消息：`姓名 [时间]:[视频]`
+7. **非文本消息处理**：展示完消息后，如果存在非文本消息：
+   - **主动询问是否下载**：告知用户非文本消息数量和类型（如："以上聊天中包含 2 张图片、1 个文件，是否需要下载到本地？"）
+   - 用户确认后，逐个调用 `get_msg_media` 接口，接口会自动下载文件并返回 `local_path`
+   - **检查文件后缀**：每个文件下载完成后，检查 `local_path` 对应的文件是否具有正确的后缀名：
+     - 根据 `get_msg_media` 返回的 `content_type`（MIME 类型）和 `name` 字段判断：
+       - 如果文件名缺少后缀（如 `screenshot` 而非 `screenshot.png`），根据 `content_type` 自动补上正确后缀（如 `image/png` → `.png`，`application/pdf` → `.pdf`，`audio/amr` → `.amr`，`video/mp4` → `.mp4`）
+       - 如果文件名后缀与 `content_type` 不一致，以 `content_type` 为准进行修正
+     - 补全或修正后缀后，将文件重命名为正确的文件名
+     - 确认文件可正常读取（文件大小 > 0），若文件为空或损坏则告知用户该文件下载异常
+   - ⚠️ **不要对下载的文件使用 `MEDIA:` 指令**：这些文件是从聊天记录中下载的历史附件，仅需告知用户本地存放路径即可，**严禁**通过 `MEDIA:` 指令重新发送给用户
+8. ⚠️ **必须主动告知文件位置**（此步骤不可跳过）：所有文件下载并检查完成后，**必须立即、主动**以汇总形式向用户展示文件存放目录和每个文件的完整路径，不要等用户询问。示例：
+   > 📁 文件已下载到以下位置：
+   > - 图片：`xxx/yyy.png`
+   > - 文件：`xxx/yyy.pdf`
+   >
+   > 你可以在 `xxx/yyy/` 目录下找到所有下载的文件。
+9. ⚠️ **必须询问是否删除**（此步骤不可跳过）：告知文件位置后，**必须立即、主动**询问用户是否需要删除已下载的临时文件（如："如果不再需要这些文件，是否需要我帮你清理？"）
+   - 用户确认删除后，删除 `local_path` 对应的文件
+   - 用户不需要删除则保留文件
+10. 若 `next_cursor` 不为空，告知用户还有更多消息可继续查看
+
+### 发送消息
+**用户query示例**：
+- "帮我给张三发一条消息：明天会议改到下午3点"
+- "在项目群里发一条消息：今天下午3点开会"
+
+**执行流程**：
+1. 通过 **chatid查找规则** 确定目标会话的 `chatid` 和 `chat_type`
+2. **发送前确认**：向用户确认发送对象和内容（如："即将向 张三 发送：'明天会议改到下午3点'，确认发送吗？"），用户确认后再执行
+3. 调用 `send_message` 发送（`msgtype` 固定为 `text`）
+4. 展示发送结果
+
+### 查看消息并回复
+**用户query示例**：
+- "看看张三给我发了什么，然后帮我回复收到"
+
+**执行流程**：
+1. 先执行"查看聊天记录"流程（复用已获取的 `chatid` 和 `chat_type`）
+2. 展示消息后，执行"发送消息"流程（需确认后再发送）
+
+---
+
+## 错误处理
+- **时间范围超限**：告知用户7天限制并调整为有效范围
+- **会话未找到**：明确告知用户未找到对应会话
+- **API错误**：展示具体错误信息，必要时重试
+- **网络问题**：HTTP错误时主动重试最多3次`

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

@@ -0,0 +1,93 @@
+# get_message API
+
+根据会话类型和会话 ID，拉取指定时间范围内的消息记录。支持文本、图片、文件、语音、视频类型消息。
+
+## 参数说明
+
+| 参数 | 类型 | 必填 | 说明 |
+|------|------|------|------|
+| `chat_type` | integer | ✅ | 会话类型，`1`-单聊，`2`-群聊 |
+| `chatid` | string | ✅ | 会话 ID，单聊时为 userid，群聊时为群 ID，最大 256 字节 |
+| `begin_time` | string | ✅ | 拉取开始时间，格式：`YYYY-MM-DD HH:mm:ss`，仅支持请求时刻往前 **7 天**内 |
+| `end_time` | string | ✅ | 拉取结束时间，格式：`YYYY-MM-DD HH:mm:ss`，必须 ≥ `begin_time` |
+| `cursor` | string | ❌ | 分页游标，首次请求不传，后续传入上次响应的 `next_cursor`，最大 256 字节 |
+
+## 请求示例
+
+单聊：
+
+使用 `wecom_mcp` tool 调用 `wecom_mcp call msg get_message '{"chat_type": 1, "chatid": "zhangsan", "begin_time": "2026-03-17 09:00:00", "end_time": "2026-03-17 18:00:00"}'`
+
+群聊：
+
+使用 `wecom_mcp` tool 调用 `wecom_mcp call msg get_message '{"chat_type": 2, "chatid": "wrxxxxxxxx", "begin_time": "2026-03-17 09:00:00", "end_time": "2026-03-17 18:00:00"}'`
+
+分页请求：
+
+使用 `wecom_mcp` tool 调用 `wecom_mcp call msg get_message '{"chat_type": 1, "chatid": "zhangsan", "begin_time": "2026-03-17 09:00:00", "end_time": "2026-03-17 18:00:00", "cursor": "CURSOR_xxxxxx"}'`
+
+## 返回字段
+
+| 字段 | 类型 | 说明 |
+|------|------|------|
+| `errcode` | Integer | 返回码，`0` 表示成功 |
+| `errmsg` | String | 错误信息 |
+| `messages` | Array | 消息列表 |
+| `messages[].userid` | String | 消息发送者的 userid |
+| `messages[].send_time` | String | 消息发送时间（北京时间），格式：`YYYY-MM-DD HH:mm:ss` |
+| `messages[].msgtype` | String | 消息类型，`text`-文本消息，`image`-图片消息，`file`-文件消息，`voice`-语音消息，`video`-视频消息 |
+| `messages[].text` | Object | 文本消息内容，`msgtype` 为 `text` 时返回 |
+| `messages[].text.content` | String | 消息内容 |
+| `messages[].image` | Object | 图片消息内容，`msgtype` 为 `image` 时返回 |
+| `messages[].image.media_id` | String | 图片的 media_id，可通过 `get_msg_media` 接口下载 |
+| `messages[].image.name` | String | 图片文件名称 |
+| `messages[].file` | Object | 文件消息内容，`msgtype` 为 `file` 时返回 |
+| `messages[].file.media_id` | String | 文件的 media_id，可通过 `get_msg_media` 接口下载 |
+| `messages[].file.name` | String | 文件名称 |
+| `messages[].voice` | Object | 语音消息内容，`msgtype` 为 `voice` 时返回 |
+| `messages[].voice.media_id` | String | 语音的 media_id，可通过 `get_msg_media` 接口下载 |
+| `messages[].video` | Object | 视频消息内容，`msgtype` 为 `video` 时返回 |
+| `messages[].video.media_id` | String | 视频的 media_id，可通过 `get_msg_media` 接口下载 |
+| `next_cursor` | String | 分页游标，为空表示已拉取完毕 |
+
+## 响应示例
+
+```json
+{
+    "errcode": 0,
+    "errmsg": "ok",
+    "messages": [
+        {
+            "userid": "zhangsan",
+            "send_time": "2026-03-17 09:30:00",
+            "msgtype": "text",
+            "text": {
+                "content": "你好"
+            }
+        },
+        {
+            "userid": "lisi",
+            "send_time": "2026-03-17 09:35:00",
+            "msgtype": "image",
+            "image": {
+                "media_id": "MEDIAID_xxxxxx",
+                "name": "screenshot.png"
+            }
+        },
+        {
+            "userid": "zhangsan",
+            "send_time": "2026-03-17 09:40:00",
+            "msgtype": "file",
+            "file": {
+                "media_id": "MEDIAID_yyyyyy",
+                "name": "report.pdf"
+            }
+        }
+    ],
+    "next_cursor": "CURSOR_xxxxxx"
+}
+```
+
+## 非文本消息处理
+
+当 `msgtype` 为 `image`、`file`、`voice`、`video` 时，消息体中包含 `media_id`。需要调用 [get_msg_media](api-get-msg-media.md) 接口获取文件的本地路径（`local_path`），再进行展示。

package/skills/wecom-msg/references/api-get-msg-chat-list.md

@@ -0,0 +1,58 @@
+# get_msg_chat_list API
+
+获取指定时间范围内有消息的会话列表，支持分页查询。
+
+## 参数说明
+
+| 参数 | 类型 | 必填 | 说明 |
+|------|------|------|------|
+| `begin_time` | string | ✅ | 拉取开始时间，格式：`YYYY-MM-DD HH:mm:ss` |
+| `end_time` | string | ✅ | 拉取结束时间，格式：`YYYY-MM-DD HH:mm:ss` |
+| `cursor` | string | ❌ | 分页游标，首次请求不传，后续传入上次响应的 `next_cursor`，最大长度 256 |
+
+## 请求示例
+
+使用 `wecom_mcp` tool 调用 `wecom_mcp call msg get_msg_chat_list '{"begin_time": "2026-03-11 00:00:00", "end_time": "2026-03-17 23:59:59"}'`
+
+分页请求：
+
+使用 `wecom_mcp` tool 调用 `wecom_mcp call msg get_msg_chat_list '{"begin_time": "2026-03-11 00:00:00", "end_time": "2026-03-17 23:59:59", "cursor": "NEXT_CURSOR"}'`
+
+## 返回字段
+
+| 字段 | 类型 | 说明 |
+|------|------|------|
+| `errcode` | integer | 返回码，`0` 表示成功 |
+| `errmsg` | string | 错误信息 |
+| `chats` | array | 会话列表 |
+| `chats[].chat_id` | string | 会话 ID |
+| `chats[].chat_name` | string | 会话名称 |
+| `chats[].last_msg_time` | string | 最后一条消息时间，格式：`YYYY-MM-DD HH:mm:ss` |
+| `chats[].msg_count` | integer | 消息数量 |
+| `has_more` | boolean | 是否还有更多数据 |
+| `next_cursor` | string | 分页游标，用于下一次请求 |
+
+## 响应示例
+
+```json
+{
+    "errcode": 0,
+    "errmsg": "ok",
+    "chats": [
+        {
+            "chat_id": "CHAT_ID",
+            "chat_name": "张三",
+            "last_msg_time": "2026-03-17 15:30:45",
+            "msg_count": 128
+        },
+        {
+            "chat_id": "CHAT_ID_2",
+            "chat_name": "项目讨论群",
+            "last_msg_time": "2026-03-16 09:12:33",
+            "msg_count": 56
+        }
+    ],
+    "has_more": true,
+    "next_cursor": "NEXT_CURSOR"
+}
+```

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

@@ -0,0 +1,44 @@
+# get_msg_media API
+
+获取消息文件内容。根据文件 ID 自动下载文件到本地，返回本地文件路径、文件名称、类型、大小及内容类型。
+
+## 参数说明
+
+| 参数 | 类型 | 必填 | 说明 |
+|------|------|------|------|
+| `media_id` | string | ✅ | 文件 ID，长度 1~256 |
+
+## 请求示例
+
+使用 `wecom_mcp` tool 调用 `wecom_mcp call msg get_msg_media '{"media_id": "MEDIAID_xxxxxx"}'`
+
+## 返回字段
+
+| 字段 | 类型 | 说明 |
+|------|------|------|
+| `errcode` | Integer | 返回码，`0` 表示成功 |
+| `errmsg` | String | 错误信息 |
+| `media_item` | Object | 文件内容 |
+| `media_item.media_id` | String | 文件 ID |
+| `media_item.name` | String | 文件名称 |
+| `media_item.type` | String | 文件类型，`image`-图片，`voice`-语音，`video`-视频，`file`-普通文件 |
+| `media_item.local_path` | String | 文件下载后的本地路径 |
+| `media_item.size` | Integer | 文件大小（字节） |
+| `media_item.content_type` | String | 文件 MIME 类型，如 `image/png`、`application/pdf` 等 |
+
+## 响应示例
+
+```json
+{
+    "errcode": 0,
+    "errmsg": "ok",
+    "media_item": {
+        "media_id": "MEDIAID_xxxxxx",
+        "name": "screenshot.png",
+        "type": "image",
+        "local_path": "xxx/yyy/screenshot.png",
+        "size": 102400,
+        "content_type": "image/png"
+    }
+}
+```

package/skills/wecom-msg/references/api-send-message.md

@@ -0,0 +1,39 @@
+# send_message API
+
+向单聊或群聊发送文本消息。
+
+## 参数说明
+
+| 参数 | 类型 | 必填 | 说明 |
+|------|------|------|------|
+| `chat_type` | integer | ✅ | 会话类型，`1`-单聊，`2`-群聊 |
+| `chatid` | string | ✅ | 会话 ID，单聊时为 userid，群聊时为群 ID，最大 256 字节 |
+| `msgtype` | string | ✅ | 消息类型，目前仅支持 `text` |
+| `text` | object | ✅ | 文本消息内容 |
+| `text.content` | string | ✅ | 消息内容，最大 2048 字节 |
+
+## 请求示例
+
+单聊：
+
+使用 `wecom_mcp` tool 调用 `wecom_mcp call msg send_message '{"chat_type": 1, "chatid": "zhangsan", "msgtype": "text", "text": {"content": "hello world"}}'`
+
+群聊：
+
+使用 `wecom_mcp` tool 调用 `wecom_mcp call msg send_message '{"chat_type": 2, "chatid": "wrxxxxxxxx", "msgtype": "text", "text": {"content": "大家好"}}'`
+
+## 返回字段
+
+| 字段 | 类型 | 说明 |
+|------|------|------|
+| `errcode` | integer | 返回码，`0` 表示成功 |
+| `errmsg` | string | 错误信息 |
+
+## 响应示例
+
+```json
+{
+    "errcode": 0,
+    "errmsg": "ok"
+}
+```