@wecom/wecom-openclaw-plugin 2026.4.23-beta.0 → 2026.4.2201

package/dist/src/monitor.js

@@ -341,11 +341,11 @@ async function routeAndDispatchMessage(params) {
             ctx: ctxPayload,
             cfg: config,
             replyOptions: {
-            // 打印 LLM 返回的原始分片内容（在 openclaw 核心对 MEDIA: 指令解析之前），
-            // 用于排查流式分片导致 MEDIA 指令被切断、识别丢失等问题
-            // onPartialReply: (payload: unknown) => {
-            // runtime.log?.(`[openclaw -> plugin][partial] payload=${JSON.stringify(payload)}`);
-            // },
+                // 打印 LLM 返回的原始分片内容（在 openclaw 核心对 MEDIA: 指令解析之前），
+                // 用于排查流式分片导致 MEDIA 指令被切断、识别丢失等问题
+                onPartialReply: (payload) => {
+                    runtime.log?.(`[openclaw -> plugin][partial] payload=${JSON.stringify(payload)}`);
+                },
             },
             dispatcherOptions: {
                 onReplyStart: async () => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wecom/wecom-openclaw-plugin",
-  "version": "2026.4.23-beta.0",
+  "version": "2026.4.2201",
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

package/skills/wecom-doc-manager/SKILL.md

@@ -51,7 +51,6 @@ description: 企业微信文档管理技能。支持企业微信文档、智能
 | errcode | errmsg | 含义 | 处理方式 |
 |---------|--------|------|----------|
 | `851002` | `incompatible doc type` | 文档品类与所调用的接口不匹配 | 根据文档 URL 重新确认品类（参见上方「URL 品类识别与接口路由」表），然后使用该品类对应的正确接口重试 |
-| `851003` | `no authority` | 无权限调用该接口，**智能表格写入场景**下通常是企业可见范围 > 10 人的规模限制 | 若发生在需要写入数据的场景，引导用户走 Webhook 兜底方案，详见 [webhook-fallback.md](../wecom-smartsheet-data/references/webhook-fallback.md)；其他接口则按权限问题排查 |
 
 ## 文档
 

package/skills/wecom-smartsheet-data/SKILL.md

@@ -47,8 +47,6 @@ description: 企业微信智能表格数据（记录）管理技能。提供智
 
 各字段类型的值格式参见 [单元格值格式参考](references/cell-value-formats.md)。
 
-> ⚠️ 若返回 `errcode: 851003` 或 `errmsg` 包含 `no authority`（通常是企业可见范围 > 10 人的规模限制），切换到 Webhook 兜底方案，详见 [webhook-fallback.md](references/webhook-fallback.md)。
-
 ### smartsheet_update_records
 
 更新一行或多行记录，单次建议在 500 行内。需提供 record_id（通过 `smartsheet_get_records` 获取）。支持通过 `key_type` 指定 values 的 key 使用字段标题或字段 ID：
@@ -60,8 +58,6 @@ description: 企业微信智能表格数据（记录）管理技能。提供智
 
 **注意**：创建时间、最后编辑时间、创建人、最后编辑人字段不可更新。
 
-> ⚠️ 若返回 `errcode: 851003` 或 `errmsg` 包含 `no authority`（通常是企业可见范围 > 10 人的规模限制），切换到 Webhook 兜底方案，详见 [webhook-fallback.md](references/webhook-fallback.md)。注意 Webhook 只能更新通过 Webhook 写入的记录，人工创建的记录无法更新。
-
 ### smartsheet_delete_records
 
 删除一行或多行记录，单次必须在 500 行内。**操作不可逆**。record_id 通过 `smartsheet_get_records` 获取。
@@ -74,6 +70,5 @@ description: 企业微信智能表格数据（记录）管理技能。提供智
 2. **写入数据** → 先 `smartsheet_get_fields` 了解列类型 → 若涉及成员（USER）字段，先通过 `wecom-contact-lookup` 的 `get_userlist` 查找人员 userid → `smartsheet_add_records` 写入
 3. **更新数据** → 先 `smartsheet_get_records` 获取 record_id → 若涉及成员（USER）字段，先通过 `wecom-contact-lookup` 的 `get_userlist` 查找人员 userid → `smartsheet_update_records` 更新
 4. **删除数据** → 先 `smartsheet_get_records` 确认 record_id → `smartsheet_delete_records` 删除
-5. **写入失败 fallback** → 第 2/3 步返回 `errcode: 851003` / `no authority`（通常是企业可见范围 > 10 人的规模限制）时 → 请用户临时提供目标表的 Webhook 地址 + schema 示例 JSON（不保存到本地）→ 按 [webhook-fallback.md](references/webhook-fallback.md) 构造请求体发送
 
 > **注意**：成员（USER）类型字段需要填写 `user_id`，不能直接使用姓名。必须先通过 `wecom-contact-lookup` 技能的 `get_userlist` 接口按姓名查找到对应的 `userid` 后再使用。

package/skills/wecom-smartsheet-data/references/webhook-examples.md

@@ -1,185 +0,0 @@
-# 真实场景示例
-
-## 场景 1：记录一个 Bug（文本 + 单选 + 图片）
-
-用户说：“帮我记一下这个 bug，登录页在 Safari 下白屏，模块是前端，严重程度严重。”
-
-```json
-{
-  "add_records": [
-    {
-      "values": {
-        "fABCD1": "登录页在 Safari 浏览器下加载后白屏，其他浏览器正常。复现步骤：Safari 14+ 访问 /login → 页面空白，控制台报 CSS 解析错误。",
-        "fABCD2": [{"text": "前端"}],
-        "fABCD3": [{"text": "严重"}],
-        "fABCD4": [{"user_id": "wangwu"}],
-        "fABCD5": [{"title": "safari-bug-screenshot.png", "image_base64": "iVBORw0KGgoAAAANSUhEUg...（纯base64）"}]
-      }
-    }
-  ]
-}
-```
-
-## 场景 2：记录一条任务（文本 + 日期 + 成员 + 单选 + 空图片）
-
-用户说：“加一条任务，完成支付模块单元测试，3月20日前，负责人 lisi，状态未开始，暂无附件。”
-
-```json
-{
-  "add_records": [
-    {
-      "values": {
-        "fTITLE": "完成支付模块单元测试，覆盖率达到 80%",
-        "fDUEDATE": "1742400000000",
-        "fOWNER": [{"user_id": "lisi"}],
-        "fSTATUS": [{"text": "未开始"}],
-        "fATTACH": []
-      }
-    }
-  ]
-}
-```
-
-> **关于负责人（成员字段）**：
-> - 有 userid 时用 `[{"user_id": "账号名"}]`，userid 通常就是企业微信登录账号
-> - 没有 userid 只知道姓名时用 `["张三"]`，但匹配不上时不会写入
-> - 暂不指定负责人时传 `[]` 空数组
->
-> **关于图片/附件字段**：
-> - 暂无图片时传 `[]` 空数组即可，不会报错
-> - 有图片时传 `[{"title": "filename.png", "image_base64": "纯base64字符串"}]`，注意不带 `data:image/...;base64,` 前缀
-
-## 场景 3：批量添加多条客户记录
-
-用户说：“帮我把这三条线索录进去：张伟/科技公司/跟进中，陈静/贸易公司/初步接触，刘洋/制造业/已成交。”
-
-```json
-{
-  "add_records": [
-    {
-      "values": {
-        "fCUST_NAME": "张伟",
-        "fCOMPANY": "北京某科技有限公司",
-        "fSTAGE": [{"text": "跟进中"}],
-        "fSOURCE": [{"text": "展会"}]
-      }
-    },
-    {
-      "values": {
-        "fCUST_NAME": "陈静",
-        "fCOMPANY": "上海某贸易有限公司",
-        "fSTAGE": [{"text": "初步接触"}],
-        "fSOURCE": [{"text": "冷呼"}]
-      }
-    },
-    {
-      "values": {
-        "fCUST_NAME": "刘洋",
-        "fCOMPANY": "广州某制造有限公司",
-        "fSTAGE": [{"text": "已成交"}],
-        "fSOURCE": [{"text": "老客户转介绍"}]
-      }
-    }
-  ]
-}
-```
-
-## 场景 4：更新一条已有记录
-
-用户说：“把 record_id 是 REC_20250301 的那条任务状态改成已完成，进度 100%。”
-
-```json
-{
-  "update_records": [
-    {
-      "record_id": "REC_20250301",
-      "values": {
-        "fSTATUS": [{"text": "已完成"}],
-        "fPROGRESS": 100
-      }
-    }
-  ]
-}
-```
-
-## 场景 5：批量更新多条记录
-
-用户说：“把这几条审批记录都标为已通过：REC_001、REC_002、REC_003。”
-
-```json
-{
-  "update_records": [
-    {"record_id": "REC_001", "values": {"fSTATUS": [{"text": "已通过"}], "fAPPROVER": [{"user_id": "manager_a"}]}},
-    {"record_id": "REC_002", "values": {"fSTATUS": [{"text": "已通过"}], "fAPPROVER": [{"user_id": "manager_a"}]}},
-    {"record_id": "REC_003", "values": {"fSTATUS": [{"text": "已通过"}], "fAPPROVER": [{"user_id": "manager_a"}]}}
-  ]
-}
-```
-
-## 场景 6：记录一条销售订单（多字段混合类型）
-
-用户说：“新增一条订单，客户是北京某科技，产品是企业版，金额 58000，签约日期今天，负责人赵六，合同链接发给你了。”
-
-```json
-{
-  "add_records": [
-    {
-      "values": {
-        "fCUSTOMER": "北京某科技有限公司",
-        "fPRODUCT": [{"text": "企业版"}],
-        "fAMOUNT": 58000,
-        "fSIGN_DATE": "1741622400000",
-        "fSALES": [{"user_id": "zhaoliu"}],
-        "fCONTRACT": [{"text": "合同文件", "link": "https://doc.example.com/contract/2025-001"}]
-      }
-    }
-  ]
-}
-```
-
-## 场景 7：记录一次会议纪要
-
-用户说：“帮我记一下今天下午的需求评审会，参会人产品+开发+测试，决议是优先做支付模块。”
-
-```json
-{
-  "add_records": [
-    {
-      "values": {
-        "fMEETING_TITLE": "支付模块需求评审会",
-        "fDATE": "1741622400000",
-        "fPARTICIPANTS": "产品、开发、测试",
-        "fSUMMARY": "确定优先开发支付模块，目标 3 月底完成联调，4 月初上线。遗留问题：退款流程待产品补充文档。",
-        "fDOC_LINK": [{"text": "评审文档", "link": "https://doc.example.com/meeting/20250310"}]
-      }
-    }
-  ]
-}
-```
-
-## 场景 8：同一请求中同时添加和更新
-
-用户说：“新增一条‘用户反馈收集’的任务，同时把‘旧官网下线’那条（REC_OLD_001）标为已完成。”
-
-```json
-{
-  "add_records": [
-    {
-      "values": {
-        "fTITLE": "用户反馈收集与分析",
-        "fSTATUS": [{"text": "未开始"}],
-        "fPRIORITY": [{"text": "高"}]
-      }
-    }
-  ],
-  "update_records": [
-    {
-      "record_id": "REC_OLD_001",
-      "values": {
-        "fSTATUS": [{"text": "已完成"}],
-        "fPROGRESS": 100
-      }
-    }
-  ]
-}
-```

package/skills/wecom-smartsheet-data/references/webhook-fallback.md

@@ -1,184 +0,0 @@
-# 智能表格 Webhook 兜底写入
-
-> 本文档是 `smartsheet_add_records` / `smartsheet_update_records` 的 **fallback 参考**。
-> 当通过 `wecom_mcp` tool 调用因企业规模限制（可见范围 > 10 人）报错、无法写入智能表格时，切换到本方案，通过企业微信智能表格的 Webhook 接口直接写入数据。
->
-> ⚠️ **格式隔离**：以下字段值格式仅适用于 Webhook 接口，与 `wecom_mcp` tool 侧 `smartsheet_add_records` / `smartsheet_update_records` 的参数结构**不同**（例如文本、URL、图片、日期的写法均有差异），请勿与 [cell-value-formats.md](cell-value-formats.md) 的格式混用。
-
----
-
-## 一、Fallback 触发流程
-
-### 何时切换到 Webhook
-
-先走 `wecom_mcp` tool 正常链路（`smartsheet_add_records` / `smartsheet_update_records`）。仅在出现以下情况时才切换到 Webhook：
-
-- **优先判据**：返回 `errcode: 851003`，或 `errmsg` 包含 `no authority` —— 这通常意味着企业可见范围 > 10 人，写入接口被限制
-- 或 `errmsg` / 提示信息明显指向**企业规模 / 可见范围超限**（例如“超出可见范围”、“成员数超限”等相关描述）
-- 其他错误（参数错误、字段 ID 错误、文档不存在等）**不应**切换到 Webhook，应按原错误排查
-
-### 切换时向用户索取的两样东西
-
-切换触发后，**每次对话内临时获取，用完即弃，不保存到本地任何位置**：
-
-1. **Webhook 完整 URL**
-   - 在智能表格右上角菜单 → 「接收外部数据」→ 选择目标工作表 → 开启 → 复制
-   - 格式形如 `https://qyapi.weixin.qq.com/cgi-bin/wedoc/smartsheet/webhook?key=XXXXXX`
-   - 该 URL 相当于该表的写入密钥，用户随时可以在智能表格里关闭「接收外部数据」使其失效
-2. **schema 示例 JSON**
-   - 同一「接收外部数据」页面即可复制
-   - 包含字段 ID → 字段名的映射（`schema`）和各字段的写入格式示例（`add_records`）
-
-示例：
-
-```json
-{
-  "schema": {
-    "fABCD1": "任务名称",
-    "fABCD2": "状态",
-    "fABCD3": "负责人",
-    "fABCD4": "截止日期"
-  },
-  "add_records": [
-    {
-      "values": {
-        "fABCD1": "示例任务",
-        "fABCD2": [{"text": "未开始"}],
-        "fABCD3": [{"user_id": ""}],
-        "fABCD4": "1742400000000"
-      }
-    }
-  ]
-}
-```
-
-### 向用户告知的话术参考
-
-- “通过 `wecom_mcp` 写入接口返回了 `851003 no authority`（通常是企业可见范围 > 10 人的限制）。请把目标表的 Webhook 地址和「接收外部数据」页面的示例 JSON 发我，我帮你通过 Webhook 写入。该信息仅本轮使用，不会保存到本地。”
-
----
-
-## 二、构建请求
-
-### 字段匹配
-
-用户描述通常是自然语言（“标题”“状态”“处理人”），需从用户提供的 `schema` 中找对应字段 ID：
-
-- 模糊匹配：`标题` → 标题 / 名称 / 主题；`状态` → 状态 / 阶段；`处理人` → 负责人 / 责任人
-- 不确定时先问用户确认，避免写错字段
-
-各字段类型的值写法见下方 [字段类型格式规范](#三字段类型格式规范)；真实场景示例见 [webhook-examples.md](webhook-examples.md)。
-
-### 日期处理
-
-用户说“今天”“明天”“3 月 15 日”“2025-03-01 09:00”等自然语言日期时，**在 payload 构造阶段**根据当前日期推算为**毫秒时间戳字符串**（如 `"1742400000000"`）。Webhook 侧**不接受**可读日期字符串。
-
-### 请求结构
-
-Webhook 是标准 HTTP 接口，不经过 `wecom_mcp`，请按执行环境选择合适的工具发送（`curl`、`node` 内置 `fetch`、`python` 的 `requests` / `urllib` 等均可，优先用当前环境最便捷的方式）：
-
-| 项 | 值 |
-|---|---|
-| Method | `POST` |
-| URL | 用户提供的 Webhook 完整 URL（含 `?key=XXX`） |
-| Header | `Content-Type: application/json` |
-| Body | JSON 对象，包含 `add_records` 和/或 `update_records` 字段 |
-
-### Body 结构
-
-- 仅新增：
-
-```json
-{
-  "add_records": [
-    { "values": { "fABCD1": "...", "fABCD2": [{"text": "..."}] } }
-  ]
-}
-```
-
-- 仅更新（需提供 `record_id`，且**只能更新通过 Webhook 写入的记录**，人工创建的记录无法更新）：
-
-```json
-{
-  "update_records": [
-    { "record_id": "REC_xxx", "values": { "fABCD2": [{"text": "已完成"}] } }
-  ]
-}
-```
-
-- 同一请求同时新增和更新：
-
-```json
-{
-  "add_records":    [ { "values": { ... } } ],
-  "update_records": [ { "record_id": "REC_xxx", "values": { ... } } ]
-}
-```
-
-### 成功后
-
-简洁告知结果，例如：
-
-> “已通过 Webhook 写入，record_id: `REC_xxx`”
-
-返回非 0 `errcode` 时参考下方 [常见错误码](#六常见错误码)。
-
----
-
-## 三、字段类型格式规范
-
-### 各类型写法
-
-| 字段类型 | value 示例 | 说明 |
-|---------|-----------|------|
-| 文本 | `"产品登录页白屏"` 或 `[{"type":"text","text":"产品登录页白屏"}]` | 简单字符串更简洁 |
-| 数字 / 货币 | `58000` | double，不要加引号 |
-| 进度 / 百分数 | `30` | 传整数值，`30` = 30%；**不要传小数** `0.3`（那样会显示 0.3%） |
-| 复选框 | `true` / `false` | bool |
-| 日期 | `"1740806400000"` | 毫秒时间戳，字符串形式 |
-| 成员 | `[{"user_id":"lisi"}]` 或 `["张三"]` 或 `[]` | userid 通常就是企业微信登录账号；不指定时传 `[]` |
-| 单选 | `[{"text":"已完成"}]` | 数组，选项文本必须与表格预设完全一致 |
-| 多选 | `[{"text":"前端"},{"text":"后端"}]` | 数组，每个选项一个对象 |
-| 链接 | `[{"text":"需求文档","link":"https://doc.example.com"}]` | 数组 |
-| 地理位置 | `[{"latitude":"31.23040","longitude":"121.47370","source_type":1,"title":"上海市徐汇区"}]` | 数组，最多 1 条 |
-| 图片 | `[{"title":"screenshot.png","image_base64":"iVBORw0KGgo..."}]` | 纯 base64，**不要带 `data:image/...;base64,` 前缀**，否则报 errcode 2023033 |
-| 电话 / 邮箱 / 条码 | `"13800138000"` | 字符串 |
-
----
-
-## 四、不支持的字段
-
-以下字段由系统自动维护或结构特殊，Webhook 写入时**跳过即可，不要报错**：
-
-公式、自动编号、查找引用、关联字段、创建人、最后编辑人、创建时间、最后编辑时间、群聊、文件附件。
-
----
-
-## 五、频率限制
-
-- 单工作表：≤ 3000 条/分钟
-- 单文档：≤ 10000 条/分钟
-
-数据量大时建议分批，每批不超过 500 条。
-
----
-
-## 六、常见错误码
-
-| errcode | 原因 | 解决方法 |
-|---------|------|---------|
-| 2023033 | 图片 base64 携带了 `data:image/...;base64,` 前缀 | 去掉前缀，只传纯 base64 字符串 |
-| 40014 | Webhook key 无效或已过期 | 请用户重新在智能表格「接收外部数据」获取 Webhook 地址 |
-| 45033 | 超出频率限制 | 降低发送速率或分批发送 |
-| -100035 | testapi 域名不稳定（超时） | 改用正式域名 `qyapi.weixin.qq.com` |
-| 2023001 | 字段 ID 不存在 | 核对用户提供的 `schema`，确认字段 ID 拼写正确 |
-| 2023010 | 单选/多选的选项值不在预设列表 | 确认选项文本与表格设置完全一致（区分大小写） |
-| 2023012 | record_id 不存在（更新时） | 只能更新通过 Webhook 写入的记录，人工创建的记录无法更新 |
-
----
-
-## 七、参考文件
-
-- 真实场景示例 → [webhook-examples.md](webhook-examples.md)
-
-按需查阅，不用每次全读。