@wecom/wecom-openclaw-plugin 2026.5.14-beta.0 → 2026.5.25-beta.1

package/package.json

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

package/skills/wecom-doc/SKILL.md

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

package/skills/wecom-smartsheet/SKILL.md

@@ -72,6 +72,10 @@ description: 企业微信智能表格管理技能。提供智能表格的结构
 
 在添加字段前，请先参阅所有字段类型和定义 [字段类型参考](references/smartsheet-field-types.md)。
 
+> 注意：调用本接口前，你必须确认已完成以下操作，否则会多出一个无用的默认列：
+> 1. 已调用 smartsheet_get_fields 查看子表现有字段（新子表会自带一个默认文本字段）
+> 2. 已调用 smartsheet_update_fields 将该默认字段重命名为你需要的第一个字段名 然后在本接口中只传入剩余的字段（不包含第一个字段）。
+
 ### smartsheet_update_fields
 
 更新字段标题。**只能改名，不能改类型**（field_type 必须传原始类型）。field_title 不能更新为原值。
@@ -112,7 +116,7 @@ description: 企业微信智能表格管理技能。提供智能表格的结构
 > 图片字段示例：`"封面": [{"image_path": "/path/to/img.png", "title": "图片标题"}]`
 > 文件字段示例：`"文件": [{"file_path": "/path/to/file.pdf"}]`
 
-> ⚠️ 若返回 `errcode: 851003` 或 `errmsg` 包含 `no authority`（通常是企业可见范围 > 10 人的规模限制），切换到 Webhook 兜底方案，详见 [webhook-fallback.md](references/webhook-fallback.md)。
+> ⚠️ 若返回 `errcode: 851003` 或 `errmsg` 包含 `no authority`，无文档权限。在编辑场景，通常是因为机器人不允许编辑由企业成员创建的文档。在**智能表格写入场景**下，若该报错发生在 `smartsheet_add_records` / `smartsheet_update_records`，可引导用户走 Webhook 兜底方案，详见 [webhook-fallback.md](references/webhook-fallback.md)。注意 Webhook 只能更新通过 Webhook 写入的记录，人工创建的记录无法更新。
 
 ### smartsheet_update_records
 
@@ -132,7 +136,7 @@ description: 企业微信智能表格管理技能。提供智能表格的结构
 > 图片字段示例：`"封面": [{"image_path": "/path/to/img.png", "title": "图片标题"}]`
 > 文件字段示例：`"文件": [{"file_path": "/path/to/file.pdf"}]`
 
-> ⚠️ 若返回 `errcode: 851003` 或 `errmsg` 包含 `no authority`（通常是企业可见范围 > 10 人的规模限制），切换到 Webhook 兜底方案，详见 [webhook-fallback.md](references/webhook-fallback.md)。注意 Webhook 只能更新通过 Webhook 写入的记录，人工创建的记录无法更新。
+> ⚠️ 若返回 `errcode: 851003` 或 `errmsg` 包含 `no authority`，无文档权限。在编辑场景，通常是因为机器人不允许编辑由企业成员创建的文档。在**智能表格写入场景**下，若该报错发生在 `smartsheet_add_records` / `smartsheet_update_records`，可引导用户走 Webhook 兜底方案，详见 [webhook-fallback.md](references/webhook-fallback.md)。注意 Webhook 只能更新通过 Webhook 写入的记录，人工创建的记录无法更新。
 
 ### smartsheet_delete_records
 
@@ -156,7 +160,7 @@ description: 企业微信智能表格管理技能。提供智能表格的结构
 1. **读取数据** → 使用 `wecom_mcp` tool 调用 `wecom_mcp call doc smartsheet_get_records '{"docid":"DOCID","sheet_id":"SHEETID"}'`
 2. **写入数据** → 先 `smartsheet_get_fields` 了解列类型 → 若涉及成员（USER）字段，先通过 `wecom-contact` 的 `get_userlist` 查找人员 userid → `smartsheet_add_records` 写入
 3. **更新数据** → 先 `smartsheet_get_records` 获取 record_id → 若涉及成员（USER）字段，先通过 `wecom-contact` 的 `get_userlist` 查找人员 userid → `smartsheet_update_records` 更新
-4. **写入失败 fallback** → 第 2/3 步返回 `errcode: 851003` / `no authority`（通常是企业可见范围 > 10 人的规模限制）时 → 请用户临时提供目标表的 Webhook 地址 + schema 示例 JSON（不保存到本地）→ 按 [webhook-fallback.md](references/webhook-fallback.md) 构造请求体发送
+4. **写入失败 fallback** → 第 2/3 步返回 `errcode: 851003` / `no authority`，无文档权限。在编辑场景，通常是因为机器人不允许编辑由企业成员创建的文档。在**智能表格写入场景**下，若该报错发生在 `smartsheet_add_records` / `smartsheet_update_records`，可引导用户走 Webhook 兜底方案，详见 [webhook-fallback.md](references/webhook-fallback.md)。注意 Webhook 只能更新通过 Webhook 写入的记录，人工创建的记录无法更新
 5. 若涉及**图片（IMAGE）或文件（ATTACHMENT）**字段，**必须且只能**直接在 cell value 中传入本地路径（`image_path` / `file_path`）。**严禁**调用 `upload_doc_image`、`upload_doc_file` 或任何上传接口，**严禁**进行 base64 编码——无论文件大小、无论 API 返回何种错误，均不得绕过此规则。若返回错误，直接将错误码和错误信息告知用户，不得尝试其他上传方式。传入格式参考 [单元格值格式参考](references/smartsheet-cell-value-formats.md)。
 6. **删除数据** → 先 `smartsheet_get_records` 确认 record_id → `smartsheet_delete_records` 删除
 

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

@@ -13,9 +13,8 @@
 
 先走 `wecom_mcp` tool 正常链路（`smartsheet_add_records` / `smartsheet_update_records`）。仅在出现以下情况时才切换到 Webhook：
 
-- **优先判据**：返回 `errcode: 851003`，或 `errmsg` 包含 `no authority` —— 这通常意味着企业可见范围 > 10 人，写入接口被限制
-- 或 `errmsg` / 提示信息明显指向**企业规模 / 可见范围超限**（例如“超出可见范围”、“成员数超限”等相关描述）
-- 其他错误（参数错误、字段 ID 错误、文档不存在等）**不应**切换到 Webhook，应按原错误排查
+- **优先判据**：返回 `errcode: 851003`，或 `errmsg` 包含 `no authority` —— 无文档权限。在编辑场景，通常是因为机器人不允许编辑由企业成员创建的文档
+- 或 `errmsg` / 提示信息明显指向**无文档权限**（例如"超出可见范围"、"成员数超限"等相关描述）- 其他错误（参数错误、字段 ID 错误、文档不存在等）**不应**切换到 Webhook，应按原错误排查
 
 ### 切换时向用户索取的两样东西
 
@@ -54,7 +53,7 @@
 
 ### 向用户告知的话术参考
 
-- “通过 `wecom_mcp` 写入接口返回了 `851003 no authority`（通常是企业可见范围 > 10 人的限制）。请把目标表的 Webhook 地址和「接收外部数据」页面的示例 JSON 发我，我帮你通过 Webhook 写入。该信息仅本轮使用，不会保存到本地。”
+- “通过 `wecom_mcp` 写入接口返回了 `851003 no authority`，无文档权限（在编辑场景，通常是因为机器人不允许编辑由企业成员创建的文档）。请把目标表的 Webhook 地址和「接收外部数据」页面的示例 JSON 发我，我帮你通过 Webhook 写入。该信息仅本轮使用，不会保存到本地。”
 
 ---