en un clic
wecom-doc-manager
// 企业微信文档管理技能。提供文档的创建、读取和编辑能力,支持通过 docid 或文档 URL 操作企业微信文档(doc_type=3)和智能表格(doc_type=10)。适用场景:(1) 以 Markdown 格式导出获取文档完整内容(异步轮询) (2) 新建文档或智能表格 (3) 用 Markdown 格式覆写文档内容。当用户需要查看文档内容、创建新文档、编辑文档正文时触发此 Skill。
// 企业微信文档管理技能。提供文档的创建、读取和编辑能力,支持通过 docid 或文档 URL 操作企业微信文档(doc_type=3)和智能表格(doc_type=10)。适用场景:(1) 以 Markdown 格式导出获取文档完整内容(异步轮询) (2) 新建文档或智能表格 (3) 用 Markdown 格式覆写文档内容。当用户需要查看文档内容、创建新文档、编辑文档正文时触发此 Skill。
企业微信文档 MCP 底层操作技能。通过 curl 直接调用 WeCom 文档 MCP JSON-RPC 2.0 接口, 不依赖 wecom_mcp tool。支持文档创建/读取/编辑、智能表格结构管理、记录增删改查、 智能文档(Smartpage)创建/导出、图片文件上传。 适用场景:创建企微文档/智能表格、导出文档内容、管理表格字段和记录、 上传图片/文件到文档、批量写入智能表格数据。 触发词:企微文档、企业微信文档、WeCom doc、智能表格、smartsheet、 文档导出、表格写入、表格字段、create_doc、smartsheet_get_sheet、 smartsheet_add_fields、smartsheet_add_records、upload_doc_image。
WeCom MCP 文档/智能表格调用前置检查。仅当已经决定调用 `wecom_mcp` 的 doc 类能力时使用;不要用于给企业微信用户或群发消息、联系人查询、日程、会议或待办。发消息必须使用 OpenClaw core `message` 工具。
企业微信智能表格数据(记录)管理技能。提供智能表格记录的增删改查能力。适用场景:(1) 查询子表全部记录 (2) 添加一行或多行记录 (3) 更新已有记录 (4) 删除记录。当用户需要读取表格数据、写入新数据、修改或删除表格行时触发此 Skill。支持通过 docid 或文档 URL 定位文档。
企业微信智能表格结构管理技能。提供子表(Sheet)和字段(Field/列)的增删改查能力。适用场景:(1) 查询智能表格的子表列表 (2) 添加、更新、删除子表 (3) 查询子表的字段/列信息 (4) 添加、更新、删除字段/列。当用户需要管理智能表格的表结构、列定义、子表配置时触发此 Skill。支持通过 docid 或文档 URL 定位文档。
| name | wecom-doc-manager |
| description | 企业微信文档管理技能。提供文档的创建、读取和编辑能力,支持通过 docid 或文档 URL 操作企业微信文档(doc_type=3)和智能表格(doc_type=10)。适用场景:(1) 以 Markdown 格式导出获取文档完整内容(异步轮询) (2) 新建文档或智能表格 (3) 用 Markdown 格式覆写文档内容。当用户需要查看文档内容、创建新文档、编辑文档正文时触发此 Skill。 |
wecom_mcp是一个 MCP tool,所有操作通过调用该 tool 完成。
⚠️ 前置条件:仅在当前会话第一次准备调用
wecom_mcp、且尚未确认工具可用时,按wecom-preflight技能执行前置条件检查。若当前回合工具列表里已经有wecom_mcp,或当前会话里刚刚成功调用过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_mcp执行list+category=doc探测当前 bot 实际暴露的 doc 工具列表。只有当列表里确实存在get_doc_content时,才允许继续调用它。- 如果
list doc的结果中不存在get_doc_content,说明当前 bot 的 doc 类 MCP 仅开放了创建/编辑能力,没有开放读取能力。此时必须立即停止,直接告诉用户“当前文档读取能力未开通”;不要再继续尝试get_doc_content、浏览器抓页面、read/find/exec 探路或 HTML fallback。
管理企业微信文档的创建、读取和编辑。所有接口支持通过 docid 或 url 二选一定位文档。
通过 wecom_mcp tool 调用,品类为 doc:
使用 wecom_mcp tool 调用 wecom_mcp call doc <tool_name> '<json_params>' 调用指定技能
所有接口返回 JSON 对象,包含以下公共字段:
| 字段 | 类型 | 说明 |
|---|---|---|
errcode | integer | 返回码,0 表示成功,非 0 表示失败 |
errmsg | string | 错误信息,成功时为 "ok" |
当 errcode 不为 0 时,说明接口调用失败,可重试 1 次;若仍失败,将 errcode 和 errmsg 展示给用户。
仅当 wecom_mcp list doc 的结果中明确包含 get_doc_content 时,才可以使用本接口。
获取文档完整内容数据,只能以 Markdown 格式返回。采用异步轮询机制:首次调用无需传 task_id,接口返回 task_id;若 task_done 为 false,需携带该 task_id 再次调用,直到 task_done 为 true 时返回完整内容。
wecom_mcp tool 调用 wecom_mcp call doc get_doc_content '{"docid": "DOCID", "type": 2}'wecom_mcp tool 调用 wecom_mcp call doc get_doc_content '{"docid": "DOCID", "type": 2, "task_id": "xxx"}'wecom_mcp tool 调用 wecom_mcp call doc get_doc_content '{"url": "https://doc.weixin.qq.com/doc/xxx", "type": 2}'参见 API 详情。
新建文档(doc_type=3)或智能表格(doc_type=10)。创建成功返回 url 和 docid。
wecom_mcp tool 调用 wecom_mcp call doc create_doc '{"doc_type": 3, "doc_name": "项目周报"}'wecom_mcp tool 调用 wecom_mcp call doc create_doc '{"doc_type": 10, "doc_name": "任务跟踪表"}'注意:
docid 仅在创建时返回,需妥善保存。smartsheet_get_sheet 查询其 sheet_id。create_doc 返回的完整 url 字段。docid、短链路径或 /doc/... 重新拼接链接。url 里的查询参数,例如 ?scode=...。create_doc 返回的完整 url,不要做截短、美化或重写。参见 API 详情。
用 Markdown 内容覆写文档正文。content_type 固定为 1(Markdown)。
使用 wecom_mcp tool 调用 wecom_mcp call doc edit_doc_content '{"docid": "DOCID", "content": "# 标题\n\n正文内容", "content_type": 1}'
参见 API 详情。
wecom_mcp 执行 list + category=docget_doc_content 时,才调用 wecom_mcp call doc get_doc_content '{"docid": "DOCID", "type": 2}';若 task_done 为 false 则携带 task_id 继续轮询get_doc_content,直接回复用户当前 bot 未开通文档读取能力;不要改用浏览器、HTML 抓取或其他探路方式伪造结果wecom_mcp tool 调用 wecom_mcp call doc create_doc '{"doc_type": 3, "doc_name": "文档名"}',保存返回的 docid 和完整 urlcreate_doc 的完整 url;禁止自行拼接、截短或去掉查询参数当你刚创建完企业微信文档并准备回复用户时,严格遵守以下规则:
create_doc 的原始返回结果中取 urldocid 转成新的链接?scode=...、from= 等查询参数正确示例:
文档已创建,完整链接如下:
https://doc.weixin.qq.com/doc/xxx?scode=abc
错误示例:
https://doc.weixin.qq.com/doc/xxx