@wecom/wecom-openclaw-plugin 2026.4.1-beta.4 → 2026.4.2-beta.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@wecom/wecom-openclaw-plugin",
3
- "version": "2026.4.1-beta.4",
3
+ "version": "2026.4.2-beta.0",
4
4
  "type": "module",
5
5
  "main": "dist/cjs/index.js",
6
6
  "module": "dist/esm/index.js",
@@ -65,4 +65,4 @@
65
65
 
66
66
  - `content_type` 当前仅支持 `1`(Markdown 格式)
67
67
  - 此操作为**覆写**,会替换文档全部内容
68
- - 建议先调用 `get_document` 了解当前内容再编辑
68
+ - 建议先调用 `get_doc_content` 了解当前内容再编辑
@@ -39,7 +39,7 @@ wecom-meeting-create 提供企业微信预约会议的创建能力, 支持设置
39
39
  | `meeting_duration` | integer | 是 | 会议持续时长 (秒), 例如 3600 = 1 小时 |
40
40
  | `description` | string | 否 | 会议描述 |
41
41
  | `location` | string | 否 | 会议地点 |
42
- | `invitees` | object | 是 | 被邀请人, 格式:`{"userid": ["lisi", "wangwu"]}` |
42
+ | `invitees` | object | 否 | 被邀请人, 格式:`{"userid": ["lisi", "wangwu"]}` |
43
43
  | `settings` | object | 否 | 会议设置 (详见下方) |
44
44
 
45
45
  > 被邀请人 userid 通过 `wecom-contact-lookup` 技能获取
@@ -63,7 +63,7 @@ wecom-meeting-manage 提供企业微信会议管理能力, 包含以下功能:
63
63
  | 参数 | 类型 | 必填 | 说明 |
64
64
  | ------------- | ------ | ---- | -------------------------------------- |
65
65
  | `meetingid` | string | 是 | 会议 ID, 通过 `wecom-meeting-query` 技能获取 |
66
- | `invitees` | array | 否 | 受邀成员列表, 每项包含 `userid` 字段 |
66
+ | `invitees` | array | 是 | 受邀成员列表, 每项包含 `userid` 字段 |
67
67
 
68
68
  > **注意**: invitees 为全量覆盖, 传入的列表将替换现有成员列表.
69
69
  > invitees 的 userid 通过 `wecom-contact-lookup` 技能获取
@@ -92,7 +92,7 @@ wecom-meeting-manage 提供企业微信会议管理能力, 包含以下功能:
92
92
 
93
93
  使用 `wecom_mcp` tool 调用 `wecom_mcp call meeting cancel_meeting '{"meetingid": "<target_meetingid>"}'`
94
94
 
95
- 4. **展示结果**:
95
+ 3. **展示结果**:
96
96
 
97
97
  ```
98
98
  ✅ 会议已取消: 技术方案评审
@@ -107,7 +107,7 @@ wecom-meeting-manage 提供企业微信会议管理能力, 包含以下功能:
107
107
  **步骤:**
108
108
 
109
109
  1. **定位会议**: 通过 `wecom-meeting-query` 技能查询会议列表 + 匹配找到目标会议.
110
- 2. **获取当前受邀成员**: `set_invite_members` 为全量覆盖, 必须先通过 `wecom-meeting-query` 技能的 `get_meeting_info` 获取会议详情, 获取现有成员后再合并.
110
+ 2. **获取当前受邀成员**: `set_invite_meeting_members` 为全量覆盖, 必须先通过 `wecom-meeting-query` 技能的 `get_meeting_info` 获取会议详情, 获取现有成员后再合并.
111
111
  3. **通讯录查询**: 调用 `wecom-contact-lookup` 技能获取通讯录成员, 按姓名筛选出王五的 userid.
112
112
 
113
113
  使用 `wecom_mcp` tool 调用 `wecom_mcp call contact get_userlist '{}'`
@@ -119,7 +119,7 @@ wecom-meeting-manage 提供企业微信会议管理能力, 包含以下功能:
119
119
 
120
120
  使用 `wecom_mcp` tool 调用 `wecom_mcp call meeting set_invite_meeting_members '{"meetingid": "<target_meetingid>", "invitees": [{"userid": "zhangsan"}, {"userid": "lisi"}, {"userid": "wangwu"}]}'`
121
121
 
122
- 7. **展示结果**:
122
+ 6. **展示结果**:
123
123
 
124
124
  ```
125
125
  ✅ 会议成员已更新: 技术方案评审
@@ -133,4 +133,4 @@ wecom-meeting-manage 提供企业微信会议管理能力, 包含以下功能:
133
133
  - **参与人仅支持企业内成员**, 不支持外部人员
134
134
  - **通讯录查询**: 涉及参与人时, 需先通过 `wecom-contact-lookup` 技能的 `get_userlist` 接口获取全量通讯录成员, 再按姓名/别名本地筛选匹配出对应的 `userid`. 该接口无入参, 返回当前用户可见范围内的成员列表 (含 `userid`, `name`, `alias`)
135
135
  - **定位会议**: 管理操作需先通过 `wecom-meeting-query` 技能查询到目标会议的 meetingid
136
- - **成员更新为全量覆盖**: `set_invite_members` 传入的列表将替换现有成员列表, 需先获取当前成员再合并
136
+ - **成员更新为全量覆盖**: `set_invite_meeting_members` 传入的列表将替换现有成员列表, 需先获取当前成员再合并
@@ -64,9 +64,9 @@ metadata:
64
64
  - 添加参与人:使用 `wecom_mcp` tool 调用 `wecom_mcp call schedule add_schedule_attendees '{"schedule_id": "SCHEDULE_ID", "attendees": [{"userid": "USER_ID"}]}'`
65
65
  - 移除参与人:使用 `wecom_mcp` tool 调用 `wecom_mcp call schedule del_schedule_attendees '{"schedule_id": "SCHEDULE_ID", "attendees": [{"userid": "USER_ID"}]}'`
66
66
 
67
- ### check_availablity — 查询闲忙
67
+ ### check_availability — 查询闲忙
68
68
 
69
- 使用 `wecom_mcp` tool 调用 `wecom_mcp call schedule check_availablity '{"check_user_list": ["USER_ID_1", "USER_ID_2"], "start_time": "YYYY-MM-DD HH:MM:SS", "end_time": "YYYY-MM-DD HH:MM:SS"}'`
69
+ 使用 `wecom_mcp` tool 调用 `wecom_mcp call schedule check_availability '{"check_user_list": ["USER_ID_1", "USER_ID_2"], "start_time": "YYYY-MM-DD HH:MM:SS", "end_time": "YYYY-MM-DD HH:MM:SS"}'`
70
70
 
71
71
  支持 1~10 个用户,返回各用户的忙碌时段列表。参见 [API 详情](references/api-check-availability.md)。
72
72
 
@@ -156,6 +156,6 @@ metadata:
156
156
 
157
157
  **流程:**
158
158
  1. 通过 **wecom-contact-lookup** 获取相关人员 userid
159
- 2. 调用 `check_availablity` 查询指定时间范围内各用户的忙碌时段
159
+ 2. 调用 `check_availability` 查询指定时间范围内各用户的忙碌时段
160
160
  3. 分析所有用户的忙碌时段,计算出共同空闲时段并推荐给用户
161
161
  4. 用户确认时段后,调用 `create_schedule` 创建会议并自动添加参与人
@@ -1,4 +1,4 @@
1
- # check_availablity API
1
+ # check_availability API
2
2
 
3
3
  查询指定用户在某时间范围内的忙碌时段。
4
4
 
@@ -12,7 +12,7 @@
12
12
 
13
13
  ## 请求示例
14
14
 
15
- 使用 `wecom_mcp` tool 调用 `wecom_mcp call schedule check_availablity '{"check_user_list": ["USER_ID_1", "USER_ID_2"], "start_time": "YYYY-MM-DD HH:MM:SS", "end_time": "YYYY-MM-DD HH:MM:SS"}'`
15
+ 使用 `wecom_mcp` tool 调用 `wecom_mcp call schedule check_availability '{"check_user_list": ["USER_ID_1", "USER_ID_2"], "start_time": "YYYY-MM-DD HH:MM:SS", "end_time": "YYYY-MM-DD HH:MM:SS"}'`
16
16
 
17
17
  ## 返回字段
18
18
 
@@ -32,7 +32,7 @@ description: 企业微信智能表格数据(记录)管理技能。提供智
32
32
 
33
33
  查询子表全部记录。
34
34
 
35
- - 使用 `wecom_mcp` tool 调用 `wecom_mcp call doc smartsheet_get_records '{"docid": "DOCID", "sheet_id": "SHEETID"}'`
35
+ - 通过 sheetid:使用 `wecom_mcp` tool 调用 `wecom_mcp call doc smartsheet_get_records '{"docid": "DOCID", "sheet_id": "SHEETID"}'`
36
36
  - 或通过 URL:使用 `wecom_mcp` tool 调用 `wecom_mcp call doc smartsheet_get_records '{"url": "https://doc.weixin.qq.com/smartsheet/xxx", "sheet_id": "SHEETID"}'`
37
37
 
38
38
  参见 [API 详情](references/api-get-records.md)。
@@ -49,7 +49,10 @@ description: 企业微信智能表格数据(记录)管理技能。提供智
49
49
 
50
50
  ### smartsheet_update_records
51
51
 
52
- 更新一行或多行记录,单次必须在 500 行内。需提供 record_id(通过 `smartsheet_get_records` 获取)。
52
+ 更新一行或多行记录,单次建议在 500 行内。需提供 record_id(通过 `smartsheet_get_records` 获取)。支持通过 `key_type` 指定 values 的 key 使用字段标题或字段 ID:
53
+
54
+ - `CELL_VALUE_KEY_TYPE_FIELD_TITLE`:key 为字段标题
55
+ - `CELL_VALUE_KEY_TYPE_FIELD_ID`:key 为字段 ID
53
56
 
54
57
  使用 `wecom_mcp` tool 调用 `wecom_mcp call doc smartsheet_update_records '{"docid": "DOCID", "sheet_id": "SHEETID", "key_type": "CELL_VALUE_KEY_TYPE_FIELD_ID", "records": [{"record_id": "RECORDID", "values": {"FIELDID": [{"type": "text", "text": "更新后的内容"}]}}]}'`
55
58
 
@@ -59,3 +59,4 @@
59
59
  "sheet_id": "123Abc"
60
60
  }
61
61
  ```
62
+
@@ -1,6 +1,7 @@
1
1
  # 单元格值格式参考
2
2
 
3
- 在 `smartsheet_add_records` 和 `smartsheet_update_records` 中,`values` 的 key **必须是字段标题(field_title)**,不能使用字段 ID。
3
+ `smartsheet_add_records` 仅支持**字段标题**作为key。
4
+ `smartsheet_update_records` 支持通过 `key_type` 参数指定使用字段标题(`CELL_VALUE_KEY_TYPE_FIELD_TITLE`)或字段 ID(`CELL_VALUE_KEY_TYPE_FIELD_ID`)。
4
5
 
5
6
  ## 各字段类型的值格式
6
7
 
@@ -36,10 +37,40 @@
36
37
 
37
38
  ```json
38
39
  "优先级": [{"text": "高"}],
39
- "标签": [{"text": "紧急"}, {"text": "重要"}]
40
+ "标签": [{"text": "紧急", "style": 17}, {"text": "重要", "style": 12}]
40
41
  ```
41
42
 
42
- 选项可附带 `id`(已存在选项)和 `style`(颜色 1-27)。
43
+ 已存在的选项应通过 `id` 匹配(`id` 可从 `smartsheet_get_fields` 返回中获取),新增选项时不填 `id`。可附带 `style`(颜色 1-27),对照表如下:
44
+
45
+ | style | 颜色 |
46
+ |-------|------|
47
+ | 1 | 浅红1 |
48
+ | 2 | 浅橙1 |
49
+ | 3 | 浅天蓝1 |
50
+ | 4 | 浅绿1 |
51
+ | 5 | 浅紫1 |
52
+ | 6 | 浅粉红1 |
53
+ | 7 | 浅灰1 |
54
+ | 8 | 白 |
55
+ | 9 | 灰 |
56
+ | 10 | 浅蓝1 |
57
+ | 11 | 浅蓝2 |
58
+ | 12 | 蓝 |
59
+ | 13 | 浅天蓝2 |
60
+ | 14 | 天蓝 |
61
+ | 15 | 浅绿2 |
62
+ | 16 | 绿 |
63
+ | 17 | 浅红2 |
64
+ | 18 | 红 |
65
+ | 19 | 浅橙2 |
66
+ | 20 | 橙 |
67
+ | 21 | 浅黄1 |
68
+ | 22 | 浅黄2 |
69
+ | 23 | 黄 |
70
+ | 24 | 浅紫2 |
71
+ | 25 | 紫 |
72
+ | 26 | 浅粉红2 |
73
+ | 27 | 粉红 |
43
74
 
44
75
  ### 5. 日期时间 (DATE_TIME)
45
76
 
@@ -118,3 +149,4 @@
118
149
  }]
119
150
  }
120
151
  ```
152
+