@sunnoy/wecom 2.1.0 → 2.2.1

package/skills/wecom-meeting-create/SKILL.md

@@ -0,0 +1,163 @@
+---
+name: wecom-meeting-create
+description: 企业微信会议创建技能, 支持创建预约会议. 当用户需要"创建会议", "预约会议", "约会议", "安排会议"时触发.
+---
+# 企业微信会议创建技能
+
+> `wecom_mcp` 是一个 MCP tool，所有操作通过调用该 tool 完成。
+
+> ⚠️ **前置条件**：首次调用 `wecom_mcp` 前，必须按 `wecom-preflight` 技能执行前置条件检查，确保工具已加入白名单。
+
+> ⚠️ **路径与停止规则**：
+> - 如果要读取本 skill，必须直接使用 `<available_skills>` 或 `skillsSnapshot` 中给出的精确绝对路径。
+> - 不要猜测或改写为 `/data/openclaw/skills/wecom-*`、`/workspace/.openclaw/skills/...`、`/root/.openclaw/workspace-*/.openclaw/skills/...`，也不要用 `exec` + `ls/find` 探路。
+> - 若 `wecom_mcp` 返回 `errcode: 846609` 或 `unsupported mcp biz type`，表示当前 bot 未开通该 category，不是路径、白名单或 sandbox 问题；立即停止继续 `read`、`list`、`find`、memory fallback 探索，直接告知用户对应 category 未开通。
+
+## 概述
+
+wecom-meeting-create 提供企业微信预约会议的创建能力, 支持设置会议参数, 邀请参与人等.
+
+## 命令调用方式
+
+查看可用命令列表：使用 `wecom_mcp` tool 调用 `wecom_mcp list meeting`
+
+执行指定命令：使用 `wecom_mcp` tool 调用 `wecom_mcp call meeting <tool_name> '<json_params>'`
+
+---
+
+## 命令详细说明
+
+### 创建预约会议 (create_meeting)
+
+创建一个预约会议, 支持设置会议参数配置等.
+
+#### 执行命令
+
+使用 `wecom_mcp` tool 调用 `wecom_mcp call meeting create_meeting '{"title": "<会议标题>", "meeting_start_datetime": "<会议开始时间>", "meeting_duration": <会议持续时长(秒)>}'`
+
+#### 入参说明
+
+| 参数                       | 类型    | 必填 | 说明                                              |
+| -------------------------- | ------- | ---- | ------------------------------------------------- |
+| `title`                  | string  | 是   | 会议标题                                          |
+| `meeting_start_datetime` | string  | 是   | 会议开始时间, 格式:`YYYY-MM-DD HH:mm`           |
+| `meeting_duration`       | integer | 是   | 会议持续时长 (秒), 例如 3600 = 1 小时             |
+| `description`            | string  | 否   | 会议描述                                          |
+| `location`               | string  | 否   | 会议地点                                          |
+| `invitees`               | object  | 是   | 被邀请人, 格式:`{"userid": ["lisi", "wangwu"]}` |
+| `settings`               | object  | 否   | 会议设置 (详见下方)                               |
+
+> 被邀请人 userid 通过 `wecom-contact-lookup` 技能获取
+
+**settings 字段:**
+
+| 参数                        | 类型    | 说明                                          |
+| --------------------------- | ------- | --------------------------------------------- |
+| `password`                | string  | 会议密码                                      |
+| `enable_waiting_room`     | boolean | 是否启用等候室                                |
+| `allow_enter_before_host` | boolean | 是否允许成员在主持人进入前加入                |
+| `enable_enter_mute`       | integer | 入会时静音设置 (枚举: 0: 关闭, 1: 开启)       |
+| `allow_external_user`     | boolean | 是否允许外部用户入会                          |
+| `enable_screen_watermark` | boolean | 是否开启屏幕水印                              |
+| `remind_scope`            | integer | 提醒范围 (1: 不提醒, 2: 仅提醒主持人, 3: 提醒所有成员, 4: 指定部分人响铃, 默认仅提醒主持人) |
+| `ring_users`              | object  | 响铃用户, 格式:`{"userid": ["lisi"]}`   |
+
+> 响铃用户 userid 通过 `wecom-contact-lookup` 技能获取
+
+#### 返回参数
+
+```json
+{
+  "errcode": 0,
+  "errmsg": "ok",
+  "meetingid": "会议ID字符串",
+  "meeting_code": "会议号码字符串",
+  "meeting_link": "会议链接URL",
+  "excess_users": ["无效会议账号的userid"]
+}
+```
+
+| 字段             | 类型   | 说明                                                                                                               |
+| ---------------- | ------ | ------------------------------------------------------------------------------------------------------------------ |
+| `meetingid`    | string | 会议 ID                                                                                                            |
+| `meeting_code` | string | 会议号码, 向用户展示时需在回复**开头**单独一行纯文字展示, 格式 `#会议号: xxx-xxx-xxx` (每3位用 `-` 分隔) |
+| `meeting_link` | string | 会议链接                                                                                                           |
+| `excess_users` | array  | 参会人中包含无效会议账号的 userid, 仅在购买会议专业版企业由于部分参会人无有效会议账号时返回                        |
+
+---
+
+## 典型工作流
+
+### 工作流 1: 最简创建 (无邀请人)
+
+**用户意图**: "帮我约一个明天下午3点的会议, 主题是周例会, 时长1小时"
+
+**步骤:**
+
+1. **解析用户意图**: 时间 + 主题已有, 邀请人未提及则默认留空, 直接创建.
+2. **调用创建命令**:
+
+使用 `wecom_mcp` tool 调用 `wecom_mcp call meeting create_meeting '{"title": "周例会", "meeting_start_datetime": "2026-03-18 15:00", "meeting_duration": 3600}'`
+
+3. **展示结果**:
+
+#会议号: <会议号>
+
+```
+✅ 会议创建成功!
+
+📅 <会议标题>
+🕐 时间: <开始时间>, 时长 <时长>
+🔗 会议链接: <会议链接>
+```
+
+### 工作流 2: 带邀请人 + 地点 + 描述
+
+**用户意图**: "帮我约一个明天下午3点的会议, 主题是技术方案评审, 邀请张三和李四, 地点在3楼会议室, 时长1小时"
+
+**步骤:**
+
+1. **解析用户意图**: 有邀请人, 需先查询通讯录获取 userid.
+2. **通讯录查询**: 调用 `wecom-contact-lookup` 技能获取通讯录成员, 按姓名筛选出参与者的 userid.
+
+使用 `wecom_mcp` tool 调用 `wecom_mcp call contact get_userlist '{}'`
+
+在返回的 `userlist` 中筛选 `name` 包含 "张三" 和 "李四" 的成员, 获取其 `userid`.
+
+3. **信息已充分, 直接调用创建命令** (禁止暴露内部 ID):
+
+使用 `wecom_mcp` tool 调用 `wecom_mcp call meeting create_meeting '{"title": "技术方案评审", "meeting_start_datetime": "2026-03-18 15:00", "meeting_duration": 3600, "location": "3楼会议室", "invitees": {"userid": ["zhangsan", "lisi"]}}'`
+
+4. **展示结果**:
+
+#会议号: <会议号>
+
+```
+✅ 会议创建成功!
+
+📅 <会议标题>
+🕐 时间: <开始时间>, 时长 <时长>
+👥 参与人: <参与者姓名列表>
+🔗 会议链接: <会议链接>
+```
+
+---
+
+## 复杂场景样例
+
+按场景按需加载, 避免一次性引入过多无关示例:
+
+| 文件 | 适用场景 |
+| ---- | -------- |
+| [references/example-security.md](references/example-security.md) | 会议密码, 等候室, 外部用户限制 |
+| [references/example-reminder.md](references/example-reminder.md) | 响铃提醒, 指定部分人响铃 |
+| [references/example-full.md](references/example-full.md) | 全参数综合场景 (含静音, 屏幕水印, 等候室等设置) |
+
+---
+
+## 注意事项
+
+- **信息追问**: 缺少时间或主题时, 简洁追问用户; 未提及邀请人则默认留空
+- **通讯录查询**: 涉及参与人时, 需先通过 `wecom-contact-lookup` 技能的 `get_userlist` 接口获取全量通讯录成员, 再按姓名/别名本地筛选匹配出对应的 `userid`. 该接口无入参, 返回当前用户可见范围内的成员列表 (含 `userid`, `name`, `alias`)
+- **直接创建**: 时间 + 主题已知即可直接创建, 邀请人有则带上, 无则留空; 无论信息是一次性提供还是上下文可推断, 非必要则均不请求确认, 直接创建即可
+- **时间格式**: 统一使用 `YYYY-MM-DD HH:mm` 格式

package/skills/wecom-meeting-create/references/example-full.md

@@ -0,0 +1,30 @@
+# 创建会议 - 全参数综合场景示例
+
+## 场景 1: 高规格会议 (全参数)
+
+**用户意图**: "帮我创建一个高规格的季度战略会议: 下周一上午9点, 时长4小时, 邀请全团队, 设置密码, 开启等候室, 开启屏幕水印, 全员静音"
+
+```json
+{
+  "title": "Q2季度战略规划会",
+  "meeting_start_datetime": "2026-03-23 09:00",
+  "meeting_duration": 14400,
+  "description": "Q2季度战略规划, 请各部门负责人提前准备汇报材料",
+  "location": "总部大会议室",
+  "invitees": {
+    "userid": ["zhangsan", "lisi", "wangwu", "zhaoliu", "sunqi"]
+  },
+  "settings": {
+    "password": "2026",
+    "enable_waiting_room": true,
+    "allow_enter_before_host": false,
+    "enable_enter_mute": 1,
+    "allow_external_user": false,
+    "enable_screen_watermark": true,
+    "remind_scope": 3,
+    "ring_users": {
+      "userid": ["zhangsan", "lisi", "wangwu", "zhaoliu", "sunqi"]
+    }
+  }
+}
+```

package/skills/wecom-meeting-create/references/example-reminder.md

@@ -0,0 +1,46 @@
+# 创建会议 - 响铃提醒场景示例
+
+## 场景 2: 仅提醒主持人 + 提前提醒时间
+
+**用户意图**: "帮我创建一个会议, 只提醒主持人, 并在会议开始前15分钟和1小时各提醒一次"
+
+```json
+{
+  "title": "项目启动会",
+  "meeting_start_datetime": "2026-03-21 10:00",
+  "meeting_duration": 3600,
+  "invitees": {
+    "userid": ["zhangsan", "lisi"]
+  },
+  "settings": {
+    "remind_scope": 2,
+    "ring_users": {
+      "userid": ["zhangsan"]
+    }
+  }
+}
+```
+
+---
+
+## 场景 3: 指定部分人响铃 (remind_scope=4)
+
+**用户意图**: "帮我创建一个会议, 只响铃提醒张三和李四, 其他人不提醒"
+
+```json
+{
+  "title": "紧急故障复盘",
+  "meeting_start_datetime": "2026-03-18 20:00",
+  "meeting_duration": 3600,
+  "invitees": {
+    "userid": ["zhangsan", "lisi", "wangwu", "zhaoliu"]
+  },
+  "settings": {
+    "remind_scope": 4,
+    "ring_users": {
+      "userid": ["zhangsan", "lisi"]
+    },
+    "allow_enter_before_host": true
+  }
+}
+```

package/skills/wecom-meeting-create/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-manage/SKILL.md

@@ -0,0 +1,141 @@
+---
+name: wecom-meeting-manage
+description: 企业微信会议管理技能, 支持取消会议和更新会议受邀成员. 当用户需要"取消会议", "删除会议", "修改会议成员", "添加会议参与人", "移除会议成员"时触发.
+---
+# 企业微信会议管理技能
+
+> `wecom_mcp` 是一个 MCP tool，所有操作通过调用该 tool 完成。
+
+> ⚠️ **前置条件**：首次调用 `wecom_mcp` 前，必须按 `wecom-preflight` 技能执行前置条件检查，确保工具已加入白名单。
+
+> ⚠️ **路径与停止规则**：
+> - 如果要读取本 skill，必须直接使用 `<available_skills>` 或 `skillsSnapshot` 中给出的精确绝对路径。
+> - 不要猜测或改写为 `/data/openclaw/skills/wecom-*`、`/workspace/.openclaw/skills/...`、`/root/.openclaw/workspace-*/.openclaw/skills/...`，也不要用 `exec` + `ls/find` 探路。
+> - 若 `wecom_mcp` 返回 `errcode: 846609` 或 `unsupported mcp biz type`，表示当前 bot 未开通该 category，不是路径、白名单或 sandbox 问题；立即停止继续 `read`、`list`、`find`、memory fallback 探索，直接告知用户对应 category 未开通。
+
+## 概述
+
+wecom-meeting-manage 提供企业微信会议管理能力, 包含以下功能:
+
+1. **取消会议** - 取消指定的预约会议
+2. **更新会议受邀成员** - 修改会议的参与人列表
+
+## 命令调用方式
+
+查看可用命令列表：使用 `wecom_mcp` tool 调用 `wecom_mcp list meeting`
+
+调用指定命令：使用 `wecom_mcp` tool 调用 `wecom_mcp call meeting <tool_name> '<json_params>'`
+
+---
+
+## 命令详细说明
+
+### 1. 取消会议 (cancel_meeting)
+
+取消指定的预约会议.
+
+#### 调用命令
+
+使用 `wecom_mcp` tool 调用 `wecom_mcp call meeting cancel_meeting '{"meetingid": "<会议id>"}'`
+
+#### 入参说明
+
+| 参数              | 类型   | 必填 | 说明                               |
+| ----------------- | ------ | ---- | ---------------------------------- |
+| `meetingid`     | string | 是   | 会议 ID, 通过 `wecom-meeting-query` 技能获取 |
+
+#### 返回参数
+
+```json
+{
+  "errcode": 0,
+  "errmsg": "ok"
+}
+```
+
+---
+
+### 2. 更新会议受邀成员 (set_invite_meeting_members)
+
+更新会议的受邀成员列表 (全量覆盖).
+
+#### 调用命令
+
+使用 `wecom_mcp` tool 调用 `wecom_mcp call meeting set_invite_meeting_members '{"meetingid": "<会议id>", "invitees": [{"userid": "lisi"}, {"userid": "wangwu"}]}'`
+
+#### 入参说明
+
+| 参数          | 类型   | 必填 | 说明                                   |
+| ------------- | ------ | ---- | -------------------------------------- |
+| `meetingid` | string | 是   | 会议 ID, 通过 `wecom-meeting-query` 技能获取                          |
+| `invitees`  | array  | 否   | 受邀成员列表, 每项包含 `userid` 字段 |
+
+> **注意**: invitees 为全量覆盖, 传入的列表将替换现有成员列表.
+> invitees 的 userid 通过 `wecom-contact-lookup` 技能获取
+
+#### 返回参数
+
+```json
+{
+  "errcode": 0,
+  "errmsg": "ok"
+}
+```
+
+---
+
+## 典型工作流
+
+### 工作流 1: 取消会议
+
+**示例**: 用户说 "帮我取消明天的技术方案评审会议"
+
+**步骤:**
+
+1. **定位会议**: 通过 `wecom-meeting-query` 技能查询会议列表 + 关键词匹配找到目标会议.
+2. **直接执行取消**:
+
+使用 `wecom_mcp` tool 调用 `wecom_mcp call meeting cancel_meeting '{"meetingid": "<target_meetingid>"}'`
+
+4. **展示结果**:
+
+```
+✅ 会议已取消: 技术方案评审
+```
+
+---
+
+### 工作流 2: 更新会议成员
+
+**示例**: 用户说 "把王五加到技术方案评审会议里"
+
+**步骤:**
+
+1. **定位会议**: 通过 `wecom-meeting-query` 技能查询会议列表 + 匹配找到目标会议.
+2. **获取当前受邀成员**: `set_invite_members` 为全量覆盖, 必须先通过 `wecom-meeting-query` 技能的 `get_meeting_info` 获取会议详情, 获取现有成员后再合并.
+3. **通讯录查询**: 调用 `wecom-contact-lookup` 技能获取通讯录成员, 按姓名筛选出王五的 userid.
+
+使用 `wecom_mcp` tool 调用 `wecom_mcp call contact get_userlist '{}'`
+
+在返回的 `userlist` 中筛选 `name` 包含 "王五" 的成员, 获取其 `userid`.
+
+4. **合并成员列表**: 将现有成员 + 新增成员合并 (全量覆盖).
+5. **执行更新**:
+
+使用 `wecom_mcp` tool 调用 `wecom_mcp call meeting set_invite_meeting_members '{"meetingid": "<target_meetingid>", "invitees": [{"userid": "zhangsan"}, {"userid": "lisi"}, {"userid": "wangwu"}]}'`
+
+7. **展示结果**:
+
+```
+✅ 会议成员已更新: 技术方案评审
+👥 当前成员: 张三, 李四, 王五
+```
+
+---
+
+## 注意事项
+
+- **参与人仅支持企业内成员**, 不支持外部人员
+- **通讯录查询**: 涉及参与人时, 需先通过 `wecom-contact-lookup` 技能的 `get_userlist` 接口获取全量通讯录成员, 再按姓名/别名本地筛选匹配出对应的 `userid`. 该接口无入参, 返回当前用户可见范围内的成员列表 (含 `userid`, `name`, `alias`)
+- **定位会议**: 管理操作需先通过 `wecom-meeting-query` 技能查询到目标会议的 meetingid
+- **成员更新为全量覆盖**: `set_invite_members` 传入的列表将替换现有成员列表, 需先获取当前成员再合并